Polymarket
Access prediction markets data from Polymarket
Configuration
Get Markets
Operation
Get Markets
Status
Select...
Sort By
Select...
Sort Order
Select...
Tag ID
Filter by tag ID
Limit
Number of results (max 50)
Offset
Pagination offset
Get Markets (
polymarket_get_markets)Retrieve a list of prediction markets from Polymarket with optional filtering
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
closed | string | No | Filter by closed status (true/false). Use false for active markets only. |
order | string | No | Sort field (e.g., volumeNum, liquidityNum, startDate, endDate, createdAt) |
ascending | string | No | Sort direction (true for ascending, false for descending) |
tagId | string | No | Filter by tag ID |
limit | string | No | Number of results per page (max 50) |
offset | string | No | Pagination offset (skip this many results) |
Output
| Parameter | Type | Description |
|---|---|---|
markets | array | Array of market objects |
Get Market
Operation
Get Market
Market ID
Market ID (required if no slug)
Market Slug
Market slug (required if no ID)
Get Market (
polymarket_get_market)Retrieve details of a specific prediction market by ID or slug
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
marketId | string | No | The market ID. Required if slug is not provided. |
slug | string | No | The market slug (e.g., "will-trump-win"). Required if marketId is not provided. |
Output
| Parameter | Type | Description |
|---|---|---|
market | object | Market object with details |
Get Events
Operation
Get Events
Status
Select...
Sort By
Select...
Sort Order
Select...
Tag ID
Filter by tag ID
Limit
Number of results (max 50)
Offset
Pagination offset
Get Events (
polymarket_get_events)Retrieve a list of events from Polymarket with optional filtering
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
closed | string | No | Filter by closed status (true/false). Use false for active events only. |
order | string | No | Sort field (e.g., volume, liquidity, startDate, endDate, createdAt) |
ascending | string | No | Sort direction (true for ascending, false for descending) |
tagId | string | No | Filter by tag ID |
limit | string | No | Number of results per page (max 50) |
offset | string | No | Pagination offset (skip this many results) |
Output
| Parameter | Type | Description |
|---|---|---|
events | array | Array of event objects |
Get Event
Operation
Get Event
Event ID
Event ID (required if no slug)
Event Slug
Event slug (required if no ID)
Get Event (
polymarket_get_event)Retrieve details of a specific event by ID or slug
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
eventId | string | No | The event ID. Required if slug is not provided. |
slug | string | No | The event slug (e.g., "2024-presidential-election"). Required if eventId is not provided. |
Output
| Parameter | Type | Description |
|---|---|---|
event | object | Event object with details |
Get Tags
Operation
Get Tags
Limit
Number of results (max 50)
Offset
Pagination offset
Get Tags (
polymarket_get_tags)Retrieve available tags for filtering markets from Polymarket
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | string | No | Number of results per page (max 50) |
offset | string | No | Pagination offset (skip this many results) |
Output
| Parameter | Type | Description |
|---|---|---|
tags | array | Array of tag objects with id, label, and slug |
Search
Operation
Search
Search Query*
Search term
Limit
Number of results (max 50)
Offset
Pagination offset
Search (
polymarket_search)Search for markets, events, and profiles on Polymarket
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query term |
limit | string | No | Number of results per page (max 50) |
offset | string | No | Pagination offset |
Output
| Parameter | Type | Description |
|---|---|---|
results | object | Search results containing markets, events, and profiles arrays |
Get Series
Operation
Get Series
Limit
Number of results (max 50)
Offset
Pagination offset
Get Series (
polymarket_get_series)Retrieve series (related market groups) from Polymarket
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | string | No | Number of results per page (max 50) |
offset | string | No | Pagination offset (skip this many results) |
Output
| Parameter | Type | Description |
|---|---|---|
series | array | Array of series objects |
Get Series by ID
Operation
Get Series by ID
Series ID*
Series ID
Get Series by ID (
polymarket_get_series_by_id)Retrieve a specific series (related market group) by ID from Polymarket
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
seriesId | string | Yes | The series ID |
Output
| Parameter | Type | Description |
|---|---|---|
series | object | Series object with details |
Get Orderbook
Operation
Get Orderbook
Token ID*
CLOB Token ID from market
Get Orderbook (
polymarket_get_orderbook)Retrieve the order book summary for a specific token
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | The CLOB token ID (from market clobTokenIds) |
Output
| Parameter | Type | Description |
|---|---|---|
orderbook | object | Order book with bids and asks arrays |
Get Price
Operation
Get Price
Token ID*
CLOB Token ID from market
Side*
Select...
Get Price (
polymarket_get_price)Retrieve the market price for a specific token and side
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | The CLOB token ID (from market clobTokenIds) |
side | string | Yes | Order side: buy or sell |
Output
| Parameter | Type | Description |
|---|---|---|
price | string | Market price |
Get Midpoint
Operation
Get Midpoint
Token ID*
CLOB Token ID from market
Get Midpoint (
polymarket_get_midpoint)Retrieve the midpoint price for a specific token
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | The CLOB token ID (from market clobTokenIds) |
Output
| Parameter | Type | Description |
|---|---|---|
midpoint | string | Midpoint price |
Get Price History
Operation
Get Price History
Token ID*
CLOB Token ID from market
Interval
Select...
Fidelity (minutes)
Data resolution in minutes (e.g., 60)
Start Timestamp
Unix timestamp UTC (if no interval)
End Timestamp
Unix timestamp UTC (if no interval)
Get Price History (
polymarket_get_price_history)Retrieve historical price data for a specific market token
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | The CLOB token ID (from market clobTokenIds) |
interval | string | No | Duration ending at current time (1m, 1h, 6h, 1d, 1w, max). Mutually exclusive with startTs/endTs. |
fidelity | number | No | Data resolution in minutes (e.g., 60 for hourly) |
startTs | number | No | Start timestamp (Unix seconds UTC) |
endTs | number | No | End timestamp (Unix seconds UTC) |
Output
| Parameter | Type | Description |
|---|---|---|
history | array | Array of price history entries with timestamp (t) and price (p) |
Get Last Trade Price
Operation
Get Last Trade Price
Token ID*
CLOB Token ID from market
Get Last Trade Price (
polymarket_get_last_trade_price)Retrieve the last trade price for a specific token
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | The CLOB token ID (from market clobTokenIds) |
Output
| Parameter | Type | Description |
|---|---|---|
price | string | Last trade price |
Get Spread
Operation
Get Spread
Token ID*
CLOB Token ID from market
Get Spread (
polymarket_get_spread)Retrieve the bid-ask spread for a specific token
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | The CLOB token ID (from market clobTokenIds) |
Output
| Parameter | Type | Description |
|---|---|---|
spread | object | Bid-ask spread with bid and ask prices |
Get Tick Size
Operation
Get Tick Size
Token ID*
CLOB Token ID from market
Get Tick Size (
polymarket_get_tick_size)Retrieve the minimum tick size for a specific token
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
tokenId | string | Yes | The CLOB token ID (from market clobTokenIds) |
Output
| Parameter | Type | Description |
|---|---|---|
tickSize | string | Minimum tick size |
Get Positions
Operation
Get Positions
User Wallet Address*
Wallet address
Market ID
Market ID (optional filter)
Get Positions (
polymarket_get_positions)Retrieve user positions from Polymarket
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
user | string | Yes | User wallet address |
market | string | No | Optional market ID to filter positions |
Output
| Parameter | Type | Description |
|---|---|---|
positions | array | Array of position objects |
Get Trades
Operation
Get Trades
User Wallet Address
Wallet address (optional filter)
Market ID
Market ID (optional filter)
Limit
Number of results (max 50)
Offset
Pagination offset
Get Trades (
polymarket_get_trades)Retrieve trade history from Polymarket
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
user | string | No | User wallet address to filter trades |
market | string | No | Market ID to filter trades |
limit | string | No | Number of results per page (max 50) |
offset | string | No | Pagination offset (skip this many results) |
Output
| Parameter | Type | Description |
|---|---|---|
trades | array | Array of trade objects |
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.
Notes
- Category:
tools - Type:
polymarket