Trending event rankings

View trending prediction-event rankings.

GET/api/v1/prediction/rankings

Domain

Prediction

Level

Event ranking

MCP tool

prediction_markets_query (task=rankings)

Available data

Returns: Trending prediction-event rankings
Market coverage: Polymarket and predict.fun
Query granularity: One ranking per query; a venue filter limits the list to that platform

Authentication

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

Query Parameters

Ranking type

ranking_type is required.

ranking_typeRankingTypequeryExamplevolume_24hrequired

Ranking metric.

Filters and response

All optional.

venuePredictionVenuequeryExamplepolymarketoptional

Prediction-market venue.

statusstring[]queryExampleactiveoptional

Prediction market status filter.

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

rankings[]object[]

rank_no, rank_type, ranking_value, rank_date_utc, event_ref, venue_event_id, excluded_reasons, volume/liquidity

rank_nointegerExample1

Rank position

rank_typestringExamplevolume_24h

Ranking type

ranking_valuenumberExample281664832

Ranked metric value

rank_date_utcdatetime | stringExample2026-08-17

Ranking as-of time (UTC)

event_refstringExamplepolymarket:30615

Canonical event ref

venue_event_idstringExample30615

Venue-native event id

titlestringExampleWorld Cup Winner

Event title

venuestringExamplepolymarket

Prediction venue

excluded_reasons[]string[]

Reasons the row was excluded from a stricter rank

liquidity_usdnumberExample595017090

Event liquidity in USD

volume_24h_usdnumberExample281664832

24h volume in USD

metadataobject

Response status and resolution information

paginationobject

Pagination: limit and row_count

limitintegerExample10

Page size for this response

row_countintegerExample10

Rows returned in this page

data_statusDataStatusExampleready

ready / partial / …

limitations[]string[]

Known data limitations

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

Most recent object or response update time

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleevent

Object reference type

idstringExamplepolymarket:30615

Canonical object identifier

event_refstringExamplepolymarket:30615

Related event 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.