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.

GEThttps://api.genesisarbitrage.com/v1/onchain/{section}
Try it
GET/v1/onchain/coin-traffic

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.

Sections

Without the section parameter all sections are returned at once. The field set depends on the section — see the field table below.

sectionDescription
large-transfersLarge token transfers
cex-flowsCEX deposits and withdrawals
mint-bridgeMint and bridge activity
team-walletsTeam wallet movements
perp-positionsLarge positions on perpetual DEXes
unlocksToken unlocks
claimsClaims
coin-trafficAggregated coin flows
hacksHacks and exploits

Query parameters

All parameters are optional: without filters the endpoint returns the full dataset.

ParameterTypeDescription
sectionstringData section — see the table below; omit to get all sections
min_usdnumberMinimum amount, USD
coinstringCoin ticker: rows of this coin only (hacks have no coin — empty list)
whenstringFor 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

FieldTypeDescription
tsintUnix time of the event
token / token_namestringToken ticker and full name
chain / chain_namestringNetwork
usd / amountnumberAmount in USD and in tokens
from_* / to_*stringSender and receiver: label, address, explorer link
tx_hash / explorer_url / arkham_urlstringTransaction hash and explorer / Arkham links
directionstringFlow direction: deposit, withdrawal or transfer
target / target_address / target_explorerstringFlow target: label, full address and explorer link
total_usd / count / window_hours / avg_usd / largest_usdnumberFlow metrics: total, transfer count, window, average and largest transfer
transfers[]arrayTop transfers: amounts, addresses, hashes and links
side / size / price / platformmixedFor perp-positions: side (Long/Short), size, price, platform
unlock_percent / unlock_value_usd / hours_left / allocationsmixedFor unlocks: unlock share and value, hours left, allocations
classification / technique / returned_fundsmixedFor hacks: classification, attack technique, returned funds
linksarrayReady links: text + url