Perpetuals API

Perpetual-futures trading accounts, ranked

Trading accounts on the perpetual-futures venue, ranked. An ACCOUNT is an address with no chain attached — a derivatives account, not an on-chain wallet with token balances.

GET/api/external/perps/perps-traders

Get a free API key Try it in the API reference

What it returns

Ranks trading accounts on the leveraged derivatives venue this family covers — equity, PnL, win rate, volume, funding paid/received, over 29 sortable fields. No chain and no token/wallet subject in the request: address, on any row, is a trading-account address on that venue, never a wallet on any of this API's six chains.

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/perps/perps-traders"

Parameters
Parameter	Description
`last_trade_duration` query · string · optional	Only rank accounts whose most recent trade falls within this window. Defaults to "all".`1d7d30d90dall`
`sort_by` query · string · optional	Which of the 29 published metrics to rank by. Defaults to lifetime total PnL.`perp_equitylong_valueshort_valueunrealized_pnlorder_countorder_count_90dwinwin_90dlossloss_90dvolume_usdvolume_90d_usdopen_volume_usdopen_volume_90d_usdrealized_pnlrealized_pnl_90dfunding_feefunding_fee_90dfirst_tradelast_tradewin_ratewin_rate_90dopen_valuetotal_pnltotal_pnl_90droeroiroi_90dbiasleverage`
`sort_type` query · string · optional	Sort direction. Defaults to descending.`ascdesc`
`offset` query · integer · optional	0-based row offset.
`limit` query · integer · optional	How many rows to return. Defaults to 10; this endpoint caps it at 20.

Response fields

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

Response fields of Perpetual-futures trading accounts, ranked
Field	Type	Description
`traders`	object[]
`traders[].trader`	string \| null	The trading-account address ranked in this row.
`traders[].equityUsd`	number \| null	Current total perp equity, USD.
`traders[].longValueUsd`	number \| null	Total notional value of open long positions, USD.
`traders[].shortValueUsd`	number \| null	Total notional value of open short positions, USD.
`traders[].unrealizedPnlUsd`	number \| null	Current unrealized profit and loss across open positions, USD.
`traders[].orderCount`	number \| null	Lifetime number of orders/fills tracked for this account.
`traders[].orderCount90d`	number \| null	Orders/fills recorded during the last 90 days.
`traders[].wins`	number \| null	Lifetime number of profitable realized trades or position outcomes.
`traders[].wins90d`	number \| null	Profitable realized outcomes during the last 90 days.
`traders[].losses`	number \| null	Lifetime number of losing realized trades or position outcomes.
`traders[].losses90d`	number \| null	Losing realized outcomes during the last 90 days.
`traders[].volumeUsd`	number \| null	Lifetime trading volume, USD.
`traders[].volume90dUsd`	number \| null	Trading volume during the last 90 days, USD.
`traders[].openVolumeUsd`	number \| null	Lifetime USD notional value of currently open positions.
`traders[].openVolume90dUsd`	number \| null	USD notional value of positions opened during the last 90 days.
`traders[].realizedPnlUsd`	number \| null	Lifetime realized profit and loss, USD.
`traders[].realizedPnl90dUsd`	number \| null	Realized profit and loss during the last 90 days, USD.
`traders[].fundingFeeUsd`	number \| null	Lifetime net funding paid or received, USD.
`traders[].fundingFee90dUsd`	number \| null	Net funding paid or received during the last 90 days, USD.
`traders[].firstTradeAt`	number \| null	Unix seconds of this account's first recorded trade.
`traders[].lastTradeAt`	number \| null	Unix seconds of this account's most recent recorded trade.
`traders[].openValueUsd`	number \| null	Current total notional value of all open positions, USD.
`traders[].totalPnlUsd`	number \| null	Lifetime total PnL, realized plus unrealized, USD.
`traders[].totalPnl90dUsd`	number \| null	Total PnL during the last 90 days, USD.
`traders[].winRate`	number \| null	Lifetime win rate across realized outcomes, 0-1.
`traders[].winRate90d`	number \| null	Win rate during the last 90 days, 0-1.
`traders[].roe`	number \| null	Aggregate return on equity for this account's activity.
`traders[].roi`	number \| null	Aggregate return on invested capital across this account's activity.
`traders[].roi90d`	number \| null	Return on invested capital during the last 90 days.
`traders[].bias`	number \| null	Net directional bias between long and short positioning. Positive = long skew; negative = short skew.
`traders[].leverage`	number \| null	Aggregate effective leverage across open positions.
`traders[].biasText`	string \| null	Human-readable interpretation of `bias`, e.g. "Very Bearish".

Price per call

Every call: 40 credits

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

One perpetual-futures trading account
Rank the accounts, then ask about one.
Perpetual-futures markets, all of them
The account side of the same universe; that one lists the markets.
Unrealized-PnL wallet ranking, 6 chains
Also ranks by profit, but on-chain wallets per chain rather than derivatives accounts.
The perps venue's traders by size tier and by PnL tier
The individual traders behind the tiers, ranked.
Open positions held by one perpetual-futures account
The positions currently open for ONE perpetual-futures trading account, keyed by address with no chain. Derivatives exposure, never token balances.
Derivatives leaders across venues: open interest, volume, funding, liquidations
The coins with the most futures open interest across derivatives venues, each with 24h volume, funding rate, liquidations and price change. Keyed by ticker.

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