Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationGenesis Onchain
Genesis Onchain
TrialStartProMax
On-chain monitoring: large transfers, CEX flows, mint & bridges, team wallets, Perp. DEX positions, unlocks, claims, coin flows and hacks.
GET
https://api.genesisarbitrage.com/v1/onchain/{section}Try it
GET
/v1/onchain/coin-trafficThe 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.
Sections
Without the section parameter all sections are returned at once. The field set depends on the section — see the field table below.
| section | Description | |
|---|---|---|
large-transfers | Large token transfers | |
cex-flows | CEX deposits and withdrawals | |
mint-bridge | Mint and bridge activity | |
team-wallets | Team wallet movements | |
perp-positions | Large positions on perpetual DEXes | |
unlocks | Token unlocks | |
claims | Claims | |
coin-traffic | Aggregated coin flows | |
hacks | Hacks and exploits |
Query parameters
All parameters are optional: without filters the endpoint returns the full dataset.
| Parameter | Type | Description |
|---|---|---|
section | string | Data section — see the table below; omit to get all sections |
min_usd | number | Minimum amount, USD |
coin | string | Coin ticker: rows of this coin only (hacks have no coin — empty list) |
when | string | For unlocks: upcoming or past |
Example request
bash
curl "https://api.genesisarbitrage.com/v1/onchain/coin-traffic" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Example response
One element of the data array is shown (real data):
json
{
"ts": 1783802410,
"token": "LAB",
"token_name": "LAB",
"direction": "deposit",
"target": "Gate-io",
"target_address": "0x8782163068c7cd74D2510768a61135C1e4Eb07b3",
"target_explorer": "https://bscscan.com/address/0x8782…",
"total_usd": 573796.98,
"count": 18,
"window_hours": 5.69,
"avg_usd": 31878,
"largest_usd": 59891.78,
"first_seen": 1783781930,
"transfers": [
{
"ts": 1783788640,
"usd": 59891.78,
"from_name": "0xec01…d1a5",
"from_address": "0xec01c918E2f700F47332Ddc2d216Ae9E747Bd1a5",
"to_address": "0x035AE7d933dCBFE617fFbA194A88Af0c2867B90c",
"tx_hash": "0xbf44850a7dc16086c08cfb…",
"chain": "bsc",
"explorer_url": "https://bscscan.com/tx/0xbf44…",
"from_explorer": "https://bscscan.com/address/0xec01…",
"to_explorer": "https://bscscan.com/address/0x035A…"
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
ts | int | Unix time of the event |
token / token_name | string | Token ticker and full name |
chain / chain_name | string | Network |
usd / amount | number | Amount in USD and in tokens |
from_* / to_* | string | Sender and receiver: label, address, explorer link |
tx_hash / explorer_url / arkham_url | string | Transaction hash and explorer / Arkham links |
direction | string | Flow direction: deposit, withdrawal or transfer |
target / target_address / target_explorer | string | Flow target: label, full address and explorer link |
total_usd / count / window_hours / avg_usd / largest_usd | number | Flow metrics: total, transfer count, window, average and largest transfer |
transfers[] | array | Top transfers: amounts, addresses, hashes and links |
side / size / price / platform | mixed | For perp-positions: side (Long/Short), size, price, platform |
unlock_percent / unlock_value_usd / hours_left / allocations | mixed | For unlocks: unlock share and value, hours left, allocations |
classification / technique / returned_funds | mixed | For hacks: classification, attack technique, returned funds |
links | array | Ready links: text + url |