Genesis API 文档

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

文档DEX 概览

DEX 概览

TrialStartProMax

大额 DEX 兑换,与「DEX 概览」一致:live——最近 15 分钟,另有 1h、6h、24h 和 7d 窗口。每笔兑换包含资金池冲击估算、30 秒和 5 分钟后的价格变动以及交易者标签。记录在验证过程中逐步补全(facts:pending → final),若兑换被证明只是流动性重新分配,则可能消失——请按 id 匹配。

GEThttps://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live
在线试用
GET/v1/onchain/dex-swaps?period=live

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

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

查询参数

所有参数均为可选:不带筛选条件时,接口返回完整数据集。

参数类型说明
periodstringlive(15 分钟,默认)、1h、6h、24h 或 7d
chainstring按网络筛选
sidestringbuy 或 sell
dexstringDEX;多个用逗号分隔
min_usdnumber最小金额,USD
min_impactnumber资金池冲击绝对值下限,%
finalbooleantrue——仅显示已验证的兑换(facts = final)
tokenstring代币代码
qstring在代币、名称、地址、交易者、交易哈希、DEX 和链中搜索

请求示例

bash
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

响应示例

响应示例——一条数据,较长的值已缩短:

json
{
  "id": "ethereum:0x5f3c…e1:0x6982…1933",
  "ts": 1794675511,
  "published_at": 1794675523,
  "token": "PEPE",
  "token_name": "Pepe",
  "token_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "chain": "ethereum",
  "chain_name": "Ethereum",
  "side": "buy",
  "amount": 41250000000,
  "usd": 412500,
  "dex": "Uniswap",
  "pool_address": "0xa43f…",
  "pool_label": "PEPE/WETH 0.3%",
  "trader_address": "0x7b9e…",
  "trader_name": "Wintermute",
  "tier": "T3",
  "pool_liquidity_usd": 4120000,
  "size_pct_liquidity": 10.01,
  "impact_est_pct": 4.8,
  "price_usd": 0.00001,
  "move_after_5m_pct": 1.9,
  "facts": "final",
  "tx_hash": "0x5f3c…e1",
  "explorer_url": "https://etherscan.io/tx/0x5f3c…e1",
  "dexscreener_url": "https://dexscreener.com/ethereum/0xa43f…"
}

响应字段

字段类型说明
idstring稳定 id:链、交易、代币
ts / published_atint兑换和发布时间
token / token_name / token_addressstring代币:代码、名称、合约地址
chain / chain_namestring网络
side / amount / usdmixed方向 buy 或 sell、数量和 USD 价值
dex / dex_entity / pool_address / pool_label / routemixedDEX、其实体、资金池、资金池标签和路由
trader_address / trader_name / trader_type / trader_urlstring | null交易者:地址、标签、类型和链接
tierstring按资金池流动性分档:从 T1($30K–100K)到 T4(超过 $10M)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber | null资金池流动性、该兑换占其比例以及估算的价格冲击,%
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber | null价格及其在兑换前和兑换后 30 秒 / 5 分钟的变化
facts / legsstring / int验证状态:pending、publish、30s、final 或 unavailable;legs——腿的数量
tx_hash / explorer_url / arkham_url / dexscreener_urlstring交易哈希及浏览器 / Arkham 链接