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 上,价格随订单簿中的订单流移动。价差会一直持续到有套利者把它抹平,而阻碍抹平的因素有:
- 充币或提币关闭。 如果代币无法转入或转出交易所,两个市场就各自独立运行。在数据行中,对应的是
deposit_enabled和withdraw_enabled。 - 成本超过价差。 gas、池子和交易所手续费:小于这些成本的价差不值得去抹平。
- 代币税。 买入税为 5% 时,不超过 5% 的价差会被税本身吃掉。
- 池子太浅。 在价值几万美元的资金池里,一笔中等规模的交易就会推动价格。
- 不同的代币。 DEX 上可能有使用相同代号、但合约不同的仿制代币在交易。Genesis Arbitrage 只在合约地址一致时才比较价格。
对套利来说,价差的正负决定交易方向,方向又决定交易所必须开放什么,以及要读取哪些 DEX 腿数据:
spread_pct | 交易 | CEX 上需要 | DEX 腿数据 |
|---|---|---|---|
| 大于 0 | 在 DEX 买入,充币到交易所,卖出 | deposit_enabled | slippage_buy_pct、tax_buy_pct |
| 小于 0 | 在交易所买入,提币,在 DEX 卖出 | withdraw_enabled | slippage_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 占规模的 % | 剩余价差 |
|---|---|---|---|
| $500 | 0.5% | 0.8% | 0.6%,即 $3 |
| $1,000 | 0.7% | 0.4% | 0.8%,即 $8 |
| $2,500 | 1.3% | 0.16% | 0.44%,即 $11 |
| $5,000 | 2.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-spot | DEX 价格与 CEX 现货、流动性、市值、成交量 | DEX — Spot |
/arbitrage/dex-futures | DEX 价格与 CEX 合约、max_position_usd | DEX — Futures |
/arbitrage/crosschain | 同一代币在两个网络 DEX 上的情况、池子年龄 | 跨链 |
/orderbooks/dex-slippage | $100 至 $100,000 的滑点、税率、honeypot | DEX 滑点 |
/market/dex-dumps | DEX 上的代币暴跌,以及该代币是否在 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 而不触发限制。
价差看不到的风险
- MEV 和三明治攻击。 机器人能在你的 DEX 兑换上链之前看到它:先于你买入,紧随其后卖出,并拿走一部分价差。你在钱包中设置的滑点容忍度越宽,它能拿走的就越多;防护方法见DEX 上的 MEV 和三明治攻击。
- 代币所有者的权限。 如果合约允许,所有者可以在你买入后提高税率或禁止卖出,而今天的
honeypot: "no"和零税率并不能保护你。合约权限和流动性锁定的逐步核查见买入前如何核查代币。 - 数据延迟。 价格按你所在套餐的延迟到达,滑点阶梯带有自己的
updated_at。交易前,请通过数据行的链接核对资金池价格,并查看交易所的订单簿。 - 转入交易所。 代币在途期间,充币可能关闭,到账要等待网络确认,确认数由各交易所自行设定。
- Gas。 网络拥堵时 gas 上涨,会吃掉小额交易的价差。
常见问题
能通过 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 数组中。