Prediction markets API

Who traded one prediction market, and how each trader did on it

The traders of one market ranked by volume, realized PnL or activity, with each one's position, entry price and PnL per outcome.

GET/api/external/prediction/prediction-market-traders/{id}

Get a free API key Try it in the API reference

What it returns

One row per trader on the market, ranked by sort_by, with their totals and a per-outcome breakdown (position, entry price, realized and unrealized PnL). Page with offset. Only venues that settle on-chain keep per-trader records: a market on an off-chain venue, like an unknown id, answers an empty items. There is no total: a page shorter than limit is the last one, and an offset past the end answers an empty items too. isWinningOutcome is set only once the market has resolved.

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-market-traders/<id>"

Parameters
Parameter	Description
`sort_by` query · string · optional	Which figure to rank traders by. Defaults to USD volume.`volumeUsdrealizedPnlUsdtradeslastTradeTimestampprofitPerTradeUsd`
`sort_type` query · string · optional	Sort direction. Defaults to descending.`ASCDESC`
`limit` query · integer · optional	How many rows to return. Defaults to 20; this endpoint caps it at 100. limit ≤ 15 keeps the answer under 32 KB.
`offset` query · integer · optional	0-based row offset, for paging through the ranking. At most 1000000.
`id` path · string · required	A prediction-market id, e.g. "<marketAddress>:Polymarket:<exchangeAddress>:<networkId>" or "<slug>:Kalshi" — not a token mint or contract address, and not scoped to any chain this API otherwise supports.

Response fields

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

Response fields of Who traded one prediction market, and how each trader did on it
Field	Type	Description
`items`	object[]
`items[].traderId`	string \| null	A stable id for this trader, the same one `prediction-trades` rows carry. Pass it as the `id` of `prediction-trader-markets` for every market this trader traded.
`items[].wallet`	string \| null	The trader's EVM wallet address. Null when the venue exposes none.
`items[].alias`	string \| null
`items[].labels`	string[]	e.g. `market-maker`, `high-frequency-bot`. Empty when none.
`items[].profileUrl`	string \| null
`items[].profileImageUrl`	string \| null
`items[].hasOpenPosition`	boolean \| null
`items[].realizedPnlUsd`	number \| null	Realized PnL on this market, USD. A real `0` is possible.
`items[].unrealizedPnlUsd`	number \| null	Unrealized PnL on the open position, USD.
`items[].currentPositionValueUsd`	number \| null
`items[].volumeUsd`	number \| null	Total USD traded on this market.
`items[].volumeShares`	number \| null	Shares traded, summed across outcomes.
`items[].costBasisUsd`	number \| null
`items[].sharesHeld`	number \| null	Shares held now, summed across outcomes — `outcomes` has the position per outcome.
`items[].buys`	number \| null	Number of buy fills.
`items[].sells`	number \| null	Number of sell fills.
`items[].trades`	number \| null	Number of fills, buys plus sells.
`items[].pnlPerVolume`	number \| null	Realized PnL divided by USD volume, as a fraction (0.0021 is 0.21%).
`items[].profitPerTradeUsd`	number \| null	Realized PnL divided by `trades`, USD.
`items[].firstTradeTimestamp`	number \| null	Unix seconds.
`items[].lastTradeTimestamp`	number \| null	Unix seconds.
`items[].outcomes`	object[]	At most one entry per outcome, outcome 0 first (e.g. `Yes` then `No`). An outcome with no record is left out, so read `label`, not the position.
`items[].outcomes[].outcomeId`	string \| null
`items[].outcomes[].label`	string \| null	e.g. `Yes`.
`items[].outcomes[].isWinningOutcome`	boolean \| null	Whether this outcome won, once the market has resolved. Null while it is open, and for a market that ended any other way.
`items[].outcomes[].sharesHeld`	number \| null	Shares of this outcome held now.
`items[].outcomes[].avgEntryPriceUsd`	number \| null	Average price paid per share of the shares held now, 0 to 1. Null when none are held.
`items[].outcomes[].costBasisUsd`	number \| null
`items[].outcomes[].buys`	number \| null	Number of buy fills.
`items[].outcomes[].sells`	number \| null	Number of sell fills.
`items[].outcomes[].buyVolumeUsd`	number \| null
`items[].outcomes[].sellVolumeUsd`	number \| null
`items[].outcomes[].realizedPnlUsd`	number \| null
`items[].outcomes[].currentPriceUsd`	number \| null	The outcome's current price, 0 to 1. Null once the market has resolved.
`items[].outcomes[].currentPositionValueUsd`	number \| null
`items[].outcomes[].unrealizedPnlUsd`	number \| null
`items[].outcomes[].pnlStatus`	string \| null	The trader's result on this outcome, e.g. `WIN`, `NEUTRAL` — `WIN` is possible on the losing outcome when it was sold at a profit. Open set: new values can appear.
`items[].outcomes[].firstTradeTimestamp`	number \| null	Unix seconds. Null when the trader never traded this outcome.
`items[].outcomes[].lastTradeTimestamp`	number \| null	Unix seconds. Null when the trader never traded this outcome.

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.

Holder balances for one outcome token of one prediction market
Each trader's whole result on the market, against who holds one outcome token right now.
Latest trades and redemptions on one prediction market
One row per trader with their totals, against every individual trade as it happened.
Every market one prediction-market trader traded, and how they did on each
Every trader of this market, against every market of one of these traders.
One prediction-market trader: lifetime totals, labels and recent results
Find a trader and its id on a market first, then look at its whole record.
One prediction-market trader's results bucketed over a window
Find a trader and its id on a market first.
Prediction trader markets brief: a trader's results per market
Every market of one trader, against every trader of one market.

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