Genesis Arbitrage

Genesis Arbitrage · · 阅读约 17 分钟

套利所需的 API 数据:价差、订单簿与资金费率

简而言之

  • 交易者的每个问题都有对应的端点:价差是 /arbitrage/* 中的 spread_pct,转币看充提开关以及 network 和 contract,按你的资金量计算成交看 /orderbooks/*,资金费率情形看 /funding/*。
  • 行内价差由最新成交价算出。示例中,2,500 美元对应的 1.5% 在遍历订单簿后降至 0.72%,再扣除两笔 0.1% 的 taker 手续费后约为 0.52%,即约 13 美元。
  • 每个响应都带有自己的时间:meta.updated_at 是快照生成的时刻,meta.freshness_sec 是你所在套餐的刷新步长,age_sec 和 stale 表示订单簿的年龄。
  • 一个交易对要过四个检查点:价差、转币、订单簿和新鲜度。任何一项不通过,就取消入场。
  • CEX 套利、资金费率和持仓量在每个 Genesis API 套餐中都有,链上板块从 Start 起提供,订单簿和 DEX 数据随 Pro 和 Max 提供。

加密货币套利数据回答五个问题:有没有价差,能不能转币,订单簿够不够深、能否承载你的资金量,资金费率是否有收益,以及大户在做什么。在 Genesis API 中,每个问题都有自己的端点和几个响应字段。第一次请求以及 success、data、meta 外层结构已在第 2 课讲过;本课讲应该读哪些字段、按什么顺序读。

交易者的问题 → 端点 → 字段

问题端点字段
有没有价差/arbitrage/*spread_pct、price_buy、price_sell
能不能转币同一行 /arbitrage/spot-spotwithdraw_enabled_buy、deposit_enabled_sell、network、contract
订单簿够不够深/orderbooks/*order_delta.spread_pct、order_delta.status
资金费率是否有收益/funding/*spread_pct、interval_1、interval_2、next_payout_1
大户在做什么/onchain/*、/market/open-interestdirection、total_usd、oi_change_1h

星号表示一组端点:/arbitrage/* 包含七个端点,从 Spot – Spot 到股票,而 /orderbooks/* 和 /funding/* 各包含六个。下面的各节按检查一个交易对的顺序展开。

有没有价差:spread_pct

来自 Spot — Spot 文档的一行:FUEL,在 ByBit 以 0.0007029 买入,在 Gate 以 0.0007037 卖出,spread_pct 为 0.11。验算:(0.0007037 − 0.0007029) / 0.0007029 × 100 ≈ 0.11%。行内价差由 price_buy 和 price_sell 算出,即最新成交价;在网站上这是“价格”列。

在 DEX – Spot 和 DEX – Futures 数据集中,正负号很重要:正号表示代币在 DEX 上更便宜,负号表示更贵。七个数据集的参数和字段见套利端点指南。

spread_pct 只回答第一个问题:其中不含手续费、转币和订单簿。

能不能转币:充值、提现、网络与合约

跨交易所的现货交易对需要转币:在一家交易所买入币,提出后再充入另一家。因此行内有两个需要读取的开关:withdraw_enabled_buy 表示买入所在的交易所是否开放提现,deposit_enabled_sell 表示卖出所在的交易所是否开放充值。请求中没有针对它们的参数,需要你的代码自行过滤行。

network 和 contract 告诉你是不是同一个代币。不同的币可能在不同交易所使用同一个代码交易,所以要把合约地址与两家交易所的提现和充值页面对照。某个币在各网络上的合约,以及使用每个合约的交易所,可在任意套餐中通过 /coins/search 获得(Coin Search)。

在 DEX 数据集中,开关属于 CEX 一侧:deposit_enabled 和 withdraw_enabled。在 Cross-chain 中,代币通过跨链桥在 buy.chain 和 sell.chain 两个网络之间转移,因此没有交易所开关。

订单簿够不够深:行内价差与成交后价差

市价单会遍历订单簿:买入从最优卖价起向上吃卖单,卖出向下吃买单。资金量越大,平均成交价越差,行内价差剩下的就越少。订单簿 Δ,即 Pro 和 Max 套餐中的 /orderbooks/spreads/{dataset},会返回按你的资金量算出的剩余价差(文档)。

示例(仅作说明):币种 LMN,在 OKX 以 0.4000 买入,在 Bitget 以 0.4060 卖出。行内价差:(0.4060 − 0.4000) / 0.4000 × 100 = 1.5%。用不同的 volume 值请求 coin=LMN 的 /orderbooks/spreads/spot-spot:

资金量买入 → 卖出订单簿 Δ折合美元
00.4002 → 0.40581.3993%—
500 美元0.4004 → 0.40551.2737%6.37 美元
2,500 美元0.4012 → 0.40410.7228%18.07 美元
10,000 美元—exhausted—

volume=0 使用 OKX 的最优卖价和 Bitget 的最优买价:最优挂单比最新成交价更差,因此即使在最小资金量下也会损失 0.1 个百分点。在 2,500 美元时,平均买入价为 0.4012,平均卖出价为 0.4041:(0.4041 − 0.4012) / 0.4012 × 100 ≈ 0.7228%。在 10,000 美元时,Bitget 的买单被吃光,order_delta.status 为 exhausted。

每家交易所都收取 taker 手续费;示例按 0.1% 计(maker 与 taker)。在 2,500 美元时,你保留 0.7228 − 2 × 0.1 = 0.5228%,即 2,500 × 0.5228 / 100 ≈ 13.07 美元。提现手续费不在响应中:请到交易所的提现页面查看,并单独扣除。

在 Trial 和 Start 套餐中,订单簿端点返回 403 plan_restricted,因此需要在交易所终端查看订单簿。成交价和滑点在加密货币订单簿 API中讲解,六个端点全部见订单簿端点指南。

资金费率是否有收益:价差、间隔与结算

资金费率套利就是在资金费率较高的一侧做空、较低的一侧做多:价格波动对结果几乎没有影响,累积的是费率之差。候选在任意套餐中都可通过 /funding/spread 获得:最佳交易所组合在 best 中,并带有其 spread_pct(Funding spread)。

交易对价差并不告诉你何时、多久结算一次。interval_1 和 interval_2 是两家交易所的资金费率间隔,next_payout_1 和 next_payout_2 是下一次结算的 UTC 时间:只有在结算时刻持有的仓位才会收到资金费用。间隔不同的费率要先归一化到 8 小时再比较,对应 /funding/rates 中的 funding_8h_pct 字段。

示例(仅作说明):每 8 小时价差为 0.03%,每条腿的仓位为 5,000 美元。一次结算带来 5,000 × 0.03 / 100 = 1.5 美元。四笔交易,即两条腿各开仓和平仓,在 0.1% 的 taker 手续费下成本为 4 × 5,000 × 0.1 / 100 = 20 美元。手续费在 20 / 1.5 ≈ 13.3 次结算后回本:即 14 次八小时结算,将近五天,前提是费率保持不变。

历史数据能说明价差是否持续:在 Pro 和 Max 中,带 coin 的 /funding/analytics/summary 会针对每家交易所、每个周期返回 sum(累计资金费用)、cov(覆盖率)和 flips(正负号翻转次数)。详情见资金费率 API 和资金费率端点指南。

大户在做什么:链上数据与持仓量

链上数据和持仓量可以解释为什么一个交易对会在你执行之前就关闭。流入卖出交易所的币,意味着有卖家会先于你的转账到达。持仓量上升意味着新的杠杆仓位,一旦出现逆向的剧烈波动就会触发清算。

你看到什么请求字段套餐
币流入和流出交易所/onchain/coin-trafficdirection、target、total_usdStart、Pro、Max
代币解锁/onchain/unlocksunlock_value_usd、hours_leftStart、Pro、Max
各交易所持仓量/market/open-interestoi_usd、oi_change_1h、price_change_1h全部

Genesis Onchain 文档中的示例响应显示,5.69 小时内有 18 笔 LAB 转入 Gate,价值 573,796.98 美元,direction 为 deposit。如果此时 LAB 在 Gate 上有卖出一侧的交易对,这样的流入就是缩小资金量或放弃入场的理由。更多内容见链上数据 API 和持仓量 API。

数据新鲜度与时间戳

每个响应都带有自己的时间:meta.updated_at 是快照生成的 unix 时间,meta.freshness_sec 是你所在套餐的刷新步长:Trial 为 60 秒,Start 为 30 秒,Pro 为 10 秒,Max 为 5 秒。快照的年龄就是当前时间减去 updated_at(数据新鲜度)。

示例(仅作说明):Trial 套餐,响应在 1783802455 到达,updated_at 为 1783802410。快照的年龄为 1783802455 − 1783802410 = 45 秒:其中的交易对由近一分钟前的价格算出,有些在交易所里可能已经消失。

订单簿有自己的时钟:在 /orderbooks/book 和 /orderbooks/coin/{coin} 中,每个订单簿都有 book_ts、age_sec(年龄,单位为秒),超过 30 秒则带 stale: true。订单簿比交易所滞后 5–20 秒,所以要检查两条腿的年龄:新订单簿与旧订单簿之间的价差,可能只是时间差。

为什么一个字段不够:四点检查

每个字段只关闭一个问题,只有全部关闭后才能入场。3% 的价差但提现关闭,币会卡在买入交易所。出现 exhausted,你的资金量无法成交。快照已有 50 秒时,这个交易对可能早已消失。

检查点字段交易对在以下情况被淘汰
1. 价差spread_pct价差减去两笔手续费后低于阈值
2. 转币withdraw_enabled_buy、deposit_enabled_sell、contract提现或充值关闭,或合约不一致
3. 订单簿order_delta.status、order_delta.spread_pct状态不是 ok,或剩余价差低于阈值
4. 新鲜度meta.updated_at、age_sec、stale快照或某个订单簿比阈值更旧

该函数接收 /arbitrage/spot-spot 的一行 data、同一交易所组合的 order_delta 对象(Trial 和 Start 中为 None)以及响应的 meta。阈值仅作说明:请按你的手续费和套餐调整。

import time

FEE = 0.1      # 假定每条腿的 taker 手续费,%
MIN_NET = 0.3  # 扣除手续费后至少剩 0.3%
MAX_AGE = 60   # 快照不得超过 60 秒


def check(row, od, meta):
    """Spot – Spot 交易对未通过的检查点。"""
    fails = []
    if row["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("1: 价差不足以覆盖手续费")
    if not row["withdraw_enabled_buy"]:
        fails.append("2: 买入交易所提现关闭")
    if not row["deposit_enabled_sell"]:
        fails.append("2: 卖出交易所充值关闭")
    if od is None:
        fails.append("3: 未检查订单簿(Trial 或 Start)")
    elif od["status"] != "ok":
        fails.append("3: 订单簿 — " + od["status"])
    elif od["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("3: 扣除订单簿影响后剩余太少")
    if time.time() - meta["updated_at"] > MAX_AGE:
        fails.append("4: 快照超过 MAX_AGE 秒")
    return fails

空列表表示交易对通过了全部四个检查点。2,500 美元的 LMN 交易对可以通过:行内 1.5 − 0.2 = 1.3%,订单簿之后 0.7228 − 0.2 = 0.5228%,快照为 45 秒。在 10,000 美元时,函数返回“3: 订单簿 — exhausted”。代码无法核验合约:地址要你到交易所的提现和充值页面自行核对,两条腿订单簿的年龄来自 /orderbooks/book。

在网站表格上不写代码做同样的检查,见课程价差、深度、成交量——读懂表格,循环轮询 API 见第 4 课。

哪个套餐提供哪些数据

套餐新鲜度套利数据
Trial,每月 20 美元60 秒Spot – Spot、Spot – Futures、Futures – Futures、资金费率与价差、持仓量、Fair – Last、pump、币种搜索
Start,50 美元30 秒Trial 的全部内容,加上股票、链上板块 /onchain/{section}、exact 和 dutch 模式的预测套利
Pro,100 美元10 秒全部端点:订单簿与订单簿 Δ、DEX – Spot、DEX – Futures、Cross-chain、资金费率分析
Max,200 美元5 秒与 Pro 相同的端点,每秒 15 次请求

套餐之外的端点会返回 403 plan_restricted,该响应不占用配额。调用配额和每秒请求限制见 Genesis API 价格页面。

实践

  1. 选一个交易对

    在 Spot — Spot 文档中打开“在线试用”表单,粘贴你的密钥,选一行价差在 1% 及以上的数据。

  2. 执行检查点 1 和 2

    从 spread_pct 中减去假定的两笔 0.1% 手续费,并检查 withdraw_enabled_buy 和 deposit_enabled_sell。把 contract 与该币的 /coins/search 响应对照。

  3. 执行检查点 3

    在 Pro 或 Max 中,用这个币和 volume=1000 请求 /orderbooks/spreads/spot-spot,找到同一交易所组合的行。在 Trial 和 Start 中,请在交易所终端打开订单簿。

  4. 执行检查点 4

    用当前 unix 时间减去 meta.updated_at:在终端中 date +%s 会输出当前 unix 时间。

  5. 写下结论

    这个交易对最先会被哪个检查点淘汰,以及在 1,000 美元时价差还剩多少。

常见问题

加密货币套利需要哪些数据?

同一个币在不同交易所的价格及其价差、带网络和合约信息的充值与提现状态、用于按你的资金量计算成交的订单簿,以及快照时间。资金费率套利还要加上费率、间隔和结算时间。在 Genesis API 中,对应的就是 /arbitrage/*、/orderbooks/* 和 /funding/*。

能通过 Genesis API 下单交易吗?

不能。Genesis API 只读取数据,不下单:交易需要你自己在交易所中开仓。