# List markets

**GET /markets**

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



## Servers
- Production: https://api.example.com/v1 (Production)
- Sandbox: https://sandbox.api.example.com/v1 (Sandbox)


## Authentication methods
- Api key auth


## Parameters
### Headers

- **PRE-ACCESS-KEY** (string)
  Broker access key identifier.

- **PRE-ACCESS-SIGNATURE** (string)
  Keyed BLAKE2b-256 signature (hex lowercase, 64 characters).

- **PRE-ACCESS-TIMESTAMP** (string(date-time))
  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

- **limit** (integer)

- **cursor** (string)
  Opaque pagination cursor

- **event_id** (string)

- **min_created_ts** (integer(int64))
  Minimum creation timestamp (Unix milliseconds).

- **max_created_ts** (integer(int64))
  Maximum creation timestamp (Unix milliseconds).

- **min_close_ts** (integer(int64))
  Minimum close timestamp (Unix milliseconds).

- **max_close_ts** (integer(int64))
  Maximum close timestamp (Unix milliseconds).

- **min_settled_ts** (integer(int64))
  Minimum settlement timestamp (Unix milliseconds).

- **max_settled_ts** (integer(int64))
  Maximum settlement timestamp (Unix milliseconds).

- **status** (string)

- **market_ids** (string)
  Comma-separated list of market IDs

- **lang** (array[string])
  Language codes to filter localized content (repeatable). If omitted, all available locales are returned.



## Responses
### 200
Page of markets

#### Body: application/json (object)
- **markets** (array[object])

- **cursor** (string | null)


### 400
Validation / semantic error

#### Body: application/json (object)
- **error_code** (string)

- **message** (string)

- **details** (object)


### 404
Resource not found

#### Body: application/json (object)
- **error_code** (string)

- **message** (string)

- **details** (object)


### 503
Backpressure / temporary unavailability

#### Body: application/json (object)
- **error_code** (string)

- **message** (string)

- **details** (object)



[Powered by Bump.sh](https://bump.sh)