Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DEX overview
Large DEX swaps, as in Β«DEX overviewΒ»: live β the last 15 minutes, plus 1h, 6h, 24h and 7d windows. Each swap has a pool impact estimate, the price move after 30 s and 5 min and the trader label. Records are completed as they are verified (facts: pending β final) and can disappear if a swap turns out to be a liquidity reshuffle β match by id.
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live/v1/onchain/dex-swaps?period=liveThe key is stored only in your browser and is sent nowhere except the API.
Paste your key and send a request β we'll show a truncated response.
Query parameters
All parameters are optional: without filters the endpoint returns the full dataset.
| Parameter | Type | Description |
|---|---|---|
period | string | live (15 minutes, default), 1h, 6h, 24h or 7d |
chain | string | Filter by network |
side | string | buy or sell |
dex | string | DEX; several β comma-separated |
min_usd | number | Minimum amount, USD |
min_impact | number | Minimum absolute pool impact, % |
final | boolean | true β verified swaps only (facts = final) |
token | string | Token ticker |
q | string | Search across token, name, addresses, trader, tx hash, DEX and chain |
Example request
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Example response
Response example β one data entry, long values shortened:
{
"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β¦"
}Response fields
| Field | Type | Description |
|---|---|---|
id | string | Stable id: chain, transaction, token |
ts / published_at | int | Swap and publication time |
token / token_name / token_address | string | Token: ticker, name, contract address |
chain / chain_name | string | Network |
side / amount / usd | mixed | Side buy or sell, amount and USD value |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX, its entity, pool, pool label and route |
trader_address / trader_name / trader_type / trader_url | string | null | Trader: address, label, type and link |
tier | string | Tier by pool liquidity: from T1 ($30Kβ100K) to T4 (over $10M) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | Pool liquidity, the swap's share of it and the estimated price impact, % |
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pct | number | null | Price and its change before the swap and after 30 s / 5 min |
facts / legs | string / int | Verification status: pending, publish, 30s, final or unavailable; legs β number of legs |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | Transaction hash and explorer / Arkham links |