Genesis API 文档
接入所需的一切:认证、限额、接口和响应结构。
文档DEX 概览
DEX 概览
TrialStartProMax
大额 DEX 兑换,与「DEX 概览」一致:live——最近 15 分钟,另有 1h、6h、24h 和 7d 窗口。每笔兑换包含资金池冲击估算、30 秒和 5 分钟后的价格变动以及交易者标签。记录在验证过程中逐步补全(facts:pending → final),若兑换被证明只是流动性重新分配,则可能消失——请按 id 匹配。
GET
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live在线试用
GET
/v1/onchain/dex-swaps?period=live密钥仅保存在你的浏览器中,除 API 外不会发送到任何地方。
粘贴你的密钥并发送请求——我们会显示截断后的响应。
查询参数
所有参数均为可选:不带筛选条件时,接口返回完整数据集。
| 参数 | 类型 | 说明 |
|---|---|---|
period | string | live(15 分钟,默认)、1h、6h、24h 或 7d |
chain | string | 按网络筛选 |
side | string | buy 或 sell |
dex | string | DEX;多个用逗号分隔 |
min_usd | number | 最小金额,USD |
min_impact | number | 资金池冲击绝对值下限,% |
final | boolean | true——仅显示已验证的兑换(facts = final) |
token | string | 代币代码 |
q | string | 在代币、名称、地址、交易者、交易哈希、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…"
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 稳定 id:链、交易、代币 |
ts / published_at | int | 兑换和发布时间 |
token / token_name / token_address | string | 代币:代码、名称、合约地址 |
chain / chain_name | string | 网络 |
side / amount / usd | mixed | 方向 buy 或 sell、数量和 USD 价值 |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX、其实体、资金池、资金池标签和路由 |
trader_address / trader_name / trader_type / trader_url | string | null | 交易者:地址、标签、类型和链接 |
tier | string | 按资金池流动性分档:从 T1($30K–100K)到 T4(超过 $10M) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | 资金池流动性、该兑换占其比例以及估算的价格冲击,% |
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number | null | 价格及其在兑换前和兑换后 30 秒 / 5 分钟的变化 |
facts / legs | string / int | 验证状态:pending、publish、30s、final 或 unavailable;legs——腿的数量 |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | 交易哈希及浏览器 / Arkham 链接 |