Skip to main content
GET
Get Events

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:
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