Prediction markets API

Prediction-market events, ranked by volume, liquidity or trending score

A ranked page of prediction EVENTS -- the question being bet on, one level above the markets that price it. Use it to find an event id; it prices nothing.

GET/api/external/prediction/prediction-events

Get a free API key Try it in the API reference

What it returns

A market-wide ranking across every prediction-market event this endpoint covers — no chain and no token/wallet subject in the request at all. This is a DIFFERENT universe from the rest of this API: an event id here is never a token mint or contract address, and nothing this endpoint returns can be looked up against this API's six chains. Use id on any row with GET /prediction/prediction-event for more detail on one event.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/prediction/prediction-events"

Parameters
Parameter	Description
`phrase` query · string · optional	Free-text search over the event question, e.g. "Champions League".
`status` query · string · optional	Filter to one event status.`OPENSUSPENDEDRESOLVEDCANCELLEDPENDING`
`sort_by` query · string · optional	Which figure to sort by. Defaults to 24h volume.`volumeUsd24hliquidityUsdtrendingScore24hcreatedAtmarketCount`
`sort_type` query · string · optional	Sort direction. Defaults to descending.`ASCDESC`
`offset` query · integer · optional	0-based row offset, for paging through the ranking.
`limit` query · integer · optional	How many rows to return. Defaults to 10; this endpoint caps it at 25.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Prediction-market events, ranked by volume, liquidity or trending score
Field	Type	Description
`events`	object[]
`events[].id`	string \| null	The event id. Not a token mint or contract address.
`events[].question`	string \| null	The event's headline question.
`events[].protocol`	string \| null	The venue this event trades on, e.g. "POLYMARKET" or "KALSHI".
`events[].status`	string \| null	One of OPEN, SUSPENDED, RESOLVED, CANCELLED, PENDING.
`events[].eventShape`	string \| null	A structural classification of the event, e.g. "SPORTS_MATCH" or "ELECTION".
`events[].marketCount`	number \| null	How many markets make up this event.
`events[].categories`	string[] \| null	Category slugs this event is tagged under.
`events[].tags`	string[] \| null	Free-form venue tags.
`events[].url`	string \| null	The venue's own page for this event.
`events[].opensAt`	number \| null	Unix seconds the event opened for trading.
`events[].closesAt`	number \| null	Unix seconds trading closes.
`events[].resolvesAt`	number \| null	Expected resolution time, Unix seconds.
`events[].resolvedAt`	number \| null	Actual resolution time, Unix seconds — null while unresolved.
`events[].liquidityUsd`	number \| null	Current total liquidity across the event's markets, USD.
`events[].volumeUsd24h`	number \| null	Trading volume over the last 24h, USD.
`events[].trades24h`	number \| null	Number of trades over the last 24h.
`events[].uniqueTraders24h`	number \| null	Distinct trading accounts over the last 24h — null on venues that do not report it (measured: Kalshi).
`events[].trendingScore24h`	number \| null	A trending score over the last 24h.

Price per call

Every call: 141 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

One prediction-market event's identity, lifecycle and windowed stats
The ranked list, against one event's own identity and lifecycle.
The full category taxonomy prediction markets are sorted under
The vocabulary an events query filters by, and the events it returns.
The markets of one prediction event, and the part each plays
Find an event and its id first, then list the markets that price it.
A prediction event's volume, liquidity and open interest over time
How trading on a whole prediction event moved bucket by bucket — volume, trades, traders, and liquidity and open interest as OHLC — across all of its markets.
One prediction market's OHLC-style bars over a bounded window
The priced series for one market over a bounded window, in OHLC-style bars. A different question from the market's state: how the price moved, not what it is.
Many prediction markets' OHLC-style bars over a bounded window
The priced series of up to 25 prediction markets in one request, at one resolution over one bounded window, in OHLC-style bars.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key