Documentação da Genesis API

Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.

DocumentaçãoVisão geral de DEX

Visão geral de DEX

TrialStartProMax

Grandes swaps em DEX, como em «Visão geral de DEX»: live — os últimos 15 minutos, mais janelas de 1h, 6h, 24h e 7d. Cada swap traz uma estimativa de impacto no pool, a variação de preço após 30 s e 5 min e o rótulo do trader. Os registros são completados conforme são verificados (facts: pending → final) e podem desaparecer se o swap se revelar uma realocação de liquidez — faça a correspondência por id.

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

A chave fica só no seu navegador e não é enviada a lugar nenhum além da API.

Cole sua chave e envie uma requisição — mostraremos uma resposta resumida.

Parâmetros da requisição

Todos os parâmetros são opcionais: sem filtros o endpoint retorna o conjunto completo de dados.

ParâmetroTipoDescrição
periodstringlive (15 minutos, padrão), 1h, 6h, 24h ou 7d
chainstringFiltro por rede
sidestringbuy ou sell
dexstringDEX; várias — separadas por vírgula
min_usdnumberValor mínimo, USD
min_impactnumberImpacto absoluto mínimo no pool, %
finalbooleantrue — apenas swaps verificados (facts = final)
tokenstringTicker do token
qstringBusca por token, nome, endereços, trader, hash da tx, DEX e rede

Exemplo de requisição

bash
curl "https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Exemplo de resposta

Exemplo de resposta — um elemento de dados, valores longos abreviados:

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

Campos da resposta

CampoTipoDescrição
idstringId estável: rede, transação, token
ts / published_atintHora do swap e da publicação
token / token_name / token_addressstringToken: ticker, nome, endereço do contrato
chain / chain_namestringRede
side / amount / usdmixedLado buy ou sell, quantidade e valor em USD
dex / dex_entity / pool_address / pool_label / routemixedDEX, sua entidade, pool, rótulo do pool e rota
trader_address / trader_name / trader_type / trader_urlstring | nullTrader: endereço, rótulo, tipo e link
tierstringFaixa pela liquidez do pool: de T1 ($30K–100K) a T4 (acima de $10M)
pool_liquidity_usd / size_pct_liquidity / impact_est_pctnumber | nullLiquidez do pool, a parcela do swap nela e o impacto estimado no preço, %
price_usd / price_change_5m_pct / price_change_1h_pct / price_after_30s_usd / price_after_5m_usd / move_after_5m_pctnumber | nullPreço e sua variação antes do swap e após 30 s / 5 min
facts / legsstring / intStatus da verificação: pending, publish, 30s, final ou unavailable; legs — número de pernas
tx_hash / explorer_url / arkham_url / dexscreener_urlstringHash da transação e links explorer / Arkham