Tools

Polymarket

Access prediction markets data from Polymarket

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

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

`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

`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

`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

`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

`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

`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

`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

`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

`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

`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

`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)

`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

`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

`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

`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

`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

Notes

Category: tools
Type: polymarket

Polymarket