Documentação da Genesis API
Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.
Visão geral de DEX
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.
https://api.genesisarbitrage.com/v1/onchain/dex-swaps?period=live/v1/onchain/dex-swaps?period=liveA 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âmetro | Tipo | Descrição |
|---|---|---|
period | string | live (15 minutos, padrão), 1h, 6h, 24h ou 7d |
chain | string | Filtro por rede |
side | string | buy ou sell |
dex | string | DEX; várias — separadas por vírgula |
min_usd | number | Valor mínimo, USD |
min_impact | number | Impacto absoluto mínimo no pool, % |
final | boolean | true — apenas swaps verificados (facts = final) |
token | string | Ticker do token |
q | string | Busca por token, nome, endereços, trader, hash da tx, DEX e rede |
Exemplo de requisição
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:
{
"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
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Id estável: rede, transação, token |
ts / published_at | int | Hora do swap e da publicação |
token / token_name / token_address | string | Token: ticker, nome, endereço do contrato |
chain / chain_name | string | Rede |
side / amount / usd | mixed | Lado buy ou sell, quantidade e valor em USD |
dex / dex_entity / pool_address / pool_label / route | mixed | DEX, sua entidade, pool, rótulo do pool e rota |
trader_address / trader_name / trader_type / trader_url | string | null | Trader: endereço, rótulo, tipo e link |
tier | string | Faixa pela liquidez do pool: de T1 ($30K–100K) a T4 (acima de $10M) |
pool_liquidity_usd / size_pct_liquidity / impact_est_pct | number | null | Liquidez 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_pct | number | null | Preço e sua variação antes do swap e após 30 s / 5 min |
facts / legs | string / int | Status da verificação: pending, publish, 30s, final ou unavailable; legs — número de pernas |
tx_hash / explorer_url / arkham_url / dexscreener_url | string | Hash da transação e links explorer / Arkham |