Genesis Arbitrage

Genesis Arbitrage · · 阅读约 23 分钟

DEX API:DEX 价格、流动性与滑点,对照 CEX 价格

简而言之

  • DEX API 返回代币在资金池中的价格、流动性、成交量、市值、合约和网络。做套利还需要同一合约的 CEX 价格——Genesis API 的 DEX – Spot 和 DEX – Futures 端点在 Pro 和 Max 套餐中提供。
  • DEX 价格取决于交易规模,因为价格由流动性池决定。在一个假设示例中,3% 的价差在 $2,500 的交易上剩 $11,到 $5,000 时扣除滑点、代币税和 gas 后变为负值。
  • /orderbooks/dex-slippage 返回你的交易规模对应的滑点、买入和卖出税以及 honeypot 标志。Genesis API 只读取数据:兑换由你在自己的钱包里签名。

DEX API 是以编程方式访问去中心化交易所(DEX)数据的接口:代币在资金池中的价格、池子流动性、成交量、市值、合约地址和网络。多数 DEX 没有订单簿,也没有上币流程:价格由流动性池决定,任何人都可以创建资金池。因此,DEX API 除了价格,还必须返回用于核查代币和资金池的数据。

做套利时,要把 DEX 价格与同一合约的 CEX 价格比较,再算出价差在你的交易规模下,扣除滑点、代币税和 gas 后还剩多少。在 Genesis API 中,DEX ↔ CEX 交易对来自 /arbitrage/dex-spot 和 /arbitrage/dex-futures,而每个合约的滑点、税率和 honeypot 标志来自 /orderbooks/dex-slippage。

DEX 如何定价

在多数 DEX 上,兑换经过流动性池——一个持有两种代币储备的智能合约,例如某个代币和 USDC。价格就是储备的比例。买入会从池中取走代币并加入 USDC,因此代币的每一个后续单位都比前一个更贵。

Uniswap 用恒定乘积公式 x × y = k 描述这样的资金池,其中 x 和 y 是两种代币的储备:兑换之后,乘积不能减少。

假设示例:一个资金池有 $200,000 的流动性,两侧各 $100,000。买入 $1,000 使平均价格移动 2 × 1,000 / 200,000 = 1%,买入 $10,000 则移动 10%。带表格的分步计算见课程什么是 DEX 套利。

这个公式描述的是一个经典资金池。在 Uniswap v3 和 v4 中,它只在流动性提供者选定的价格区间内适用,而 Genesis Arbitrage 各行中的 DEX 价格是按合约和网络汇总的。所以特定交易规模下的准确滑点来自数据,公式只用于快速估算。

你需要从 DEX API 得到什么

评估一个 DEX ↔ CEX 交易对,只有一个价格是不够的。下面列出所需数据及其在 Genesis API 响应中的位置:

数据在套利中的意义Genesis API 字段
DEX 和 CEX 价格价差及其方向dex_price、cex_price、spread_pct
池子流动性一笔交易会把价格推多远liquidity_usd
24h 成交量资金池到底有没有交易dex_volume_24h、volume_24h_usd
市值代币规模有多大market_cap
合约和网络是否与交易所上的是同一个代币contract、network 或 chain
池子年龄新池子是重新核对合约的理由pool_created_at
CEX 充币和提币代币能否转入或转出交易所deposit_enabled、withdraw_enabled
滑点、税率、honeypot价差还剩多少/orderbooks/dex-slippage
资金池链接亲自查看资金池和其成交dexscreener_url、dextools_url、gmgn_url

市值和 DEX 成交量在 DEX – Spot 中提供,池子年龄在跨链的 buy 和 sell 两侧。请求某个币种的 DEX – Spot 行:

curl -G --compressed \
  "https://api.genesisarbitrage.com/v1/arbitrage/dex-spot" \
  -d coin=SCR \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

来自 DEX — Spot 文档的一行,已精简:

{
  "coin": "SCR",
  "exchange": "MEXC",
  "cex_price": 0.02691,
  "dex_price": 0.02679,
  "spread_pct": 0.45,
  "network": "SCROLL",
  "contract": "0xd29687c813D741E2F938F4aC377128810E217b1b",
  "liquidity_usd": 10544.15,
  "market_cap": 5091835.0,
  "dex_volume_24h": 319.73,
  "deposit_enabled": true,
  "withdraw_enabled": true,
  "dexscreener_url": "https://dexscreener.com/scroll/0xd296…",
  "dextools_url": null,
  …
}

该代币在 MEXC 上比在池中贵,所以价差为正:0.45%。池子流动性为 $10,544,24 小时 DEX 成交量约 $320。如果这是一个经典资金池,买入 $1,000 的平均价格将比起始价格高约 2 × 1,000 / 10,544 ≈ 19%——是价差的 40 多倍。链接可能为 null:这一行只有 dexscreener_url。

为什么 DEX 价格会偏离 CEX 价格

资金池的价格只会随池内交易而变化,从外部看,新价格每个区块出现一次:以太坊把时间划分为 12 秒的槽位。在 CEX 上,价格随订单簿中的订单流移动。价差会一直持续到有套利者把它抹平,而阻碍抹平的因素有:

对套利来说,价差的正负决定交易方向,方向又决定交易所必须开放什么,以及要读取哪些 DEX 腿数据:

spread_pct交易CEX 上需要DEX 腿数据
大于 0在 DEX 买入,充币到交易所,卖出deposit_enabledslippage_buy_pct、tax_buy_pct
小于 0在交易所买入,提币,在 DEX 卖出withdraw_enabledslippage_sell_pct、tax_sell_pct

代币在钱包与交易所之间转移期间,价差可能收窄。在 DEX – Futures 交易对中,与 DEX 买入同时开的合约空单可以对冲价格波动,但保证金、资金费率和强平风险也随之而来——见课程套利:DEX — Futures。如果交易所提供,DEX – Futures 行还有 max_position_usd,即最大仓位规模。

滑点、代币税和 honeypot

/orderbooks/dex-slippage 按合约描述交易对的 DEX 腿:规模从 $100 到 $100,000 的买入和卖出滑点、代币的买入和卖出税,以及 honeypot 标志(honeypot 指买得进、卖不出的代币)。这与站点上 DEX 表格各列的数据相同。过滤参数是 contract(多个地址用逗号分隔)和 network;字段说明见 DEX 滑点部分。

文档中的响应示例,单个合约:

{
  "sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
                100000],
  "contracts": [
    {
      "contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "network": "ETH",
      "tax_buy_pct": 0,
      "tax_sell_pct": 0,
      "honeypot": "no",
      "slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
                           1.41, 3.12, 6.05],
      "slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
                            1.5, 3.3, 6.4],
      "updated_at": 1794671040
    }
  ]
}

数组与 sizes_usd 网格一一对应:买入 $1,000 损失 0.36%,买入 $10,000 损失 0.86%,买入 $100,000 损失 6.05%。数组中的 null 表示资金池没有足够的流动性承接该规模。honeypot 有三个取值:no;suspect——各数据源结论不一致;yes——可能无法卖出。每个合约在 updated_at 中有自己的更新时间。

假设示例:3% 的价差还剩多少

代币在 DEX 上 $1.00,在 CEX 上 $1.03:按买入价计算价差为 3%,所以在 DEX 买入、在交易所卖出。买入税 1%,卖出时的交易所手续费 0.1%,兑换和转入交易所的 gas 为 $4。slippage_buy_pct 阶梯:$500 时 0.5%,$1,000 时 0.7%,$2,500 时 1.3%,$5,000 时 2.3%。

交易规模滑点gas 占规模的 %剩余价差
$5000.5%0.8%0.6%,即 $3
$1,0000.7%0.4%0.8%,即 $8
$2,5001.3%0.16%0.44%,即 $11
$5,0002.3%0.08%−0.48%,即 −$24

对于 $5,000:3 − 2.3 − 1 − 0.1 − 0.08 = −0.48%,这笔交易亏损 $24。估算时把百分比直接相加即可;用乘积做精确计算,结果会低几个百分之一。

按美元计算,$2,500 时剩余最多,而在 $5,000 时同样的价差会让交易变为负值。随着规模增大,gas 占比缩小而滑点增大,所以每个交易对都有自己的合适规模。若 honeypot: "yes" 且价差为负,就没有什么可算的:在交易所买入的代币可能无法在池中卖出。

示例中的 CEX 卖出使用的是数据行中的价格。实际操作中,你要拿交易所订单簿去核对:DEX 行的订单簿 Δ 来自 /orderbooks/spreads/dex-spot,对应 $500、$1,000、$2,500、$5,000 和 $10,000——字段见文档,逐步讲解见指南订单簿端点。

Genesis API 中的 DEX 端点

端点返回内容文档
/arbitrage/dex-spotDEX 价格与 CEX 现货、流动性、市值、成交量DEX — Spot
/arbitrage/dex-futuresDEX 价格与 CEX 合约、max_position_usdDEX — Futures
/arbitrage/crosschain同一代币在两个网络 DEX 上的情况、池子年龄跨链
/orderbooks/dex-slippage$100 至 $100,000 的滑点、税率、honeypotDEX 滑点
/market/dex-dumpsDEX 上的代币暴跌,以及该代币是否在 CEX 交易DEX Dumps

这五个端点都在 API 的 Pro(每月 $100,新鲜度 10 秒)和 Max($200,新鲜度 5 秒)套餐中可用;在 Trial 和 Start 上返回 403 plan_restricted。DEX – Spot 和 DEX – Futures 接受 coin、exchange、min_spread 和 min_liquidity,跨链用 chain 代替 exchange,DEX Dumps 接受 chain 和 min_liquidity。参数和字段见指南套利端点,价格见 Genesis API 价格页面。

min_spread 比较的是带符号的价差:min_spread=2 也会过滤掉价差为 −5% 的行。要同时看到两个方向,请像下面的示例那样,在代码中对绝对值应用阈值。带价格冲击估算的大额资金池兑换来自链上端点 /onchain/dex-swaps,见文章链上数据 API。

不写代码的话,站点上的表格展示同样的交易对:其列、过滤器和核查顺序见如何使用 DEX – Spot 表格。

Python 示例:避开陷阱的 DEX – Spot 交易对

脚本取流动性不低于 $50,000、绝对价差不低于 2% 的 DEX – Spot 交易对,请求它们合约的滑点和税率,并剔除 honeypot: "yes" 和税率高于 5% 的。对其余的,计算在 $1,000 的规模下扣除滑点和税后还剩多少价差。密钥取自环境变量 GENESIS_API_KEY。

请求函数在遇到 429 和 503 时等待 Retry-After 秒。月度配额用完时,Retry-After 会倒数到配额重置,可能长达数天,所以脚本不会开始长时间的等待:

import os
import time
import requests

API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def get(path, params=None):
    for _ in range(3):
        r = requests.get(API + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code == 403:
            raise SystemExit("DEX endpoints need the Pro or Max plan")
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # monthly quota used up
                raise SystemExit(f"quota used up, retry in {wait} s")
            time.sleep(wait)
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API busy, try again later")

筛选交易对并核查合约:

SIZE = 1000   # trade size, USD: one of the sizes_usd values
MAX_TAX = 5   # skip tokens taxed above 5%

rows = get("/arbitrage/dex-spot", {"min_liquidity": 50000})
rows = [x for x in rows
        if x["contract"] and abs(x["spread_pct"]) >= 2]

addrs = sorted({x["contract"].lower() for x in rows})
checks, sizes = {}, []
for i in range(0, len(addrs), 50):  # up to 50 addresses per call
    d = get("/orderbooks/dex-slippage",
            {"contract": ",".join(addrs[i:i + 50])})
    sizes = d["sizes_usd"]
    for c in d["contracts"]:  # addresses come in lowercase
        checks[c["contract"]] = c

found = []
for x in rows:
    c = checks.get(x["contract"].lower())
    if c is None or c["honeypot"] == "yes":
        continue  # no data, or selling may be impossible
    taxes = [t for t in (c["tax_buy_pct"], c["tax_sell_pct"])
             if t is not None]  # null means no source, not 0%
    if any(t > MAX_TAX for t in taxes):
        continue
    buy = x["spread_pct"] >= 0  # positive: buy on the DEX
    ladder = c["slippage_buy_pct" if buy else "slippage_sell_pct"]
    k = sizes.index(SIZE)
    slip = ladder[k] if k < len(ladder) else None
    if slip is None:
        continue  # the pool lacks liquidity for SIZE
    tax = c["tax_buy_pct" if buy else "tax_sell_pct"]
    left = abs(x["spread_pct"]) - slip - (tax or 0)
    found.append((left, x, c["honeypot"], tax))

for left, x, hp, tax in sorted(found, key=lambda f: -f[0]):
    print(f'{x["coin"]:<8} {x["exchange"]:<8} '
          f'spread {x["spread_pct"]:+.2f}%, left {left:.2f}%, '
          f'tax {"no data" if tax is None else tax}, '
          f'honeypot {hp}')

脚本没有扣除 gas 和交易所手续费,请加上你自己的网络和交易所数字。它会跳过在 /orderbooks/dex-slippage 中没有数据的行:这些代币请通过数据行的链接手动核查。地址按小写比较,因为 DEX – Spot 可能返回大小写混合的合约,如上面的示例所示。

循环轮询的频率不要高于 meta.freshness_sec。在 Pro 上即每 10 秒一次:30 天内对单个端点调用 30 × 86,400 / 10 = 259,200 次,配额为 500 万次。如何节省配额和流量,见如何轮询 API 而不触发限制。

价差看不到的风险

常见问题

能通过 Genesis API 买入代币吗?

不能。Genesis API 只返回数据,不下单,无论是 DEX 还是交易所。DEX 兑换由你在自己的钱包里签名,CEX 交易由你自己在交易所开仓。

API 中的 DEX 价格多久更新一次?

资金池的价格随池内每笔交易变化,从外部看每个新区块出现一次。Genesis Arbitrage 的核心每秒刷新数据,API 按你所在套餐的新鲜度提供:Pro 为 10 秒,Max 为 5 秒,它们是仅有的包含 DEX 端点的套餐。快照生成时间在 meta.updated_at 中;滑点和税率带有各合约自己的 updated_at。

代币税中的 null 是什么意思?

表示没有这个代币的税率数据来源。不要当作 0:税率可能是任何值。上面的 Python 示例会保留这类行并输出“tax no data”,方便你手动核查。

DEX 数据需要哪个 Genesis API 套餐?

Pro(每月 $100)或 Max($200)。在 Trial 和 Start 上,DEX – Spot、DEX – Futures、跨链、DEX Dumps 和 DEX 滑点都返回 403 plan_restricted。

响应里有 DexScreener 链接吗?

有。DEX – Spot 和 DEX – Futures 的行以及跨链的两侧都带有 dexscreener_url、dextools_url 和 gmgn_url,即指向资金池或代币页面的链接。链接缺失时,字段为 null。在 DEX Dumps 中,资金池链接是 pool_url,其余的在 links 数组中。