Bitcoin Funding Rate (APR)
Periodic payment rate between long and short positions in Bitcoin perpetual futures, expressed on a yearly basis, aggregated across major exchanges
Request format
curl -X GET "https://newhedge.io/api/v2/metrics/funding-rate/METRIC_NAME?api_token=YOUR_TOKEN"api_token (required) — 24 character token.
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. A response with no single time axis, such as a hash keyed by venue or 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. 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 these statuses and error texts and add code, required_plan, current_plan, feature, upgrade_url, limit and resets_at where they apply. 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.
Metrics
Each metric is fetched independently. Responses are trimmed samples to show structure.
Binancebitcoin_funding_rate_binance
Data used by the Bitcoin Funding Rate (APR) chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/funding-rate/bitcoin_funding_rate_binance?api_token=YOUR_TOKENReplace `YOUR_TOKEN` with your API token.
[
[
1792972800000,
3.65
],
[
1793059200000,
1.961145
],
[
1793145600000,
2.26884
]
]Value: Binance — Bitcoin Funding Rate (APR): Periodic payment rate between long and short positions in Bitcoin perpetual futures, expressed on a yearly basis, aggregated across major exchanges.
Units: percent
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily
Bybitbitcoin_funding_rate_bybit
Data used by the Bitcoin Funding Rate (APR) chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/funding-rate/bitcoin_funding_rate_bybit?api_token=YOUR_TOKENReplace `YOUR_TOKEN` with your API token.
[
[
1792972800000,
2.832035
],
[
1793059200000,
3.610945
],
[
1793145600000,
2.15642
]
]Value: Bybit — Bitcoin Funding Rate (APR): Periodic payment rate between long and short positions in Bitcoin perpetual futures, expressed on a yearly basis, aggregated across major exchanges.
Units: percent
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily
Deribitbitcoin_funding_rate_deribit
Data used by the Bitcoin Funding Rate (APR) chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/funding-rate/bitcoin_funding_rate_deribit?api_token=YOUR_TOKENReplace `YOUR_TOKEN` with your API token.
[
[
1792972800000,
2.760716609154045
],
[
1793059200000,
1.67207399064232
],
[
1793145600000,
0.775113988805776
]
]Value: Deribit — Bitcoin Funding Rate (APR): Periodic payment rate between long and short positions in Bitcoin perpetual futures, expressed on a yearly basis, aggregated across major exchanges.
Units: percent
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily
Hyperliquidbitcoin_funding_rate_hyperliquid
Data used by the Bitcoin Funding Rate (APR) chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/funding-rate/bitcoin_funding_rate_hyperliquid?api_token=YOUR_TOKENReplace `YOUR_TOKEN` with your API token.
[
[
1792972800000,
3.65
],
[
1793059200000,
3.65
],
[
1793145600000,
3.65
]
]Value: Hyperliquid — Bitcoin Funding Rate (APR): Periodic payment rate between long and short positions in Bitcoin perpetual futures, expressed on a yearly basis, aggregated across major exchanges.
Units: percent
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily
OKXbitcoin_funding_rate_okx
Data used by the Bitcoin Funding Rate (APR) chart.
Resolutions: 1d only.
https://newhedge.io/api/v2/metrics/funding-rate/bitcoin_funding_rate_okx?api_token=YOUR_TOKENReplace `YOUR_TOKEN` with your API token.
[
[
1792972800000,
3.65
],
[
1793059200000,
3.65
],
[
1793145600000,
3.65
]
]Value: OKX — Bitcoin Funding Rate (APR): Periodic payment rate between long and short positions in Bitcoin perpetual futures, expressed on a yearly basis, aggregated across major exchanges.
Units: percent
Timestamp: Labelled 00:00 UTC of the day it describes.
Calendar: calendar_daily