Genesis Arbitrage

Genesis Arbitrage · · 13 min de lectura

Endpoints de libros de órdenes de Genesis API: precio de ejecución, Δ del libro, libro, historial y DEX

En resumen

  • Seis endpoints de libros de órdenes en los planes API Pro y Max devuelven los mismos datos que el sitio muestra en la columna «Δ por órdenes», en la ventana «Libro de órdenes» y en Genesis Charts.
  • El precio de ejecución es el precio medio de una operación a mercado de 500, 1000, 2500, 5000 o 10 000 $; null significa que el libro es demasiado fino para ese volumen.
  • Los libros van 5–20 segundos por detrás del exchange: mira age_sec y stale, y revisa el libro en el terminal del exchange antes de operar.

La API de libro de órdenes de Genesis API son seis endpoints que muestran cuánto de un spread sobrevive a una operación de un tamaño dado. Devuelven precios de ejecución para un volumen, la Δ del libro para filas de arbitraje, un libro de órdenes con su profundidad, el historial de slippage y el slippage en DEX: los mismos datos que la columna «Δ por órdenes» y Genesis Charts en el sitio.

Seis endpoints de libros de órdenes

EndpointQué devuelveObligatorioDocumentación
/orderbooks/execPrecios de compra y venta para un volumen en cada mercadovolumePrecios de ejecución
/orderbooks/spreads/{dataset}Δ del libro para las filas de una moneda en un dataset de arbitrajecoinΔ del libro de órdenes
/orderbooks/bookLibro de un mercado: 10 niveles, muros, profundidad, antigüedadexchange, market, coinLibro de órdenes del mercado
/orderbooks/coin/{coin}Libros de una moneda en todos los exchanges y mercadosmoneda en la rutaLibros de órdenes de la moneda
/orderbooks/exec-historyHistorial de slippage, hasta 8 mercados por peticiónkeys, intervalHistorial de ejecución
/orderbooks/dex-slippageSlippage, impuestos y marca de honeypot por contrato—Slippage en DEX

Los seis forman parte de los planes de la API Pro (100 $ al mes) y Max (200 $); en Trial y Start devuelven 403 plan_restricted. En /orderbooks/exec y en el parámetro keys del historial, un mercado se escribe como Exchange|market|COIN, por ejemplo Binance|spot|BTC. Los ejemplos de respuesta de abajo muestran el campo data, abreviado.

Para una visión general de los datos de libros de órdenes, consulta el artículo sobre la API de libro de órdenes.

Precio de ejecución para un volumen

El precio de ejecución es el precio medio al que una orden a mercado de un tamaño dado recorre el libro: una compra consume los asks, una venta golpea los bids, de modo que es el VWAP de las órdenes que consume la operación. /orderbooks/exec lo devuelve para todos los mercados con un volumen de la cuadrícula.

ParámetroTipoQué hace
volumenúmeroVolumen en USD: 500, 1000, 2500, 5000 o 10000, obligatorio
exchangecadenaFiltra por exchange; separados por comas para varios
marketcadenaspot o futures
coincadenaTicker de la moneda, p. ej. BTC
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "volume": 1000,
  "markets": {
    "Binance|spot|BTC": [96021.5, 96010.2],
    "ByBit|futures|BTC": [96030.1, 96018.7],
    "Ourbit|spot|SHELL": [0.10418, null],
    …
  }
}

El valor de cada clave de mercado es [precio de compra, precio de venta]. null en lugar de un precio significa que el libro es demasiado fino para ese volumen: en el ejemplo, los bids de SHELL en Ourbit no absorben una venta de 1000 $. Sin filtros la respuesta contiene todos los mercados, así que pasa coin cuando necesites una sola moneda.

Δ del libro de órdenes: el spread tras recorrer el libro

La Δ del libro de órdenes es el spread de una fila de arbitraje recalculado a través de los libros para un volumen dado. /orderbooks/spreads/{dataset} toma todas las filas de una moneda en el dataset elegido y añade a cada una un objeto order_delta, con las mismas fórmulas que la columna del sitio.

ParámetroTipoQué hace
{dataset}cadena, en la rutaspot-spot, spot-futures, futures-futures, dex-spot o dex-futures
coincadenaTicker de la moneda, obligatorio
volumenúmero0 por defecto: mejores precios del libro; o 500, 1000, 2500, 5000, 10000

En los pares CEX la compra recorre los asks de exchange_buy y la venta entra en los bids de exchange_sell. order_delta incluye buy_price y sell_price, y el resultado nunca supera el spread_pct de la fila.

En las filas DEX el signo del spread fija el lado CEX: con spread_pct ≥ 0 el token se vende en los bids del CEX, y con un spread negativo se compra en los asks. order_delta incluye side y cex_price, el precio de ejecución en el CEX; si el signo cambia tras recorrer el libro, la Δ es 0.

El campo status: ok — calculado, no_book — sin libro, exhausted — el libro no cubrió el volumen.

Un ejemplo hipotético: moneda XYZ, compra en MEXC a 2,000, venta en Gate a 2,016, spread de la fila 0,8 %. Petición de la Δ del libro para 5000 $:

curl -G \
  "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-spot" \
  -d coin=XYZ -d volume=5000 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "coin": "XYZ",
  "exchange_buy": "MEXC",
  "exchange_sell": "Gate",
  "market_buy": "spot",
  "market_sell": "spot",
  "price_buy": 2.0,
  "price_sell": 2.016,
  "ask_buy": 2.001,
  "bid_sell": 2.015,
  "spread_pct": 0.8,
  "order_delta": {
    "volume": 5000,
    "buy_price": 2.004,
    "sell_price": 2.01,
    "spread_pct": 0.2994,
    "status": "ok"
  }
}

Los demás campos de la fila son como en /arbitrage/spot-spot. Spread de la fila: (2,016 − 2,000) / 2,000 × 100 = 0,8 %.

Con 5000 $, comprar a través del libro de MEXC promedia 2,004 y vender en el libro de Gate obtiene 2,010: (2,010 − 2,004) / 2,004 × 100 ≈ 0,2994 %. Del 0,8 %, a este tamaño sobrevive cerca de un 0,3 %: unos 15 $ antes de comisiones y de la transferencia: 5000 × 0,002994 ≈ 14,97.

Ejemplo en Python: spread antes y después del libro

El script imprime el spread de la fila junto al spread tras el libro para BTC en el dataset Spot – Spot con 5000 $. La clave se toma de la variable de entorno GENESIS_API_KEY; con 429 y 503 el script espera Retry-After segundos.

import os
import time
import requests

BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}


def get(path, params):
    for _ in range(3):
        r = requests.get(BASE + path, headers=HEADERS,
                         params=params, timeout=15)
        if r.status_code in (429, 503):
            # límite de peticiones o datos en reconstrucción
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]
    raise RuntimeError("API ocupada, inténtalo más tarde")


rows = get("/orderbooks/spreads/spot-spot",
           {"coin": "BTC", "volume": 5000})
for row in rows:
    od = row["order_delta"]
    if od["status"] == "ok":
        after = f'{od["spread_pct"]:.4f}%'
    else:
        after = od["status"]  # no_book o exhausted
    print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
          f'{row["spread_pct"]}% → {after}')

En un bucle, consulta como máximo una vez cada meta.freshness_sec segundos: 10 s en Pro, 5 s en Max. La cuota y los límites se explican en la guía de límites de Genesis API.

Libro de órdenes del mercado y libros de la moneda

/orderbooks/book devuelve el libro de un mercado, igual que la ventana «Libro de órdenes» del sitio. Tres parámetros obligatorios definen el mercado: exchange (sin distinguir mayúsculas), market (spot o futures) y coin. /orderbooks/coin/{coin} devuelve una lista de los mismos objetos para todos los exchanges y mercados de la moneda.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/book" \
  -d exchange=Binance -d market=spot -d coin=BTC \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  "best_bid": 96015.9,
  "best_ask": 96016,
  "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
  "asks": [[96016, 388120.2], [96016.1, 20410.7], …],
  "walls_bid": [[95900, 2410000]],
  "walls_ask": [[96500, 1980000]],
  "depth_bid_usd": 61234567,
  "depth_ask_usd": 58765432
}
CampoSignificado
best_bid, best_askMejor bid y mejor ask
bids, asksLos 10 mejores niveles: [precio, importe en USD]
walls_bid, walls_askLos muros más grandes: [precio, importe en USD]
depth_bid_usd, depth_ask_usdProfundidad de cada lado dentro de ±50 % del mejor precio, USD
book_ts, age_sec, staleHora del libro y su antigüedad en segundos; stale: más de 30 s
source, depth_limitedOrigen del libro (ws o rest) y marca de profundidad limitada

La profundidad de mercado en depth_bid_usd y depth_ask_usd es cuántos dólares en órdenes hay en un lado del libro: en el ejemplo, unos 58,8 millones de dólares en asks de BTC en Binance dentro de +50 % del mejor ask.

Con depth_limited: true el exchange publica un libro parcial y un volumen grande puede no llenarse. Si no hay libro para ese exchange, mercado y moneda, recibes 404.

Historial de ejecución

/orderbooks/exec-history es el historial de slippage de Genesis Charts: lo que costaba la ejecución en cada volumen de la cuadrícula, en puntos básicos sobre el precio medio del libro (1 pb = 0,01 %). Una petición admite hasta 8 mercados en keys, separados por comas; interval es obligatorio.

intervalPaso del punto360 puntos cubren
1m1 minuto6 horas
15m15 minutos3,75 días
1h1 hora15 días
1d1 díacerca de un año

Los datos se recopilan desde el 6 de septiembre de 2026, así que la serie diaria solo está completa a partir de esa fecha.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/exec-history" \
  --data-urlencode "keys=Binance|spot|BTC,ByBit|futures|BTC" \
  -d interval=1h \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "interval": "1h",
  "step_sec": 3600,
  "points": 360,
  "volumes_usd": [500, 1000, 2500, 5000, 10000],
  "last_bucket_ts": 1794672000,
  "series": {
    "Binance|spot|BTC": {
      "buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …],
              [3, 4, 6, …], [5, 7, 9, …]],
      "sell": [[-1, -1, -2, …], …]
    },
    "ByBit|futures|BTC": { … }
  }
}

buy y sell contienen cada uno cinco series, una por volumen de volumes_usd, con 360 valores del más antiguo al más reciente. El último punto corresponde a last_bucket_ts, y el punto i a last_bucket_ts − (points − 1 − i) × step_sec. Los valores de compra son positivos y los de venta negativos: el precio medio de la operación queda por encima y por debajo del precio medio del libro.

La serie [5, 7, 9, …] es una compra de 10 000 $: sus primeros puntos costaron 5–9 pb, es decir, 0,05–0,09 % sobre el precio medio. null en una serie significa que no hay datos o que el libro no se llenó; null en lugar de un objeto de mercado significa una clave desconocida.

Slippage en DEX

/orderbooks/dex-slippage describe la pata DEX de una operación: slippage de compra y venta de 100 a 100 000 $, impuestos del token y la marca de honeypot por contrato: lo mismo que las columnas de la tabla DEX del sitio. Filtros: contract (separados por comas para varios) y network.

curl -G "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \
  -d contract=0x6982508145454ce325ddbe47a25d4ec3d2311933 \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
  "sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
                100000],
  "contracts": [
    {
      "contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
      "network": "ETH",
      "tax_buy_pct": 0,
      "tax_sell_pct": 0,
      "honeypot": "no",
      "slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
                           1.41, 3.12, 6.05],
      "slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
                            1.5, 3.3, 6.4],
      "updated_at": 1794671040
    }
  ]
}

Las listas de slippage siguen la cuadrícula sizes_usd: en el ejemplo una compra de 5000 $ desliza un 0,58 % y una de 100 000 $, un 6,05 %. null en una lista significa que el pool no tiene liquidez para ese tamaño.

tax_buy_pct y tax_sell_pct son el impuesto de compra y de venta del token, en %; null significa que no hay fuente, no un 0 %. honeypot: no; suspect — las fuentes discrepan; yes — puede que no se pueda vender.

Cómo comprobar una operación con los libros

  1. Toma una fila de arbitraje

    Encuentra una operación en /arbitrage/spot-spot u otro dataset; consulta los endpoints de arbitraje. Anota la moneda, los exchanges y spread_pct.

  2. Recalcula el spread con los libros

    Pide /orderbooks/spreads/spot-spot con esa moneda y el tamaño de tu operación y compara spread_pct con order_delta.spread_pct.

  3. Comprueba la frescura y la profundidad

    Llama a /orderbooks/book para ambas patas: age_sec, stale y depth_limited indican si fiarte de las cifras, y los muros muestran dónde puede frenarse el precio.

  4. Compara con el historial

    /orderbooks/exec-history muestra si ese slippage es normal en el mercado: 1m cubre 6 horas, 1h cubre 15 días.

  5. Revisa los impuestos de la pata DEX

    En las operaciones DEX – Spot y DEX – Futures, pide /orderbooks/dex-slippage para el contrato de la fila: slippage, impuestos y honeypot.

Preguntas y respuestas

¿En qué se diferencia la Δ del libro del spread normal?

El spread_pct de una fila usa los últimos precios de los exchanges; la Δ del libro usa los precios medios de operaciones a mercado con el volumen dado. La diferencia entre ambos es lo que se lleva el libro.

¿Por qué recibo null en lugar de un precio?

En /orderbooks/exec el libro tiene muy pocas órdenes para ese volumen; en la Δ del libro el mismo caso es el estado exhausted. En el historial de ejecución null significa que no hay datos para el punto, y en el slippage en DEX, que el pool no tiene liquidez.

¿Puedo calcular la ejecución por encima de 10 000 $?

La cuadrícula de /orderbooks/exec y de la Δ del libro es fija, de 500 a 10 000 $. Para tamaños mayores, mira la profundidad y los muros en /orderbooks/book; para la pata DEX, /orderbooks/dex-slippage llega hasta 100 000 $.