Genesis API Documentation

Everything you need to integrate: authentication, limits, endpoints and response schemas.

DocumentationDEX overview

DEX overview

TrialStartProMax

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.

GEThttps://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live
Try it
GET/v1/onchain/dex-swaps?period=live

The 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.

ParameterTypeDescription
periodstringlive (15 minutes, default), 1h, 6h, 24h or 7d
chainstringFilter by network
sidestringbuy or sell
dexstringDEX; several β€” comma-separated
min_usdnumberMinimum amount, USD
min_impactnumberMinimum absolute pool impact, %
finalbooleantrue β€” verified swaps only (facts = final)
tokenstringToken ticker
qstringSearch across token, name, addresses, trader, tx hash, DEX and chain

Example request

bash
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:

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…"
}

Response fields

FieldTypeDescription
idstringStable id: chain, transaction, token
ts / published_atintSwap and publication time
token / token_name / token_addressstringToken: ticker, name, contract address
chain / chain_namestringNetwork
side / amount / usdmixedSide buy or sell, amount and USD value
dex / dex_entity / pool_address / pool_label / routemixedDEX, its entity, pool, pool label and route
trader_address / trader_name / trader_type / trader_urlstring | nullTrader: address, label, type and link
tierstringTier by pool liquidity: from T1 ($30K–100K) to T4 (over $10M)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber | nullPool 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_pctnumber | nullPrice and its change before the swap and after 30 s / 5 min
facts / legsstring / intVerification status: pending, publish, 30s, final or unavailable; legs β€” number of legs
tx_hash / explorer_url / arkham_url / dexscreener_urlstringTransaction hash and explorer / Arkham links