Documentación de Genesis API
Todo lo necesario para integrar: autenticación, límites, endpoints y esquemas de respuesta.
Δ del libro de órdenes
«Δ del libro de órdenes» para cada fila de una moneda en el conjunto de datos de arbitraje elegido — las mismas fórmulas que la columna del sitio. Pares CEX: compra por los asks del primer exchange, venta contra los bids del segundo, limitado al spread de la fila. Filas DEX: el signo del spread define la dirección (≥ 0 — venta contra los bids del CEX, < 0 — compra desde los asks), un signo invertido da 0. volume = 0 — a los mejores precios del libro.
https://api.genesisarbitrage.com/v1/orderbooks/spreads/{dataset}?coin={coin}&volume=5000/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000La 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.
Parámetros de la petición
| Parámetro | Tipo | Descripción |
|---|---|---|
{dataset} | string | Conjunto de datos en la ruta: spot-spot, spot-futures, futures-futures, dex-spot o dex-futures |
coin | string | Ticker de la moneda (obligatorio) |
volume | number | 0 (por defecto) — mejores precios del libro, o 500, 1000, 2500, 5000, 10000 |
Ejemplo de petición
curl "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Ejemplo de respuesta
Ejemplo de respuesta — una entrada de datos, valores largos abreviados:
{
"coin": "BTC",
"exchange_buy": "Binance",
"exchange_sell": "ByBit",
"market_buy": "spot",
"market_sell": "futures",
"price_buy": 96016,
"price_sell": 96046,
"ask_buy": 96016,
"bid_sell": 96045.8,
"spread_pct": 0.031,
"order_delta": {
"volume": 5000,
"buy_price": 96019.8,
"sell_price": 96039.2,
"spread_pct": 0.0202,
"status": "ok"
}
}Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
… | Todos los campos de la fila del conjunto de datos — como en su endpoint | |
order_delta.volume | number | Volumen de cálculo, USD (0 — mejores precios) |
order_delta.buy_price / sell_price | number | null | Par CEX: precio de compra y venta para este volumen |
order_delta.side / cex_price | string / number | null | Fila DEX: el lado CEX (sell o buy) y el precio de ejecución |
order_delta.spread_pct | number | null | Spread tras ejecutar por los libros, % |
order_delta.status | string | ok; no_book — sin libro; exhausted — el libro no se llenó |