Skip to main content
GET
/
polymarket
/
events
Get Events
curl --request GET \
  --url https://api.domeapi.io/v1/polymarket/events
{ "events": [ { "event_slug": "presidential-election-winner-2024", "title": "Presidential Election Winner 2024", "subtitle": "Who will win the 2024 US Presidential Election?", "status": "closed", "start_time": 1704067200, "end_time": 1730851200, "volume_fiat_amount": 3686335059.29, "settlement_sources": "Associated Press", "rules_url": null, "image": "https://polymarket.com/images/election-2024.png", "tags": [ "politics", "elections" ], "market_count": 17, "markets": [ { "market_slug": "will-trump-win-2024", "title": "Will Trump win the 2024 election?", "condition_id": "0x1234...", "status": "closed", "volume_total": 1500000000 } ] } ], "pagination": { "limit": 10, "has_more": true, "pagination_key": "eyJsYXN0Vm9sdW1lIjoxNzEyMTMyNjYzLjk2MTYwNjMsImxhc3RFdmVudFNsdWciOiJuYmEtY2hhbXBpb24tMjAyNC0yMDI1In0=" } }

Query Parameters

​
event_slug
string

Filter by specific event slug. When provided, returns a single hydrated event matching that slug (e.g., 'presidential-election-winner-2024'). Use with include_markets=true to get the full event with all its markets.

Example:

"presidential-election-winner-2024"

​
tags
string[]

Filter events by tag(s)/category. Can provide multiple values (e.g., sports, crypto, politics).

Example:
["sports", "football"]
​
status
enum<string>

Filter events by status. An event is 'open' if any of its markets are still open, 'closed' if all markets are closed.

Available options:
open,
closed
Example:

"open"

​
include_markets
enum<string>
default:false

Set to 'true' to include the list of markets for each event in the response.

Available options:
true,
false
Example:

"true"

​
start_time
integer

Filter events starting after this Unix timestamp (seconds)

Example:

1640995200

​
end_time
integer

Filter events starting before this Unix timestamp (seconds)

Example:

1672531200

​
game_start_time
integer

Filter events by game start time (Unix timestamp in seconds). Useful for filtering sports events by when the game starts.

Example:

1704067200

​
limit
integer
default:10

Number of events to return (1-100). Default: 10.

Required range: 1 <= x <= 100
Example:

10

​
pagination_key
string

Pagination key for cursor-based pagination. Use the value from the previous response's pagination.pagination_key field to get the next page of results. Do not use the deprecated 'offset' parameter.

Example:

"eyJsYXN0Vm9sdW1lIjoxNzEyMTMyNjYzLjk2MTYwNjMsImxhc3RFdmVudFNsdWciOiJuYmEtY2hhbXBpb24tMjAyNC0yMDI1In0="

Response

Events response with pagination

​
events
object[]
​
pagination
object