Sim

Polymarket

Access prediction markets data from Polymarket

Polymarket is a decentralized prediction markets platform where users can trade on the outcome of future events using blockchain technology. Polymarket provides a comprehensive API, enabling developers and agents to access live market data, event listings, price information, and orderbook statistics to power data-driven workflows and AI automations.

With Polymarket’s API and Sim integration, you can enable agents to programmatically retrieve prediction market information, explore open markets and associated events, analyze historical price data, and access orderbooks and market midpoints. This creates new possibilities for research, automated analysis, and developing intelligent agents that react to real-time event probabilities derived from market prices.

Key features of the Polymarket integration include:

  • Market Listing & Filtering: List all current or historical prediction markets, filter by tag, sort, and paginate through results.
  • Market Detail: Retrieve details for a single market by market ID or slug, including its outcomes and status.
  • Event Listings: Access lists of Polymarket events and detailed event information.
  • Orderbook & Price Data: Analyze the orderbook, get the latest market prices, view the midpoint, or obtain historical price information for any market.
  • Automation Ready: Build agents or tools that react programmatically to market developments, changing odds, or specific event outcomes.

By using these documented API endpoints, you can seamlessly integrate Polymarket’s rich on-chain prediction market data into your own AI workflows, dashboards, research tools, and trading automations.

Usage Instructions

Integrate Polymarket prediction markets into the workflow. Can get markets, market, events, event, tags, series, orderbook, price, midpoint, price history, last trade price, spread, tick size, positions, trades, and search.

Tools

polymarket_get_markets

Retrieve a list of prediction markets from Polymarket with optional filtering

Input

ParameterTypeRequiredDescription
closedstringNoFilter by closed status (true/false). Use false for active markets only.
orderstringNoSort field (e.g., volumeNum, liquidityNum, startDate, endDate, createdAt)
ascendingstringNoSort direction (true for ascending, false for descending)
tagIdstringNoFilter by tag ID
limitstringNoNumber of results per page (max 50)
offsetstringNoPagination offset (skip this many results)

Output

ParameterTypeDescription
marketsarrayArray of market objects

polymarket_get_market

Retrieve details of a specific prediction market by ID or slug

Input

ParameterTypeRequiredDescription
marketIdstringNoThe market ID. Required if slug is not provided.
slugstringNoThe market slug (e.g., "will-trump-win"). Required if marketId is not provided.

Output

ParameterTypeDescription
marketobjectMarket object with details

polymarket_get_events

Retrieve a list of events from Polymarket with optional filtering

Input

ParameterTypeRequiredDescription
closedstringNoFilter by closed status (true/false). Use false for active events only.
orderstringNoSort field (e.g., volume, liquidity, startDate, endDate, createdAt)
ascendingstringNoSort direction (true for ascending, false for descending)
tagIdstringNoFilter by tag ID
limitstringNoNumber of results per page (max 50)
offsetstringNoPagination offset (skip this many results)

Output

ParameterTypeDescription
eventsarrayArray of event objects

polymarket_get_event

Retrieve details of a specific event by ID or slug

Input

ParameterTypeRequiredDescription
eventIdstringNoThe event ID. Required if slug is not provided.
slugstringNoThe event slug (e.g., "2024-presidential-election"). Required if eventId is not provided.

Output

ParameterTypeDescription
eventobjectEvent object with details

polymarket_get_tags

Retrieve available tags for filtering markets from Polymarket

Input

ParameterTypeRequiredDescription
limitstringNoNumber of results per page (max 50)
offsetstringNoPagination offset (skip this many results)

Output

ParameterTypeDescription
tagsarrayArray of tag objects with id, label, and slug

Search for markets, events, and profiles on Polymarket

Input

ParameterTypeRequiredDescription
querystringYesSearch query term
limitstringNoNumber of results per page (max 50)
offsetstringNoPagination offset

Output

ParameterTypeDescription
resultsobjectSearch results containing markets, events, and profiles arrays

polymarket_get_series

Retrieve series (related market groups) from Polymarket

Input

ParameterTypeRequiredDescription
limitstringNoNumber of results per page (max 50)
offsetstringNoPagination offset (skip this many results)

Output

ParameterTypeDescription
seriesarrayArray of series objects

polymarket_get_series_by_id

Retrieve a specific series (related market group) by ID from Polymarket

Input

ParameterTypeRequiredDescription
seriesIdstringYesThe series ID

Output

ParameterTypeDescription
seriesobjectSeries object with details

polymarket_get_orderbook

Retrieve the order book summary for a specific token

Input

ParameterTypeRequiredDescription
tokenIdstringYesThe CLOB token ID (from market clobTokenIds)

Output

ParameterTypeDescription
orderbookobjectOrder book with bids and asks arrays

polymarket_get_price

Retrieve the market price for a specific token and side

Input

ParameterTypeRequiredDescription
tokenIdstringYesThe CLOB token ID (from market clobTokenIds)
sidestringYesOrder side: buy or sell

Output

ParameterTypeDescription
pricestringMarket price

polymarket_get_midpoint

Retrieve the midpoint price for a specific token

Input

ParameterTypeRequiredDescription
tokenIdstringYesThe CLOB token ID (from market clobTokenIds)

Output

ParameterTypeDescription
midpointstringMidpoint price

polymarket_get_price_history

Retrieve historical price data for a specific market token

Input

ParameterTypeRequiredDescription
tokenIdstringYesThe CLOB token ID (from market clobTokenIds)
intervalstringNoDuration ending at current time (1m, 1h, 6h, 1d, 1w, max). Mutually exclusive with startTs/endTs.
fidelitynumberNoData resolution in minutes (e.g., 60 for hourly)
startTsnumberNoStart timestamp (Unix seconds UTC)
endTsnumberNoEnd timestamp (Unix seconds UTC)

Output

ParameterTypeDescription
historyarrayArray of price history entries with timestamp (t) and price (p)

polymarket_get_last_trade_price

Retrieve the last trade price for a specific token

Input

ParameterTypeRequiredDescription
tokenIdstringYesThe CLOB token ID (from market clobTokenIds)

Output

ParameterTypeDescription
pricestringLast trade price

polymarket_get_spread

Retrieve the bid-ask spread for a specific token

Input

ParameterTypeRequiredDescription
tokenIdstringYesThe CLOB token ID (from market clobTokenIds)

Output

ParameterTypeDescription
spreadobjectBid-ask spread with bid and ask prices

polymarket_get_tick_size

Retrieve the minimum tick size for a specific token

Input

ParameterTypeRequiredDescription
tokenIdstringYesThe CLOB token ID (from market clobTokenIds)

Output

ParameterTypeDescription
tickSizestringMinimum tick size

polymarket_get_positions

Retrieve user positions from Polymarket

Input

ParameterTypeRequiredDescription
userstringYesUser wallet address
marketstringNoOptional market ID to filter positions

Output

ParameterTypeDescription
positionsarrayArray of position objects

polymarket_get_trades

Retrieve trade history from Polymarket

Input

ParameterTypeRequiredDescription
userstringNoUser wallet address to filter trades
marketstringNoMarket ID to filter trades
limitstringNoNumber of results per page (max 50)
offsetstringNoPagination offset (skip this many results)

Output

ParameterTypeDescription
tradesarrayArray of trade objects

Notes

  • Category: tools
  • Type: polymarket
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started