List Polymarket markets
polymarket_markets_listList Polymarket markets by volume, liquidity, tag, or IDs with prices and rules; filter by status, volume, or liquidity and paginate with a cursor.
Instructions
List Polymarket markets by volume, liquidity, tag or ids, with prices and rules. Optional inputs: status, tagId, sort, ascending, minVolume and 9 more. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "polymarket_markets_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort field. Default: `volume`. | |
| limit | No | Items per page, 1–100. Default: 50. | |
| tagId | No | Only markets with this tag id. Find ids with the tags list. | |
| cursor | No | Pass `page.nextCursor` from the previous response to get the next page. Keep the other filters the same. | |
| locale | No | Translate titles and market questions into this language. Descriptions stay in English. | |
| status | No | Which markets to list: `open` (default) or `closed`. When you filter by `conditionIds` or `tokenIds` and omit this, open and closed markets are both searched. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| tokenIds | No | Only the markets these outcome tokens belong to, up to 30. Repeat the parameter or separate ids with commas. For more ids use the batch endpoint. | |
| ascending | No | Sort from smallest to largest. Default: false (largest first). | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| maxVolume | No | Only markets with at most this much volume (US dollars). | |
| minVolume | No | Only markets with at least this much volume (US dollars). | |
| conditionIds | No | Only these markets, by condition id, up to 50. Repeat the parameter or separate ids with commas. For more ids use the batch endpoint. | |
| maxLiquidity | No | Only markets with at most this much liquidity. | |
| minLiquidity | No | Only markets with at least this much liquidity. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. | |
| sportsMarketType | No | Only sports markets of this kind, such as `moneyline`. |