List markets with optional filtering and pagination.
Timestamp filters are mutually exclusive. Only ONE set of timestamp filters can be used per request:
min_created_ts,max_created_ts– filter by creation time;min_close_ts,max_close_ts– filter by close time;min_settled_ts,max_settled_ts– filter by settlement time. Using multiple timestamp filter sets (e.g., both created and closed) will result in 400 Bad Request
Headers
-
Broker access key identifier.
Format should match the following pattern:
^[A-Za-z0-9._~-]{1,64}$. -
Keyed BLAKE2b-256 signature (hex lowercase, 64 characters).
Format should match the following pattern:
^[0-9a-f]{64}$. -
RFC3339 timestamp with milliseconds (e.g., 2025-10-30T06:00:34.075Z). Must be within clock_skew_tolerance (default 5m) of server time.
Query parameters
-
Minimum value is
1, maximum value is100. Default value is50. -
Opaque pagination cursor
-
Minimum creation timestamp (Unix milliseconds).
-
Maximum creation timestamp (Unix milliseconds).
-
Minimum close timestamp (Unix milliseconds).
-
Maximum close timestamp (Unix milliseconds).
-
Minimum settlement timestamp (Unix milliseconds).
-
Maximum settlement timestamp (Unix milliseconds).
-
Values are
unopened,pre-open,active,suspended,closed, orsettled. -
Comma-separated list of market IDs
-
Language codes to filter localized content (repeatable). If omitted, all available locales are returned.
Values are
en,pt, orid.
curl \
--request GET 'https://api.example.com/v1/markets' \
--header "PRE-ACCESS-KEY: string" \
--header "PRE-ACCESS-SIGNATURE: string" \
--header "PRE-ACCESS-TIMESTAMP: 2026-05-04T09:42:00Z"
{
"markets": [
{
"market_id": "string",
"event_id": "string",
"market_index": 42,
"title": {
"en": "string",
"pt": "string",
"id": "string"
},
"yes_sub_title": {
"en": "string",
"pt": "string",
"id": "string"
},
"no_sub_title": {
"en": "string",
"pt": "string",
"id": "string"
},
"lower_inclusive": true,
"upper_inclusive": true,
"status": "unopened",
"status_revision": 42,
"result": "yes",
"created_at": "2026-05-04T09:42:00Z",
"opens_at": "2026-05-04T09:42:00Z",
"closes_at": "2026-05-04T09:42:00Z",
"expected_expiration_time": "2026-05-04T09:42:00Z",
"settlement_timer_seconds": 42,
"can_close_early": true,
"early_close_condition": "string",
"strike_type": "greater",
"floor_strike": {
"units": 42,
"nanos": 42
},
"cap_strike": {
"units": 42,
"nanos": 42
},
"custom_strike": "string",
"expiration_value": "string",
"settlement_price": {
"units": 42,
"nanos": 42
}
}
],
"cursor": "string"
}
{
"error_code": "string",
"message": "string",
"details": {}
}
{
"error_code": "string",
"message": "string",
"details": {}
}
{
"error_code": "string",
"message": "string",
"details": {}
}