Genesis API 文档

接入所需的一切:认证、限额、接口和响应结构。

文档资金费率分析

资金费率分析

TrialStartProMax

13 家交易所的历史已结算资金费率分析——包含四个接口的分区。所有费率均为每个结算周期的百分比,时间戳为 UTC 的 epoch 秒。Pro 和 Max 可用;其他套餐返回 403 plan_restricted。完整分区体积较大——请使用 coin 参数和 If-None-Match 请求头(ETag 随 generated_at 变化)。不带 coin 下载完整分区有限制:summary 和 recent 每个密钥每 60 秒一次,daily 每 300 秒一次;304 响应和带 coin 的请求不受限。

在线试用
GET/v1/funding/analytics/summary

密钥仅保存在你的浏览器中,除 API 外不会发送到任何地方。

粘贴你的密钥并发送请求——我们会显示截断后的响应。

分析:汇总

每个币种×交易所组合的历史已结算资金费率汇总:从 1 天到一年共 7 个周期的累计总额、平均 8h 费率、APR 和覆盖率。Pro 和 Max 可用。完整分区约 600 KB gzip——查询单个币种请使用 coin 参数;轮询时请传入 If-None-Match(ETag 约每 15 分钟变化一次)。

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/summary

查询参数

参数类型说明
coinstring仅返回单个币种的切片(推荐:完整分区体积较大)

响应示例

json
{
  "success": true,
  "data": {
    "schema_version": 1,
    "units": "percent",
    "generated_at": 1785546602,
    "metric_order": ["sum","avg8h","apr","n","pos","neg","zero","min","max","cov",
                     "med8h","pos_streak","neg_streak","flips"],
    "periods": ["1d","3d","7d","30d","90d","180d","365d"],
    "coins": {
      "BTC": {
        "canon": "BTC",
        "mult": 1,
        "exchanges": {
          "Binance": {
            "raw_symbol": "BTCUSDT",
            "interval_h": 8.0,
            "data_since": 1568102400,
            "last8h": 0.004123,
            "m": {
              "7d": [0.12802, 0.006298, 6.896, 21, 21, 0, 0, 0.000125, 0.01, 1.0,
                     0.00588, 7, 0, 0]
            }
          }
        }
      }
    }
  },
  "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}

响应字段

字段类型说明
metric_orderstring[]m 数组内的指标顺序:sum, avg8h, apr, n, pos, neg, zero, min, max, cov
periodsstring[]可用周期 1d…365d;若完全没有数据,m 中不含该周期
coins.{c}.canon / multstring / number用于合并不同写法(1000PEPE→PEPE)的规范币种名称和合约乘数;mult 绝不作用于费率
…exchanges.{ex}.interval_hnumber结算间隔,单位小时:CEX 为 8/4,Hyper 和 Lighter 为 1
…exchanges.{ex}.data_sincenumber数据起始时间(epoch 秒);请勿在此日期之前绘制零值
…exchanges.{ex}.last8hnumber | null按 8h 换算的最新实际费率——用于“当前与常态”对比
…exchanges.{ex}.m.{period}(number | null)[14]按 metric_order 排列的周期指标数组(14 个字段:sum, avg8h, apr, n, pos, neg, zero, min, max, cov, med8h, pos_streak, neg_streak, flips);1d 和 3d 周期的索引 10–13 为 null
m[9] (cov)number 0..1周期覆盖率 0..1;低于 0.9 表示数据只覆盖该周期的一部分——请在界面中标注

分析:7 天结算

最近 7 天的每一笔资金费率结算,用于 1D/3D/7D 图表。费率为每个结算周期的百分比,时间戳为 UTC 的 epoch 秒。Pro 和 Max;完整分区约 1 MB gzip——建议使用 coin。

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/recent

查询参数

参数类型说明
coinstring仅返回单个币种的切片(推荐:完整分区体积较大)

响应示例

json
{
  "success": true,
  "data": {
    "units": "percent",
    "generated_at": 1785546602,
    "days": 7,
    "coins": {
      "BTC": {
        "Lighter": { "i": 1.0, "s": "1784941200:0.0012;1784944800:0.001;1784948400:0.0002" }
      }
    }
  },
  "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}

响应字段

字段类型说明
daysnumber分区的数据深度,单位天
coins.{c}.{ex}.inumber结算间隔,单位小时:CEX 为 8/4,Hyper 和 Lighter 为 1
coins.{c}.{ex}.sstring点字符串 ts:rate;ts:rate;…,按时间升序;ts 为 epoch 秒

分析:1 年每日

365 天的每日资金费率总额,用于 1M/3M/1Y 图表。历史数据积累满后分区会很大(约 12 MB gzip)——请使用 coin 和 If-None-Match;每小时重新生成。

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/daily

查询参数

参数类型说明
coinstring仅返回单个币种的切片(推荐:完整分区体积较大)

响应示例

json
{
  "success": true,
  "data": {
    "units": "percent",
    "generated_at": 1785546602,
    "days": 365,
    "coins": {
      "BTC": { "OKX": "1784937600:0.0027:1:1;1785024000:0.008:3:0" }
    }
  },
  "meta": { "count": 1710, "updated_at": 1785546602, "schema_version": 1 }
}

响应字段

字段类型说明
daysnumber分区的数据深度,单位天
coins.{c}.{ex}string日字符串 day_ts:sum:pos:neg;…——UTC 零点、当日总额、正向和负向结算次数

分析:筛选器

现成的筛选器:每个周期按累计资金费率排序的前 50 个币种×交易所组合,以及前 50 个交易所组合(short/long)。组合的两条腿始终在不同交易所,且覆盖率 ≥0.9。gross 为扣费前,net 为扣除四笔交易的 taker 手续费后;两条腿之间的价差未计入。Pro 和 Max。

GEThttps://api.genesisarbitrage.com/v1/funding/analytics/top

响应示例

json
{
  "success": true,
  "data": {
    "schema_version": 1,
    "units": "percent",
    "generated_at": 1785545651,
    "taker_fees": { "Binance": 0.05, "Bybit": 0.055, "HTX": 0.05, "Hyper": 0.045, "Lighter": 0.0 },
    "periods": {
      "7d": {
        "by_net_apr": [
          {
            "coin": "PEPE",
            "short_ex": "HTX",   "short_sym": "PEPE",     "short_iv": 8.0,
            "long_ex":  "Hyper", "long_sym":  "1000PEPE", "long_iv":  1.0,
            "gross": 1.51504, "fees": 0.19, "net": 1.32504,
            "apr_net": 69.09, "apr_capital": 34.55,
            "win_rate": 1.0, "max_dd": 0.0, "worst_streak": 0, "risk_days": 7,
            "trend_1d": 0.0471, "trend_7d": 1.515,
            "live_8h": 0.012, "price_div": 0.11, "cov": 1.0
          }
        ],
        "by_stable": [ { "...": "same shape, win_rate >= 0.7" } ],
        "by_live":   [ { "...": "same shape, live_8h > 0 and trend_1d > 0" } ],
        "by_sum_pos": [
          { "coin": "AAOI", "canon": "AAOI", "ex": "Lighter",
            "sum": 11.5165, "apr": 600.5, "cov": 1.0,
            "med8h": 0.062, "pos_streak": 7, "neg_streak": 0, "flips": 0,
            "iv": 1.0, "last8h": 0.058 }
        ],
        "by_sum_neg": [ { "...": "same shape as by_sum_pos" } ]
      }
    }
  },
  "meta": { "count": 7, "updated_at": 1785545651, "schema_version": 1 }
}

响应字段

字段类型说明
taker_feesobject计算手续费时使用的 taker 费率表
periods.{p}.by_net_apr / by_stable / by_livearrayby_net_apr——按净收益排序;by_stable——win_rate ≥ 0.7 且回撤 ≤ 总收益的一半;by_live——live_8h > 0 且 trend_1d > 0;by_sum_pos / by_sum_neg——单交易所榜单
bundle.gross / fees / netnumbernet = gross − fees:扣除四笔交易手续费后该组合的结果;net ≤ 0 的行不会出现在列表中
bundle.apr_net / apr_capitalnumberapr_net——按单条腿的名义价值年化;apr_capital = apr_net / 2——按投入资金年化(两条腿都需要占用资金)
bundle.win_rate / max_dd / worst_streak / risk_daysnumberwin_rate——盈利天数占比(0..1),max_dd——累计曲线的最大回撤,worst_streak——最长连续亏损天数,risk_days——风险统计所用的天数(最多 90)
bundle.live_8h / trend_1d / trend_7d / price_divnumber | nulllive_8h——按 8h 换算的当前费率差;trend_1d / trend_7d——最近一天和一周的未扣费价差;price_div——当前合约价格偏离(价格不可用时为 null)
bundle.short_sym / long_symstring各交易所上的实际腿部代码——可能不同(PEPE 与 1000PEPE)
periods.{p}.by_sum_pos / by_sum_negarray按累计资金费率排序的前 50 名(仅 cov ≥ 0.5)