Perpetuals API

One perpetual-futures trading account

The state of ONE perpetual-futures trading account, keyed by address with NO chain. Other wallet endpoints answer about on-chain holdings; this one about derivatives exposure.

GET/api/external/perps/perps-trader/{address}

Get a free API key Try it in the API reference

What it returns

Equity, PnL, win rate, volume, and funding paid/received for ONE trading account on the leveraged derivatives venue this family covers. address is that account's address on that venue — not a wallet on any of this API's six chains, and not looked up against any of them. A malformed address returns 400 naming exactly that.

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-trader/<address>"

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

Price per call

Every call: 20 credits

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

Open positions held by one perpetual-futures account
What that account currently holds open.
Perpetual-futures trading accounts, ranked
Rank the accounts, then ask about one.
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.
One coin's futures markets across venues: funding, open interest, volume
One coin's funding-quoting futures markets (nearly all perpetuals), venue by venue: price, open interest, volume, funding rate and interval, max leverage, tick size, liquidations. Keyed by ticker.
Futures venues ranked by open interest or volume, with liquidations
Ranks major futures venues by open interest or 24h volume, every coin summed, with 24h liquidations where the venue has a feed. Also names the followed venues the ranking leaves out.
What is this derivatives exchange, and what does it list?
One futures/perpetuals exchange: open interest, 24h volume, founding year, country, and every market it lists by open interest, with price, funding and last trade.

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