Prediction markets API

Prediction trader markets brief: a trader's results per market

At most 20 markets with volume, PnL and per-outcome position and result.

GET/api/external/prediction/prediction-trader-markets-brief/{id}

Get a free API key Try it in the API reference

What it returns

The brief of prediction-trader-markets; prefer it unless you need each outcome's fills and volumes. The same trader, ranking and paging. It lists the page's first 20 rows in the ranking, each with every market-level field prediction-trader-markets gives, and per outcome the shares held, entry and current price, realized and unrealized PnL and result. Page with offset as the full endpoint does; a limit above 20 still lists 20, and rowCount says how many the page held.

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-trader-markets-brief/<id>"

Parameters
Parameter	Description
`sort_by` query · string · optional	Which figure to rank the trader's markets 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.
`offset` query · integer · optional	0-based row offset, for paging through the ranking. At most 1000000.
`id` path · string · required	A prediction-market trader id, e.g. "<walletAddress>:Polymarket", as `traderId` in prediction-trades and prediction-market-traders rows — not a bare wallet 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 Prediction trader markets brief: a trader's results per market
Field	Type	Description
`rowCount`	integer	Rows on the page, up to `limit`; a page shorter than `limit` is the last one. Only the first 20 are listed.
`items`	object[]	The page's first 20 rows, in its ranking.
`items[].marketId`	string \| null	The market's id, as `prediction-market` and `prediction-market-traders` take it.
`items[].question`	string \| null	The market's question.
`items[].label`	string \| null	The market's short name inside its event, e.g. `25 bps decrease`. Null when it has none.
`items[].eventId`	string \| null	The event the market belongs to, as `prediction-event` takes it.
`items[].eventLabel`	string \| null	The event's name.
`items[].status`	string \| null	The market's status, e.g. `OPEN`, `RESOLVED`. Open set: other values can appear.
`items[].closesAt`	number \| null	When the market closes to trading, Unix seconds.
`items[].resolvedAt`	number \| null	When the market resolved, Unix seconds. Null while it has not.
`items[].hasOpenPosition`	boolean \| null	Whether the trader still holds shares on this market.
`items[].realizedPnlUsd`	number \| null	The trader's 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	What the shares held now are worth, USD.
`items[].volumeUsd`	number \| null	USD the trader traded on this market.
`items[].volumeShares`	number \| null	Shares traded, summed across outcomes.
`items[].costBasisUsd`	number \| null	What the shares held now cost, USD.
`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[].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[].currentPriceUsd`	number \| null	The outcome's current price, 0 to 1. Null once the market has resolved.
`items[].outcomes[].realizedPnlUsd`	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.

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.

Every market one prediction-market trader traded, and how they did on each
The full answer this one condenses
Who traded one prediction market, and how each trader did on it
Every market of one trader, against every trader of one market.
Latest trades and redemptions on one prediction market
A trader's totals per market, against one market's individual trades.
The outcome positions one prediction-market trader holds right now
The trader's whole result and current value per market, against each outcome token they hold right now.
One prediction-market trader: lifetime totals, labels and recent results
How one prediction-market trader has performed — lifetime and day, week and 30-day volume, realized profit, wins, losses and win rate — and whether it is labelled a bot or market maker.
One prediction-market trader's results bucketed over a window
How one prediction-market trader's volume, trades, wins, losses and realized profit moved per hour, day or week, with a running profit total — a PnL curve.

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