# Get market by ID

**GET /markets/{market_id}**




## 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.


### Path parameters

- **market_id** (string)
  Unique identifier for the market


### Query parameters

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



## Responses
### 200
Market details

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

- **event_id** (string)

- **market_index** (integer)
  Index of the market within the event (e.g., 0-5 for 6 markets)

- **title** (object)
  Localized text content. When lang filter is applied, only requested locales are included.
  When lang filter is omitted, all available locales (en, pt, id) are included.

- **yes_sub_title** (object)

- **no_sub_title** (object)

- **lower_inclusive** (boolean)
  Whether lower_bound is inclusive in the range

- **upper_inclusive** (boolean)
  Whether upper_bound is inclusive in the range

- **status** (string)
  - unopened: created, not initialized in CLOB
  - pre-open: loaded in CLOB (MM can already place liquidity)
  - suspended: market open, but new orders are temporarily declined
  - active: market open for order acceptance
  - closed: closed, awaiting resolution; trading stopped, orders no longer accepted
  - settled: market resolved, payouts completed
  - voided: market cancelled, contracts refunded

- **status_revision** (integer(int64))
  Monotonic revision of the market status from Event Service

- **result** (string)
  Written when the event resolves, so it appears before the market reaches settled.
  - yes: YES is the winner
  - no: NO is the winner
  - empty: no result yet, or the market was voided

- **created_at** (string(date-time))

- **opens_at** (string(date-time))

- **closes_at** (string(date-time))

- **expected_expiration_time** (string(date-time))

- **settlement_timer_seconds** (integer(int32))
  The amount of time after determination that the market settles

- **can_close_early** (boolean)

- **early_close_condition** (string | null)

- **strike_type** (string)
  Determines how the market strike is defined and evaluated

- **floor_strike** (object)
  Minimum expiration value that leads to a YES settlement

- **cap_strike** (object)
  Maximum expiration value that leads to a YES settlement

- **custom_strike** (string | null)
  Expiration value that leads to a YES settlement when strike_type=custom

- **expiration_value** (string | null)
  The asset value that was used for determination and settlement. Not necessarily a price, and not always numeric: it carries whatever value the settlement source publishes for the outcome.

- **settlement_price** (object)
  Final settlement price of the YES contract


### 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)