Documentação da Genesis API
Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.
DocumentaçãoGenesis Onchain
Genesis Onchain
TrialStartProMax
Monitoramento on-chain: grandes transferências, fluxos CEX, mint e bridges, carteiras de equipes, posições em Perp. DEX, unlocks, claims, fluxos e hacks.
GET
https://api.genesisarbitrage.com/v1/onchain/{section}Testar
GET
/v1/onchain/coin-trafficA 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.
Seções
Sem o parâmetro section todas as seções são retornadas. Os campos dependem da seção — veja a tabela abaixo.
| section | Descrição | |
|---|---|---|
large-transfers | Grandes transferências de tokens | |
cex-flows | Depósitos e saques de CEX | |
mint-bridge | Atividade de mint e bridges | |
team-wallets | Movimentos de carteiras de equipes | |
perp-positions | Grandes posições em DEX perpétuos | |
unlocks | Unlocks de tokens | |
claims | Claims | |
coin-traffic | Fluxos agregados de moedas | |
hacks | Hacks e exploits |
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 |
|---|---|---|
section | string | Seção de dados — veja a tabela; sem ela, todas as seções |
min_usd | number | Valor mínimo, USD |
coin | string | Ticker da moeda: somente linhas desta moeda (hacks não têm moeda — lista vazia) |
when | string | Para unlocks: upcoming ou past |
Exemplo de requisição
bash
curl "https://api.genesisarbitrage.com/v1/onchain/coin-traffic" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Exemplo de resposta
É mostrado um elemento do array data (dados reais):
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…"
}
]
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
ts | int | Tempo unix do evento |
token / token_name | string | Ticker e nome completo do token |
chain / chain_name | string | Rede |
usd / amount | number | Valor em USD e em tokens |
from_* / to_* | string | Remetente e destinatário: rótulo, endereço, link do explorer |
tx_hash / explorer_url / arkham_url | string | Hash da transação e links explorer / Arkham |
direction | string | Direção do fluxo: deposit, withdrawal ou transfer |
target / target_address / target_explorer | string | Alvo do fluxo: rótulo, endereço completo e link do explorer |
total_usd / count / window_hours / avg_usd / largest_usd | number | Métricas: total, número de envios, janela, médio e maior |
transfers[] | array | Top de transferências: valores, endereços, hashes e links |
side / size / price / platform | mixed | Para perp-positions: lado (Long/Short), tamanho, preço, plataforma |
unlock_percent / unlock_value_usd / hours_left / allocations | mixed | Para unlocks: fração e valor do unlock, horas restantes, alocações |
classification / technique / returned_funds | mixed | Para hacks: classificação, técnica do ataque, fundos devolvidos |
links | array | Links prontos: text + url |