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.
GET
https://api.genesisarbitrage.com/v1/onchain/coin/{symbol}Try it
GET
/v1/onchain/coin/ETHThe 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
| Parameter | Type | Description |
|---|---|---|
{symbol} | string | Coin 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
| Field | Type | Description |
|---|---|---|
symbol / name / coin | string | Token ticker and full name |
cex | object | null | CEX context: price, OI, funding, best spread, networks, deposit and withdrawal, markets |
kpi / by_section | object | Coin KPIs over 7 days and event counts by section |
events / events_total / swaps / swaps_total | mixed | Events and swaps (up to 2000) and their totals |
unlocks.upcoming / past | array | Upcoming and past unlocks |