Genesis API Documentation

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

DocumentationOnChain coin

OnChain coin

TrialStartProMax

7-day summary of one coin, as on the OnChain coin page: events, DEX swaps, unlocks and CEX context (price, OI, funding, best spread, networks, deposit and withdrawal). Rebuilt at most once every 10 seconds.

GEThttps://api.genesisarbitrage.com/v1/onchain/coin/{symbol}
Try it
GET/v1/onchain/coin/ETH

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

ParameterTypeDescription
{symbol}stringCoin ticker in the path (1–32 characters)

Example request

bash
curl "https://api.genesisarbitrage.com/v1/onchain/coin/ETH" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Example response

Response example — one data entry, long values shortened:

json
{
  "symbol": "PEPE",
  "name": "Pepe",
  "coin": "PEPE",
  "cex": { "coin": "PEPE", "price": 0.00001, "oi_usd": 412000000, "funding_8h": 0.0081, "best_spread": 0.42, "deposit": true, "withdraw": true, "nets": ["ETH", "BSC"], "markets": [ … ] },
  "kpi": { "events": 38, "usd": 61234567, "cex_in": 21000000, "cex_out": 18500000, "swaps": 54, "dex_buy": 3120000, "dex_sell": 2890000 },
  "by_section": { "large_tx": 12, "cex_deposits": 21, "team_wallets": 5 },
  "events": [ … ], "events_total": 38,
  "swaps": [ … ], "swaps_total": 54,
  "unlocks": { "upcoming": [ … ], "past": [ … ] }
}

Response fields

FieldTypeDescription
symbol / name / coinstringToken ticker and full name
cexobject | nullCEX context: price, OI, funding, best spread, networks, deposit and withdrawal, markets
kpi / by_sectionobjectCoin KPIs over 7 days and event counts by section
events / events_total / swaps / swaps_totalmixedEvents and swaps (up to 2000) and their totals
unlocks.upcoming / pastarrayUpcoming and past unlocks