Genesis API 文档
接入所需的一切:认证、限额、接口和响应结构。
资金费率分析
13 家交易所的历史已结算资金费率分析——包含四个接口的分区。所有费率均为每个结算周期的百分比,时间戳为 UTC 的 epoch 秒。Pro 和 Max 可用;其他套餐返回 403 plan_restricted。完整分区体积较大——请使用 coin 参数和 If-None-Match 请求头(ETag 随 generated_at 变化)。不带 coin 下载完整分区有限制:summary 和 recent 每个密钥每 60 秒一次,daily 每 300 秒一次;304 响应和带 coin 的请求不受限。
/v1/funding/analytics/summary密钥仅保存在你的浏览器中,除 API 外不会发送到任何地方。
粘贴你的密钥并发送请求——我们会显示截断后的响应。
分析:汇总
每个币种×交易所组合的历史已结算资金费率汇总:从 1 天到一年共 7 个周期的累计总额、平均 8h 费率、APR 和覆盖率。Pro 和 Max 可用。完整分区约 600 KB gzip——查询单个币种请使用 coin 参数;轮询时请传入 If-None-Match(ETag 约每 15 分钟变化一次)。
https://api.genesisarbitrage.com/v1/funding/analytics/summary查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
coin | string | 仅返回单个币种的切片(推荐:完整分区体积较大) |
响应示例
{
"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_order | string[] | m 数组内的指标顺序:sum, avg8h, apr, n, pos, neg, zero, min, max, cov |
periods | string[] | 可用周期 1d…365d;若完全没有数据,m 中不含该周期 |
coins.{c}.canon / mult | string / number | 用于合并不同写法(1000PEPE→PEPE)的规范币种名称和合约乘数;mult 绝不作用于费率 |
…exchanges.{ex}.interval_h | number | 结算间隔,单位小时:CEX 为 8/4,Hyper 和 Lighter 为 1 |
…exchanges.{ex}.data_since | number | 数据起始时间(epoch 秒);请勿在此日期之前绘制零值 |
…exchanges.{ex}.last8h | number | 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。
https://api.genesisarbitrage.com/v1/funding/analytics/recent查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
coin | string | 仅返回单个币种的切片(推荐:完整分区体积较大) |
响应示例
{
"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 }
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
days | number | 分区的数据深度,单位天 |
coins.{c}.{ex}.i | number | 结算间隔,单位小时:CEX 为 8/4,Hyper 和 Lighter 为 1 |
coins.{c}.{ex}.s | string | 点字符串 ts:rate;ts:rate;…,按时间升序;ts 为 epoch 秒 |
分析:1 年每日
365 天的每日资金费率总额,用于 1M/3M/1Y 图表。历史数据积累满后分区会很大(约 12 MB gzip)——请使用 coin 和 If-None-Match;每小时重新生成。
https://api.genesisarbitrage.com/v1/funding/analytics/daily查询参数
| 参数 | 类型 | 说明 |
|---|---|---|
coin | string | 仅返回单个币种的切片(推荐:完整分区体积较大) |
响应示例
{
"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 }
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
days | number | 分区的数据深度,单位天 |
coins.{c}.{ex} | string | 日字符串 day_ts:sum:pos:neg;…——UTC 零点、当日总额、正向和负向结算次数 |
分析:筛选器
现成的筛选器:每个周期按累计资金费率排序的前 50 个币种×交易所组合,以及前 50 个交易所组合(short/long)。组合的两条腿始终在不同交易所,且覆盖率 ≥0.9。gross 为扣费前,net 为扣除四笔交易的 taker 手续费后;两条腿之间的价差未计入。Pro 和 Max。
https://api.genesisarbitrage.com/v1/funding/analytics/top响应示例
{
"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_fees | object | 计算手续费时使用的 taker 费率表 |
periods.{p}.by_net_apr / by_stable / by_live | array | by_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 / net | number | net = gross − fees:扣除四笔交易手续费后该组合的结果;net ≤ 0 的行不会出现在列表中 |
bundle.apr_net / apr_capital | number | apr_net——按单条腿的名义价值年化;apr_capital = apr_net / 2——按投入资金年化(两条腿都需要占用资金) |
bundle.win_rate / max_dd / worst_streak / risk_days | number | win_rate——盈利天数占比(0..1),max_dd——累计曲线的最大回撤,worst_streak——最长连续亏损天数,risk_days——风险统计所用的天数(最多 90) |
bundle.live_8h / trend_1d / trend_7d / price_div | number | null | live_8h——按 8h 换算的当前费率差;trend_1d / trend_7d——最近一天和一周的未扣费价差;price_div——当前合约价格偏离(价格不可用时为 null) |
bundle.short_sym / long_sym | string | 各交易所上的实际腿部代码——可能不同(PEPE 与 1000PEPE) |
periods.{p}.by_sum_pos / by_sum_neg | array | 按累计资金费率排序的前 50 名(仅 cov ≥ 0.5) |