Prediction Market Detail

Get details for a single prediction market.

GET/api/v1/prediction/markets/{market_id}

Domain

Prediction

Level

Prediction market

MCP tool

prediction_markets_query (task=market)

Available data

Returns: Liquidity, 24-hour volume, and status for one prediction market
Market coverage: Polymarket and predict.fun
Query granularity: One market per query; other markets in the same event are queried separately

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Object positioning

The path ID is required.

market_idstringpathExamplepolymarket:1090479required

Prediction market ID.

Reference filters

All optional.

event_refstringqueryExamplepolymarket:139537optional

Event natural key or reference.

market_refstringqueryExamplepolymarket:1090479optional

Market natural key or reference.

Response

market_idstringExamplepolymarket:1090479

Prediction market identifier

market_titlestringExampleRecord crypto liquidation in 2026?

Prediction market title and venue-native id

venue_market_idstringExample1090479

Prediction market title and venue-native id

event_refstringExamplepolymarket:139537

Related event identifier

venuestringExamplepolymarket

Parent venue and market status

statusstringExampleactive

Parent venue and market status

liquidity_usdnumberExample2799.77

Market liquidity and volume

volume_24h_usdnumberExample0

Market liquidity and volume

closes_atdatetime | null

Venue close / resolution time when emitted

resolved_atdatetime | null

Venue close / resolution time when emitted

market_countintegerExample1

Number of markets on the parent event

signal_timedatetimeExample2026-08-17T07:00:00.000+0000

Lead-market signal time when present

metadataobject

Response status and resolution information

data_statusDataStatusExamplepartial

ready / partial / …

limitations[]string[]Exampledata_partial

Known data limitations

updated_atdatetime | stringExample2026-08-17T08:24:13Z

Most recent object or response update time

partialbooleanExampletrue

Whether the response contains only a subset of fields

object_refs[]object[]

Unified object references

typeObjectRefTypeExamplemarket

Object reference type

idstringExamplepolymarket:1090479

Canonical object identifier

event_refstring

Related event identifier

market_idstringExamplepolymarket:1090479

Canonical market object identifier

venuestring

Related platform code

Errors & fallback

200

assets_resolve name multi-match; confirm from data[] candidates.

200

The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.

400

Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.

401

The API key is missing or invalid.

403

The current key scope or plan cannot access this data domain.

404

The requested resource does not exist; source coverage gaps are not 404 responses.

402

Credits or monthly quota exhausted.

429

Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.