Prediction markets API

The full category taxonomy prediction markets are sorted under

The taxonomy prediction events are filed under. Read it to learn the vocabulary an events query can filter by; it answers no question about any one event.

GET/api/external/prediction/prediction-categories

Get a free API key Try it in the API reference

What it returns

A static, three-level taxonomy (category, subcategory, sub-subcategory) — no chain and no subject in the request at all. Use a category or subcategory slug as a filter on GET /prediction/prediction-events or GET /prediction/prediction-markets.

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-categories"

Response fields

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

Response fields of The full category taxonomy prediction markets are sorted under
Field	Type	Description
`categories`	object[]
`categories[].name`	string \| null	The category name, e.g. "Economy".
`categories[].slug`	string \| null	The category slug, e.g. "economy".
`categories[].subcategories`	object[] \| null
`categories[].subcategories[].name`	string \| null	The subcategory name.
`categories[].subcategories[].slug`	string \| null	The subcategory slug.
`categories[].subcategories[].subcategories`	object[] \| null
`categories[].subcategories[].subcategories[].name`	string \| null	The subcategory name.
`categories[].subcategories[].subcategories[].slug`	string \| null	The subcategory slug.

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.

Prediction-market events, ranked by volume, liquidity or trending score
The vocabulary an events query filters by, and the events it returns.
Which prediction-market categories carry the most volume on each venue?
The fixed taxonomy without counts, against the venues' own tags with market counts and volume.
One prediction-market event's identity, lifecycle and windowed stats
One event: what is being bet on, whether it is open or settled, and its windowed activity. The markets that price it are a separate read.
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