Prediction events

Query tradable prediction events.

GET/api/v1/prediction/events

Domain

Prediction

Level

Prediction event

MCP tool

prediction_markets_query (task=search)

Available data

Returns: Tradable prediction events
Market coverage: Polymarket and predict.fun
Query granularity: Each query returns an event list; filter by venue, status, or keyword. Order books are not combined

Authentication

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

Query Parameters

Event filters

All optional; omit them to list events.

querystringqueryExampleFed rate cutoptional

Search text used to identify the object you want.

venuePredictionVenue[]queryExamplepolymarketoptional

Prediction-market venue.

statusstring[]queryExampleactiveoptional

Prediction market status filter.

Pagination

All optional.

limitintegerqueryExample20optional

Max rows to return (up to 1000).

cursorstringqueryExampleeyJvZmZzZXQiOjIwfQoptional

Pagination cursor.

Response

events[]object[]

Prediction events: event_ref, venue, title, status, markets_summary

event_refstringExamplepolymarket:139537

Canonical event ref (venue:id)

venuestringExamplepolymarket

Prediction venue (e.g. polymarket)

titlestringExampleRecord crypto liquidation in 2026?

Event title

statusstringExampleactive

Event status (e.g. active)

venue_event_idstringExample139537

Venue-native event id

related_asset_ids[]string[]

Related asset ids when bound

related_entity_ids[]string[]

Related entity ids when bound

markets_summaryobject

Lead-market summary for the event

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

Scheduled close time when the venue emits it

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

Event open time

resolved_atdatetime | null

Resolution time; null while the event is still active

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

Status observation time from the venue

metadataobject

Response status and resolution information

data_statusDataStatusExamplepartial

ready / partial / no_data / …

paginationobject

Pagination: limit, row_count, and next_cursor when emitted

limitintegerExample10

Page size for this response

row_countintegerExample9

Rows returned in this page

next_cursorstring

Cursor for the next page when more rows exist

limitations[]string[]Exampledata_partial

Known data limitations

updated_atdatetime | stringExample2026-08-17T08:23:59Z

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.