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