Genesis Arbitrage

Genesis Arbitrage · · 阅读约 22 分钟

资金费率 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:路径、字段和表示间隔的方式各不相同。

交易所当前费率历史间隔
BinanceGET /fapi/v1/premiumIndexGET /fapi/v1/fundingRateGET /fapi/v1/fundingInfo
BybitGET /v5/market/tickersGET /v5/market/funding/historyfundingIntervalHour 字段
OKXGET /api/v5/public/funding-rateGET /api/v5/public/funding-rate-history由 fundingTime 和 nextFundingTime 推算
HyperliquidPOST /info,metaAndAssetCtxsPOST /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 文档)。

要把这些交易所合并到一张表里,你的代码需要:

所有交易所一次请求:/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/summary7 个周期(从 1 天到一年)的合计、平均 8 小时费率、APR 和覆盖率约 600 KB gzip
/funding/analytics/recent最近 7 天的每一次结算约 1 MB gzip
/funding/analytics/daily365 天的每日合计最高约 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 按交易所返回持仓量(文档章节)。更多内容见作为市场指标的资金费率。

资金费率套利的风险

跨两家交易所的多空组合几乎不依赖价格,但仍然可能亏钱:

不写代码时,同样的费率也可以在资金费率套利表(指南)中看到,价差计算器会连同手续费一起算出组合收益,加密货币 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 中。在网站上,资金费率和价差无需套餐即可在资金费率套利中查看。