Documentación de Genesis API
Todo lo necesario para integrar: autenticación, límites, endpoints y esquemas de respuesta.
DocumentaciónGenesis Onchain
Genesis Onchain
TrialStartProMax
Monitoreo on-chain: grandes transferencias, flujos CEX, mint y bridges, billeteras de equipos, posiciones en Perp. DEX, unlocks, claims, flujos y hackeos.
GET
https://api.genesisarbitrage.com/v1/onchain/{section}Probar
GET
/v1/onchain/coin-trafficLa clave se guarda solo en tu navegador y no se envía a ningún sitio salvo la API.
Pega tu clave y envía una petición — mostraremos una respuesta resumida.
Secciones
Sin el parámetro section se devuelven todas las secciones. Los campos dependen de la sección — ver tabla abajo.
| section | Descripción | |
|---|---|---|
large-transfers | Grandes transferencias de tokens | |
cex-flows | Depósitos y retiros de CEX | |
mint-bridge | Actividad de mint y bridges | |
team-wallets | Movimientos de billeteras de equipos | |
perp-positions | Grandes posiciones en DEX perpetuos | |
unlocks | Unlocks de tokens | |
claims | Claims | |
coin-traffic | Flujos agregados de monedas | |
hacks | Hackeos y exploits |
Parámetros de la petición
Todos los parámetros son opcionales: sin filtros el endpoint devuelve el conjunto completo de datos.
| Parámetro | Tipo | Descripción |
|---|---|---|
section | string | Sección de datos — ver tabla; sin ella se devuelven todas |
min_usd | number | Importe mínimo, USD |
coin | string | Ticker de la moneda: solo filas de esta moneda (los hackeos no tienen moneda — lista vacía) |
when | string | Para unlocks: upcoming o past |
Ejemplo de petición
bash
curl "https://api.genesisarbitrage.com/v1/onchain/coin-traffic" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Ejemplo de respuesta
Se muestra un elemento del array data (datos reales):
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 de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
ts | int | Tiempo unix del evento |
token / token_name | string | Ticker y nombre completo del token |
chain / chain_name | string | Red |
usd / amount | number | Importe en USD y en tokens |
from_* / to_* | string | Remitente y receptor: etiqueta, dirección, enlace al explorer |
tx_hash / explorer_url / arkham_url | string | Hash de la transacción y enlaces explorer / Arkham |
direction | string | Dirección del flujo: deposit, withdrawal o transfer |
target / target_address / target_explorer | string | Destino del flujo: etiqueta, dirección completa y enlace |
total_usd / count / window_hours / avg_usd / largest_usd | number | Métricas: total, número de envíos, ventana, medio y mayor |
transfers[] | array | Top de transferencias: importes, direcciones, hashes y enlaces |
side / size / price / platform | mixed | Para perp-positions: lado (Long/Short), tamaño, precio, plataforma |
unlock_percent / unlock_value_usd / hours_left / allocations | mixed | Para unlocks: cuota y valor del unlock, horas restantes, asignaciones |
classification / technique / returned_funds | mixed | Para hacks: clasificación, técnica del ataque, fondos devueltos |
links | array | Enlaces listos: text + url |