资金费率 API:一次请求获取所有交易所的费率,另含已结算资金费率历史
简而言之
- 资金费率 API 应当为每个交易所返回:每个间隔的费率、间隔本身、下次结算时间、换算为 8 小时的费率和合约价格。
- Binance、Bybit、OKX 和 Hyperliquid 各有自己的 endpoint、单位和间隔表示方式。Genesis API 的
/funding/rates用一次 GET 请求返回所有交易所的费率,单位为百分比,并统一换算为 8 小时。 - 13 家交易所的已结算资金费率历史——合计、平均费率、APR、一年的每日合计,以及扣除手续费后给出
net的组合筛选器——在 Pro 和 Max 套餐的/funding/analytics/*中。
资金费率 API 按交易所返回永续合约的资金费率:每个间隔的费率、间隔本身和下次结算时间;更完整的版本还提供已结算资金费率的历史。每家交易所都有自己的 API,路径、单位和间隔各不相同,所以要比较它们,就得把费率收集到一张表里,换算为百分比,并统一到同一个周期,通常是 8 小时。
资金费率 API 应该返回什么
不带间隔的费率说明不了任何问题:每 4 小时 0.02% 和每 8 小时 0.02% 相差一倍。因此,一个好用的加密货币资金费率 API 会为每个币种与交易所的组合返回五个值。
| 你需要什么 | 为什么 | /funding/rates 字段 |
|---|---|---|
| 每个间隔的费率 | 下一次结算会收付多少 | funding_pct |
| 资金费率间隔 | 没有它就无法比较费率 | interval |
| 下次结算时间 | 持仓必须在此之前建立 | next_payout |
| 8 小时费率 | 比较间隔不同的交易所 | funding_8h_pct |
| 合约价格 | 两条腿之间的价差会影响入场 | price |
收付金额等于持仓规模乘以费率:10,000 美元的持仓在 0.01% 的费率下,每次结算收取或支付 1 美元。
为什么各交易所的间隔不同,以及如何把费率换算为 8 小时
每家交易所自行决定多久结算一次资金费率,还可以单独修改某个合约的间隔。在 Genesis API 的分析数据中,CEX 的间隔为 8 小时和 4 小时,而 Hyperliquid 和 Lighter 每小时结算一次。Hyperliquid 按 8 小时费率计算,每小时支付其八分之一,详见 Hyperliquid 资金费率规则。
在 Genesis API 文档的示例中,MEXC 对 TON 每 4 小时收取 0.02%:0.02 × 8 / 4 = 每 8 小时 0.04%。再看一个按小时结算的假设示例:交易所 A 每小时支付 0.004%,交易所 B 每 8 小时支付 0.02%。按原始数字看,A 只有 B 的五分之一,但 8 小时合计为 0.004 × 8 / 1 = 0.032%,对比 0.02%,是后者的 1.6 倍。
换算的前提是费率在整个周期内保持不变,而按小时结算的费率在下一次结算时就可能变化。只有历史数据才能显示实际支付了多少。
APR 由 8 小时费率计算:每天三次结算,每年 1,095 次。对交易所 A 来说,在费率不变的前提下,是 0.032 × 3 × 365 = 年化 35.04%。
交易所的资金费率 API:Binance、Bybit、OKX 和 Hyperliquid
每家主要交易所都有自己的资金费率 API:路径、字段和表示间隔的方式各不相同。
| 交易所 | 当前费率 | 历史 | 间隔 |
|---|---|---|---|
| Binance | GET /fapi/v1/premiumIndex | GET /fapi/v1/fundingRate | GET /fapi/v1/fundingInfo |
| Bybit | GET /v5/market/tickers | GET /v5/market/funding/history | fundingIntervalHour 字段 |
| OKX | GET /api/v5/public/funding-rate | GET /api/v5/public/funding-rate-history | 由 fundingTime 和 nextFundingTime 推算 |
| Hyperliquid | POST /info,metaAndAssetCtxs | POST /info,fundingHistory | 每小时 |
Binance 资金费率 API 在 premiumIndex 的 lastFundingRate 和 nextFundingTime 字段中返回费率和下次结算时间(Binance 文档),Binance 的历史资金费率来自 fundingRate,它接受 startTime 和 endTime(资金费率历史)。fundingInfo 只返回交易所调整过间隔或费率上限的合约的间隔(endpoint 说明)。
Bybit 在带 category=linear 的一次 tickers 响应中返回 fundingRate、nextFundingTime 和 fundingIntervalHour(Bybit tickers),其历史请求必须带 symbol(Bybit 资金费率历史)。正如文档所指出的,每个合约都有自己的间隔。
对于 OKX,文档建议用 nextFundingTime 与 fundingTime 的差值推算合约的间隔(OKX 文档)。
Hyperliquid 的所有数据查询都发往 POST https://api.hyperliquid.xyz/info,由 JSON 请求体决定返回什么:{"type": "metaAndAssetCtxs"} 返回每个资产当前的 funding,{"type": "fundingHistory", "coin": "ETH", "startTime": …} 返回费率历史(Hyperliquid 文档)。
要把这些交易所合并到一张表里,你的代码需要:
- 把费率从小数换算为百分比;
- 找出每个合约的间隔,并把费率换算为 8 小时;
- 把毫秒时间戳转换过来,并映射交易对代码:
BTCUSDT、BTC-USDT-SWAP、BTC,小币种还有1000PEPE这类倍数; - 遵守各交易所的 rate limit,并在交易所改动 API 时更新代码。
所有交易所一次请求:/funding/rates
GET /funding/rates 为每个币种返回带有当前费率的交易所列表:Binance、OKX、Bybit、Bitget、MEXC、Gate、BingX、HTX、Hyperliquid,以及 Genesis Arbitrage 覆盖的其他交易所,共 1000 多个币种。coin 和 exchange 过滤参数(多个交易所用逗号分隔)是可选的;不带参数则返回完整数据集。
curl --compressed \
"https://api.genesisarbitrage.com/v1/funding/rates?coin=TON" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "TON",
"exchanges": [
{
"exchange": "MEXC",
"funding_pct": 0.02,
"funding_8h_pct": 0.04,
"next_payout": "00:00",
"interval": "4h",
"price": 2.184,
"trade_url": "https://futures.mexc.com/exchange/TON_USDT"
}
]
}
这是所有 Genesis API 响应共用的封装(success、data、meta)中 data 数组的一个元素。费率以百分比表示,next_payout 是结算时间,格式为 HH:MM UTC,空值为 null,Hyperliquid 显示为 Hyper。所有字段和 Try it 表单见资金费率文档章节。
/funding/rates 和 /funding/spread 在所有套餐中都有,最低的 Trial 为每月 20 美元:50 万次调用、每秒 1 次请求、数据新鲜度 60 秒(Genesis API 价格)。
资金费率价差:/funding/spread
资金费率价差是指把费率换算为 8 小时后,同一币种在各交易所之间最高费率与最低费率的差。空头开在费率较高的一边,多头开在费率较低的一边:空头收取其交易所的费率,多头支付自己交易所的费率(该费率为负时则是收取),剩下的就是两者之差。
GET /funding/spread 为每个币种在 best 中返回最佳交易所组合:exchange_1 和 exchange_2,它们各自按自己间隔计的费率(funding_1_pct、funding_2_pct)、间隔、结算时间和终端链接。该组合的价差在 spread_pct 中,其他交易所在 others 中,过滤参数为 coin 和 min_spread(资金费率价差文档)。一个组合的两个间隔往往不同,比如文档示例中 BTC 的 1h 和 8h,所以只有换算为 8 小时之后,才能手动比较该组合的费率。
Python:年化后的前 10 个资金费率价差
脚本取完整的 /funding/rates 数据集,为每个币种找出 funding_8h_pct 最高和最低的交易所:两者之差就是 8 小时价差,按价差 × 3 × 365 年化。遇到 429 和 503 时,它会等待 Retry-After 秒,但最多一分钟:月度配额用完后,Retry-After 会一直持续到配额重置。
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/rates"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch_rates():
for _ in range(3):
r = requests.get(URL, headers=HEADERS, timeout=20)
if r.status_code not in (429, 503):
r.raise_for_status()
return r.json()["data"]
# 429 or 503: wait Retry-After, but no longer than a minute
time.sleep(min(int(r.headers.get("Retry-After", "5")), 60))
raise RuntimeError("API did not respond after three attempts")
rows = []
for item in fetch_rates():
ex = [e for e in item["exchanges"]
if e["funding_8h_pct"] is not None]
if len(ex) < 2:
continue
short = max(ex, key=lambda e: e["funding_8h_pct"]) # short leg
long_ = min(ex, key=lambda e: e["funding_8h_pct"]) # long leg
spread = short["funding_8h_pct"] - long_["funding_8h_pct"]
rows.append((spread, item["coin"], short, long_))
rows.sort(key=lambda x: x[0], reverse=True)
for spread, coin, short, long_ in rows[:10]:
apr = spread * 3 * 365 # simple APR on one leg's notional
print(f"{coin:<10} short {short['exchange']:<8} "
f"long {long_['exchange']:<8} {spread:.4f}% per 8h "
f"APR {apr:.1f}%, on capital {apr / 2:.1f}%")
这里的年化数字是按单边名义价值计算的。两条腿都需要资金,所以按无杠杆的总资金计算,收益只有一半,就像分析数据中的 apr_capital 字段那样。假设示例:在一家交易所做空,费率为每 8 小时 0.05%;在另一家做多,费率为 0.01%。价差为 0.05 − 0.01 = 0.04%,年化为 0.04 × 3 × 365 = 每条腿 43.8%,按总资金计为 21.9%。
手续费未计入。假设示例:四笔交易(两条腿各开仓和平仓一次)每笔 0.05% 的 taker 手续费,合计为 4 × 0.05 = 单边名义价值的 0.2%。如果费率保持不变,0.04% 的价差需要 0.2 / 0.04 = 5 次结算,即 40 小时才能赚回这笔费用。
只有返回 200 的响应才计入配额。在监控程序中,轮询间隔不要短于每 meta.freshness_sec 秒一次,并在 If-None-Match 中带上上一次的 ETag:完整数据集未变化时会返回不计费的 304。更多内容见限制指南,以及用 Python 构建价差和资金费率监控的加密货币 API 课程第 4 课。
已结算资金费率历史:/funding/analytics/*
当前费率显示的是下一次结算;历史显示的是实际支付了多少。它来自四个分析 endpoint:13 家交易所,费率为每个结算周期的百分比,时间戳为 UTC 的 epoch 秒。它们在 Pro(每月 100 美元)和 Max(200 美元)套餐中;Trial 和 Start 会收到 403 plan_restricted。
| Endpoint | 内容 | 完整数据 |
|---|---|---|
/funding/analytics/summary | 7 个周期(从 1 天到一年)的合计、平均 8 小时费率、APR 和覆盖率 | 约 600 KB gzip |
/funding/analytics/recent | 最近 7 天的每一次结算 | 约 1 MB gzip |
/funding/analytics/daily | 365 天的每日合计 | 最高约 12 MB gzip |
/funding/analytics/top | 每个周期前 50 个币种×交易所组合和前 50 个多空组合 | — |
不带 coin 的完整下载有限制:summary 和 recent 每个 key 每 60 秒一次,daily 每 300 秒一次;窗口结束前发出的请求会收到带 Retry-After 的 429。coin 切片和 304 响应不受限制,所以像这样获取某个币种的历史:
curl --compressed -G \
"https://api.genesisarbitrage.com/v1/funding/analytics/summary" \
-d coin=BTC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
在 summary 中,每个币种×交易所组合都带有间隔 interval_h、数据起点 data_since、用于「当前与常态」对比的最新 8 小时费率 last8h,以及每个周期 14 项指标的 m 数组:sum、avg8h、apr、cov、flips 等。文档示例:Binance 上的 BTC,7 天内 21 次正结算,avg8h 为 0.006298%,apr 为 0.006298 × 3 × 365 ≈ 6.896%。m、recent 和 daily 的解析方法见资金费率 endpoint 指南,字段说明见资金费率分析文档章节。
top 组合筛选器
/funding/analytics/top 是一个无需参数的现成筛选器。其中组合的两条腿始终在不同的交易所,覆盖率至少为 0.9,net ≤ 0 的组合不会进入列表。
gross 是该组合在周期内的资金费率总收益,fees 是 taker_fees 表中四笔交易的手续费,net = gross − fees。apr_net 按单边名义价值年化,apr_capital 是它的一半,按两条腿的总资金计算。win_rate 是盈利天数的占比,max_dd 是最大回撤,price_div 是两条腿当前的价差,net 不包含它。
在文档示例中,PEPE 组合(在 HTX 做空,在 Hyperliquid 以 1000PEPE 代码做多)7 天内的 gross 为 1.51504%,fees 为 0.19。所以 net = 1.51504 − 0.19 = 1.32504%,apr_net 为 69.09%,apr_capital 为 34.55%。现成的列表有:按净收益排序的 by_net_apr、适合稳定组合的 by_stable,以及当前正在产生收益的 by_live。
作为市场指标的资金费率
费率为正时,使用杠杆的多头向空头支付;为负时则相反。小幅为正的费率是正常的(Hyperliquid 将利率部分固定为每 8 小时 0.01%),当费率明显偏离其常态水平时,它才成为信号。
高费率要与持仓量一起看:两者同时攀升,说明大量杠杆仓位堆积在同一侧,一旦行情反向,就会引发强平连锁反应。/market/open-interest 按交易所返回持仓量(文档章节)。更多内容见作为市场指标的资金费率。
资金费率套利的风险
跨两家交易所的多空组合几乎不依赖价格,但仍然可能亏钱:
- 费率在结算前会变化,甚至可能反转正负号,只有在结算时刻持有的仓位才会收付;
- 两条腿的价格出现偏离:如果空头所在交易所的价格低于多头所在交易所,入场就先亏一笔,所以要查看
price或price_div; - 手续费和滑点:共有四笔交易,在订单簿较薄时,入场成本比表中显示的更高;
- 其中一条腿被强平:保证金不会在交易所之间转移,强平以标记价格触发;
- 交易所可能修改合约的间隔或费率上限;在 Binance,这类合约由
fundingInfo列出。
不写代码时,同样的费率也可以在资金费率套利表(指南)中看到,价差计算器会连同手续费一起算出组合收益,加密货币 API 概览则从整体上比较各类行情数据 API。
常见问题
在哪里可以获取历史资金费率?
各交易所以自己的格式保存历史:Binance 用 GET /fapi/v1/fundingRate,Bybit 用 GET /v5/market/funding/history,Hyperliquid 用 fundingHistory 类型。Genesis API 以统一格式返回 13 家交易所的历史:/funding/analytics/recent 提供 7 天的结算记录,/funding/analytics/daily 提供一年的每日合计,/funding/analytics/summary 提供各周期的合计,适用于 Pro 和 Max 套餐。
为什么各交易所的资金费率不同?
每家交易所都有自己的交易者、流动性、费率公式和上限,所以仓位失衡的累积方式不同。间隔也不同:CEX 为 8 或 4 小时,Hyperliquid 为每小时。先把费率换算到同一个周期再比较;在 Genesis API 中就是 funding_8h_pct 字段。
API 中的资金费率多久更新一次?
交易所上的当前费率在结算前会不断变化;已结算的费率会被固定并进入历史。Genesis API 的数据新鲜度在 Trial 为 60 秒,Start 为 30 秒,Pro 为 10 秒,Max 为 5 秒;分析 summary 的 ETag 大约每 15 分钟变化一次,每日合计每小时重建一次。
有免费的资金费率 API 吗?
Genesis API 没有免费套餐:资金费率和价差包含在每月 20 美元的 Trial 中,历史数据在 100 美元的 Pro 和 200 美元的 Max 中。在网站上,资金费率和价差无需套餐即可在资金费率套利中查看。