Polymarket Markets API reference
Your first 10 calls are free, no card needed. Pricing and FAQ
Get a free API keycurl "https://api.insightsocial.app/v1/polymarket/markets" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
List Polymarket markets by volume, liquidity, tag or ids, with prices and rules.
Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Beta endpoints.
20 credits per call.
Paginates by cursor: see Pagination.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
Which markets to list: open (default) or closed. When you filter by condition_ids or token_ids and omit this, open and closed markets are both searched.
Value in
- "open"
- "closed"
Only markets with this tag id. Find ids with the tags list.
Sort field. Default: volume.
Value in
- "volume"
- "volume24h"
- "liquidity"
- "startDate"
- "endDate"
- "createdAt"
- "closedTime"
Sort from smallest to largest. Default: false (largest first).
Only markets with at least this much volume (US dollars).
0 <= value <= 1000000000000000Only markets with at most this much volume (US dollars).
0 <= value <= 1000000000000000Only markets with at least this much liquidity.
0 <= value <= 1000000000000000Only markets with at most this much liquidity.
0 <= value <= 1000000000000000Only these markets, by condition id, up to 50. Separate ids with commas. For more ids use the batch endpoint.
Only the markets these outcome tokens belong to, up to 30. Separate ids with commas. For more ids use the batch endpoint.
Only sports markets of this kind, such as moneyline.
Translate titles and market questions into this language. Descriptions stay in English.
Value in
- "es"
- "fr"
- "de"
- "ja"
- "zh"
- "ko"
- "ru"
- "hi"
- "th"
- "tr"
- "vi"
- "pt"
- "it"
- "pl"
- "id"
- "bn"
- "uk"
- "zh-hant"
- "tl"
Items per page, 1–100. Default: 50.
1 <= value <= 100Pass pagination.next_cursor from the previous response to get the next page. Keep the other parameters the same.
Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.
Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.insightsocial.app/v1/polymarket/markets"{ "success": true, "platform": "string", "endpoint": "string", "schema_version": "2", "pagination": { "next_cursor": "string", "has_more": true, "page_size": 0, "stopped_at": "since" }, "unavailable": [ "string" ], "credits_used": 0, "credits_remaining": 0, "request_id": "string", "cached": true, "idempotent_replay": true, "charge_reason": "string", "free_call": true, "data": { "property1": null, "property2": null }}