Perpetuals API
One coin's perp funding rate on every venue, now and over a window
A coin's perpetual funding venue by venue: the current rate with each venue's settlement interval, and the sum over 1, 7, 30 or 365 days. Stablecoin- and coin-margined markets.
/api/external/perps/derivatives-funding/{symbol}What it returns
Every venue's perpetual funding for one coin: the current rate with the venue's settlement interval, and the rate summed over window (1, 7, 30 or 365 days). One row per venue and margin type — stablecoin-margined (USDT/USDC) markets first, then coin-margined (inverse) ones; no ranking is implied by the order. Rates are percent per that venue's own interval (1, 4, 8 or 24 hours), so two venues compare only after scaling by the interval, and a rate whose interval is null does not compare at all; the trailing-window sum already folds the settlements in and compares directly. symbol is the coin ticker (e.g. "BTC"), matched case-insensitively — not an instrument id, not a token mint or contract address, and not scoped to any of this API's chains. An unknown ticker 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-funding/<symbol>"
| Parameter | Description |
|---|---|
windowquery · string · optional | The window the accumulated funding is summed over. Defaults to 7 days.1d7d30d365d |
symbolpath · string · required | The coin (base asset) ticker, e.g. "BTC" or "kPEPE" — 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 coin, spelled as it is listed (e.g. "BTC", "kPEPE"). |
window | string | The window accumulatedPercent covers. |
markets | object[] | Stablecoin-margined markets first, then coin-margined; no ranking within either. |
markets[].venue | string | The trading venue, e.g. "Binance". |
markets[].margin | string | How the perpetual is margined: in a stablecoin (USDT/USDC), or in the coin itself (inverse). |
markets[].fundingRatePercent | number | null | Current funding rate, percent per fundingIntervalHours. Positive: longs pay shorts. null when the venue quotes none right now. |
markets[].fundingIntervalHours | number | null | The venue's funding settlement interval, hours. null when not stated for the venue — the current rate then does not compare across venues; use accumulatedPercent. |
markets[].accumulatedPercent | number | null | The funding rate summed over the trailing window, percent. Positive: longs paid shorts. null when no sum is available for the venue, and null on every row when the window figures are temporarily unavailable. |
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