GateData.AI

Prediction Event Detail

Get details for a single prediction event.

GET/api/v1/prediction/events/{event_id}
Domain
Prediction
Level
Prediction event
MCP tool
prediction_markets_query (task=event_detail)

Available data

Returns
Title, status, and related markets for one prediction event
Market coverage
Polymarket and predict.fun
Query granularity
One event per query; related markets are not mixed with other events

Authentication

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

Query Parameters

Object positioning

The path ID is required.

event_idstringpathExamplepolymarket:139537required

Prediction event_ref (e.g. polymarket:139537).

Reference filters

All optional.

event_refstringqueryExamplepolymarket:139537optional

Event natural key or reference.

market_refstringqueryExamplepolymarket:1090479optional

Market natural key or reference.

Response

event_refstringExamplepolymarket:139537

Related event identifier

venuestringExamplepolymarket

Event venue, title, and status

titlestringExampleRecord crypto liquidation in 2026?

Event venue, title, and status

statusstringExampleactive

Event venue, title, and status

markets_summaryobject

Lead market, liquidity, volume

lead_market_idstringExamplepolymarket:1090479

Lead market id

liquidity_usdnumberExample2799.77

Lead-market liquidity in USD

market_countintegerExample1

Number of markets on the event

volume_24h_usdnumberExample0

24h volume in USD

closes_atdatetime | null

Venue timestamps; null while unknown or still active

opened_atdatetime | nullExample2026-01-03T05:41:53.000+0000

Venue timestamps; null while unknown or still active

resolved_atdatetime | null

Venue timestamps; null while unknown or still active

status_as_ofdatetime | nullExample2026-08-17T06:42:31.000+0000

Venue timestamps; null while unknown or still active

market_countintegerExample1

Number of markets on the event

venue_event_idstringExample139537

Venue-native event id

related_asset_ids[]string[]

Related asset identifiers

related_entity_ids[]string[]

Related entity identifiers

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

Signal time of the lead market; also returned in metadata.signal_time

metadataobject

Response status and resolution information

data_statusDataStatusExamplepartial

ready / partial / …

signal_timedatetime | stringExample2026-08-17T07:00:00.000+0000

Signal time in metadata when present

limitations[]string[]Exampledata_partial

Known data limitations

updated_atdatetime | stringExample2026-08-17T07:00:00.000+0000

Most recent object or response update time

partialbooleanExampletrue

Whether the response contains only a subset of fields

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleevent

Object reference type

idstringExamplepolymarket:139537

Canonical object identifier

event_refstringExamplepolymarket:139537

Related event identifier

market_idstring

Canonical market object identifier

venuestringExamplepolymarket

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.