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.

GET/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>"
Parameters
ParameterDescription
window

query · string · optional

The window the accumulated funding is summed over. Defaults to 7 days.1d7d30d365d
symbol

path · 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.

Response fields of One coin's perp funding rate on every venue, now and over a window
FieldTypeDescription
symbolstringThe coin, spelled as it is listed (e.g. "BTC", "kPEPE").
windowstringThe window accumulatedPercent covers.
marketsobject[]Stablecoin-margined markets first, then coin-margined; no ranking within either.
markets[].venuestringThe trading venue, e.g. "Binance".
markets[].marginstringHow the perpetual is margined: in a stablecoin (USDT/USDC), or in the coin itself (inverse).
markets[].fundingRatePercentnumber | nullCurrent funding rate, percent per fundingIntervalHours. Positive: longs pay shorts. null when the venue quotes none right now.
markets[].fundingIntervalHoursnumber | nullThe 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[].accumulatedPercentnumber | nullThe 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