Skip to main content

Polymarket

Type: polymarket • Category: flow • Tags: polymarket, prediction-markets, trading, crypto, blockchain

Description

Connect to Polymarket prediction markets for trading and market data

Parameters

NameTypeDescriptionRequiredDefault
private_keystringYour private key for signing orders (required for trading)no
funder_addressstringAddress that funds the trades (proxy wallet)no
signature_typenumberSignature type: 0=EOA, 1=POLY_PROXY, 2=POLY_GNOSIS_SAFEno1
operationstringPolymarket API operation to performno
token_idstringMarket token ID for trading operationsno
market_slugstringMarket slug identifierno
event_slugstringEvent slug identifierno
market_idstringMarket ID for spreadsno
tag_idstringTag ID for filtering markets/eventsno
querystringSearch queryno
sidestringOrder sideno
pricenumberOrder price (0.01 = 1 cent)no
sizenumberOrder size (number of outcome tokens)no
order_typestringOrder type: GTC=Good Till Cancel, FOK=Fill or Kill, GTD=Good Till Dateno"GTC"
order_idstringOrder ID to cancelno
limitnumberNumber of results to returnno100
offsetnumberPagination offsetno0
closedbooleanInclude closed markets/eventsnofalse

Help

Polymarket Prediction Markets Connector

Connect to Polymarket for prediction market trading, market data, and portfolio management.

Security Note: Your credentials are used only for this workflow execution and are not stored.

Authentication:

  • Uses cryptographic signatures with your private key
  • Supports multiple signature types (EOA, Proxy, Gnosis Safe)
  • Funder address required for trading operations

Available Operations:

Market Data (Public):

  • get_markets: Get markets with optional tag filtering
  • get_events: Get events with optional tag filtering
  • get_market: Get specific market by slug
  • get_event: Get specific event by slug
  • get_order_book: Get order book for a market
  • get_midpoint: Get midpoint price
  • get_price: Get current price
  • get_trades: Get recent trades
  • get_spreads: Get bid-ask spreads
  • get_tags: Get available market tags
  • get_sports: Get sports metadata
  • search: Search markets by query

Trading Operations (Require Auth):

  • place_order: Place buy/sell orders (GTC, FOK, GTD)
  • cancel_order: Cancel existing orders
  • get_orders: Get user order history
  • get_positions: Get user positions
  • get_balance: Get user balance

Examples:

  • Get active markets: operation="get_markets", closed=false, limit=50
  • Get market by slug: operation="get_market", market_slug="will-bitcoin-hit-100k"
  • Get order book: operation="get_order_book", token_id="1234567890"
  • Place limit order: operation="place_order", token_id="1234567890", side="buy", price=0.50, size=10.0
  • Get sports markets: operation="get_events", tag_id=100381

Required Parameters:

  • operation: Operation to perform

For Trading Operations:

  • private_key: Your private key for signing
  • funder_address: Address funding the trades
  • signature_type: 0=EOA, 1=POLY_PROXY, 2=POLY_GNOSIS_SAFE

Notes:

  • Prices are in USDC (0.01 = 1 cent, 1.00 = $1)
  • Token IDs identify specific market outcomes
  • Market slugs are URL-friendly identifiers
  • Tag IDs filter markets by category
  • All trading requires proper allowances and balances
  • Orders use EIP712 signatures for security