Polymarket Events 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/events" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
List Polymarket events by volume, date, tag or title, with each event's markets.
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 items to list: open (default), closed (ended or resolved) or all. open is Polymarket's own flag and can outlast the end date.
Value in
- "open"
- "closed"
- "all"
Only events with this tag: a tag id or slug.
Words to find in event titles. Titles are English, so search in English.
Sort field. Default: volume.
Value in
- "volume"
- "volume24h"
- "liquidity"
- "startDate"
- "endDate"
- "createdAt"
- "closedTime"
Sort from smallest to largest. Default: false (largest first).
Only events Polymarket features (true) or only those it does not (false).
Only events in this series.
Only events with at least this much volume (US dollars).
0 <= value <= 1000000000000000Only events with at most this much volume (US dollars).
0 <= value <= 1000000000000000Only events with at least this much liquidity.
0 <= value <= 1000000000000000Only events starting on or after this date.
Only events starting on or before this date.
Only events ending on or after this date.
Only events ending on or before this date.
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"
Events per page, 1–25. Default: 20. Each event carries all of its markets and the busiest hold hundreds, so a page stays small. Use cursor for the next page.
1 <= value <= 25Pass 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/events"{ "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 }}