BTC Futures Funding Rate by Contract API
Daily settled funding rate by Bitcoin futures contract.
Request
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-funding-rate-by-contract/METRIC_NAME"Parameters & responses
Authorization: Bearer YOUR_TOKEN (required) — your 24 character API key (also accepted: the X-API-Key header or the api_token query parameter).
resolution (optional) — 1d only for the metrics on this chart. A finer value is refused, never served as 1d: 401 when the token is not entitled to finer buckets, 400 when it is entitled and the metric does not ingest that bucket; see Resolutions.
before (optional) — exclusive cursor, returns observations older than this timestamp_ms. Works on every resolution.
limit (optional) — the most recent N observations, maximum 5000. Finer resolutions page by default (2500); a 1d request returns the whole series unless you send limit or before.
before and limit narrow a time series. On a metric keyed by exchange or tenor they apply to each series, and the keys stay where they are. A response with no time axis, such as a labelled snapshot table, has nothing to cut on. It is returned whole, and both parameters are ignored rather than rejected.
A before that is not a positive epoch-millisecond timestamp is a 400. It is the one paging value we reject rather than ignore, because a page size has a sensible default and a cursor does not.
include (optional) — definition wraps the response as {"definition": …, "data": …} and returns the record shown under each metric; see Definitions. Any other value is a 400.
:metric_name — one of the metric names listed below.
200 with JSON payload, 400 for an unknown include value, 401 for missing/invalid token, 404 for missing resources, 429 when the monthly limit is reached. A 404 for a metric withdrawn on purpose adds withdrawn, withdrawn_on and reason, for example {"error":"Metric not found","withdrawn":true,"withdrawn_on":"2026-09-07","reason":"The venue's public feed reports insurance-fund settlements, not liquidation orders."}; a removed chart can add successor.
Plan and quota refusals keep their error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. The 429 for a used-up monthly allowance carries Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. A Pro token whose history window removed points also gets the X-Newhedge-History-Truncated headers, and for a Pro token X-Newhedge-Available-From is the start of the window. See Errors and plan limits.
Every 404 and 400 also carries a machine code and, where a list of valid names exists, up to 3 did_you_mean spellings, catalog_url and docs_url. Two different keys in one request are a 400 with code: conflicting_credentials. Only a successful response spends one call from the monthly allowance. A refused or failed call (any 4xx or 5xx, a conflict between credentials, an unknown path) spends nothing, and the request-rate limits are unchanged. The full list of codes is under Errors on the introduction page.
Metrics
One request per metric.
Futures Funding Rate By Contract Dailyfutures_funding_rate_by_contract_daily
Resolutions: 1d only.
Derivatives API add-on: required at every resolution.
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-funding-rate-by-contract/futures_funding_rate_by_contract_daily"Replace `YOUR_TOKEN` with your API token.
{
"nado:2": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"lighter:1": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"aster:BTCU": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"binance:BTCU": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"bybit:BTCUSD": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"dydx:BTC-USD": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"gate:BTC_USD": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"mexc:BTC_USD": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"aster:BTCUSD1": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"aster:BTCUSDC": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"aster:BTCUSDT": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
],
"bitget:BTCUSD": [
[
1735516800000,
42
],
[
1735603200000,
42
],
[
1735689600000,
42
]
]
}Definition & units
DefinitionValue: Futures Funding Rate By Contract Daily — Daily settled funding rate by Bitcoin futures contract.
Units: ratio
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily
Futures Funding Rate By Contract Labelsfutures_funding_rate_by_contract_labels
Resolutions: 1d only.
Derivatives API add-on: required at every resolution.
curl -H "Authorization: Bearer YOUR_TOKEN" "https://newhedge.io/api/v2/metrics/futures-funding-rate-by-contract/futures_funding_rate_by_contract_labels"Replace `YOUR_TOKEN` with your API token.
{
"nado:2": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"lighter:1": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"aster:BTCU": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"binance:BTCU": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"bybit:BTCUSD": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"dydx:BTC-USD": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"gate:BTC_USD": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"mexc:BTC_USD": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"aster:BTCUSD1": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"aster:BTCUSDC": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"aster:BTCUSDT": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
},
"bitget:BTCUSD": {
"venue": "Example",
"margin": "Example",
"settle": "Example",
"ticker": "Example"
}
}Definition & units
DefinitionValue: Lookup table that names the contracts in the funding rate by contract series. It has one entry per Bitcoin perpetual futures contract, keyed by the exchange and the market identifier that exchange uses for the contract, joined by a colon (for example binance:BTCUSD_PERP). Each entry gives the exchange, the margin type (stable or coin), the settlement asset and the ticker that labels the contract. It holds no rate and no other number. The funding rates are in futures_funding_rate_by_contract_daily.
Revision policy: recomputed. Each refresh re-derives the entry of every contract it lists, so an entry can change, for example when a ticker gains a market identifier suffix to stay unique within its exchange. An entry for a contract that is no longer listed is kept.
Universe: Bitcoin perpetual futures contracts on the tracked derivatives venues.
Methodology version: 2026-09-06