Skip to main content
GET
Get market details

Authorizations

X-API-Key
string
header
required

Path Parameters

id_or_slug
string
required

Market ID or market slug.

Required string length: 1 - 200
Example:

"618831"

Response

Detailed market object with tokens and resolution metadata.

Detailed response for GET /markets/{id_or_slug}.

id
string

Unique market identifier.

Example:

"618831"

slug
string

Stable URL-friendly market slug.

Example:

"will-candidate-x-win-2025"

question
string | null

Human-readable market question.

Example:

"Will Candidate X win the 2025 election?"

description
string | null

Long-form market description, if available.

Example:

"Resolves to YES if Candidate X wins the 2025 election."

status
string

Current market status.

Example:

"open"

start_date
string<date-time> | null

Market start timestamp in ISO 8601 format.

Example:

"2025-09-01T00:00:00Z"

end_date
string<date-time> | null

Market end timestamp in ISO 8601 format.

Example:

"2025-11-05T23:59:59Z"

closed_at
string<date-time> | null

Timestamp when the market was closed.

Example:

"2025-11-06T03:00:00Z"

resolved_token_id
string | null

Winning token identifier when market is resolved.

Example:

"12345"

resolved_token_label
string | null

Winning token label when market is resolved.

Example:

"Yes"

tokens
TokenInfo · object[]

All tokens for the market.