Perpetuals API
One coin's derivatives taker net flow: buys minus sells, 5 minutes to 1 year
One coin's derivatives taker buys, taker sells and net flow over 22 windows from 5m to 1y, summed over Binance, OKX and Bybit, with net flow as a percent of market cap.
GET
/api/external/perps/derivatives-netflow/{symbol}What it returns
One coin's derivatives volume from taker buys and from taker sells, their difference (net flow) and that net flow as a percent of the coin's market cap, over 22 trailing windows from 5 minutes to 1 year, summed across Binance, OKX and Bybit only. For BTC those three carried about half the taker volume that derivatives-taker-flow-history sums across every venue, so these figures are not market totals and are not comparable with it: read them for direction and trend. An answer may be served from a cache up to a few minutes old. symbol is the coin ticker (e.g. "BTC"), matched case-insensitively. A ticker that is not listed, or a listed coin with no flow on those three venues, answers 404.
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/derivatives-netflow/<symbol>"
| Parameter | Description |
|---|---|
symbolpath · string · required | The coin (base asset) ticker, e.g. "BTC" or "SOL" — not a venue instrument id such as "BTCUSDT", and not a token mint or contract address. Case-insensitive. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
symbol | string | The ticker as the coin is listed, e.g. "BTC" for "btc". |
windows | object | The flow over each trailing window, shortest first. |
windows.5m | object | |
windows.5m.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.5m.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.5m.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.5m.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.15m | object | |
windows.15m.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.15m.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.15m.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.15m.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.30m | object | |
windows.30m.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.30m.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.30m.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.30m.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.1h | object | |
windows.1h.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.1h.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.1h.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.1h.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.4h | object | |
windows.4h.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.4h.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.4h.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.4h.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.8h | object | |
windows.8h.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.8h.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.8h.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.8h.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.12h | object | |
windows.12h.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.12h.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.12h.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.12h.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.24h | object | |
windows.24h.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.24h.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.24h.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.24h.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.3d | object | |
windows.3d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.3d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.3d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.3d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.5d | object | |
windows.5d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.5d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.5d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.5d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.7d | object | |
windows.7d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.7d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.7d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.7d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.10d | object | |
windows.10d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.10d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.10d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.10d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.15d | object | |
windows.15d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.15d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.15d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.15d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.30d | object | |
windows.30d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.30d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.30d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.30d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.40d | object | |
windows.40d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.40d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.40d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.40d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.50d | object | |
windows.50d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.50d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.50d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.50d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.60d | object | |
windows.60d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.60d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.60d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.60d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.90d | object | |
windows.90d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.90d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.90d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.90d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.120d | object | |
windows.120d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.120d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.120d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.120d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.150d | object | |
windows.150d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.150d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.150d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.150d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.180d | object | |
windows.180d.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.180d.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.180d.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.180d.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
windows.1y | object | |
windows.1y.buyVolumeUsd | number | null | Derivatives volume from taker buys over the window, USD. |
windows.1y.sellVolumeUsd | number | null | Derivatives volume from taker sells over the window, USD. |
windows.1y.netFlowUsd | number | null | Taker buys minus taker sells over the window, USD; negative when sellers dominated. |
windows.1y.netFlowPercentOfMarketCap | number | null | Net flow as a percent of the coin's market cap: 0.0014 means 0.0014 %, not 0.14 %. Null when the market cap is unknown. |
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