Genesis Arbitrage

Genesis Arbitrage · · 13 min de lectura

Datos de API para arbitraje: spreads, libros de órdenes y funding

En resumen

  • Cada pregunta del trader tiene su endpoint: la diferencia de precio es spread_pct en /arbitrage/*, la transferencia de la moneda son los flags de depósito y retiro más network y contract, la ejecución para tu volumen está en /orderbooks/* y el caso del funding, en /funding/*.
  • El spread de la fila se calcula con las últimas operaciones. En el ejemplo ilustrativo, el 1,5 % sobre 2500 $ baja al 0,72 % tras recorrer los libros de órdenes y a cerca del 0,52 %, unos 13 $, tras dos comisiones taker del 0,1 %.
  • Cada respuesta incluye sus tiempos: meta.updated_at es el momento en que se construyó la instantánea, meta.freshness_sec es el paso de actualización de tu plan, y age_sec y stale dan la antigüedad del libro de órdenes.
  • Un par se comprueba en cuatro puntos: diferencia de precio, transferencia, libro de órdenes y frescura. Si falla cualquiera, la entrada se cancela.
  • El arbitraje CEX, el funding y el open interest están en todos los planes de Genesis API, las secciones on-chain empiezan en Start, y los libros de órdenes y los datos DEX vienen con Pro y Max.

Los datos de arbitraje cripto responden a cinco preguntas: si hay diferencia de precio, si puedes mover la moneda, si el libro de órdenes tiene profundidad para tu volumen, si el funding paga y qué hacen los grandes jugadores. En Genesis API cada pregunta tiene su propio endpoint y unos pocos campos de respuesta. La primera petición y el sobre success, data, meta se explican en la lección 2; esta lección trata de qué campos leer y en qué orden.

Pregunta del trader → endpoint → campos

PreguntaEndpointCampos
Hay diferencia de precio/arbitrage/*spread_pct, price_buy, price_sell
Puedes mover la monedala misma fila de /arbitrage/spot-spotwithdraw_enabled_buy, deposit_enabled_sell, network, contract
El libro tiene profundidad suficiente/orderbooks/*order_delta.spread_pct, order_delta.status
El funding paga/funding/*spread_pct, interval_1, interval_2, next_payout_1
Qué hacen los grandes jugadores/onchain/*, /market/open-interestdirection, total_usd, oi_change_1h

El asterisco indica un grupo: /arbitrage/* reúne siete endpoints, de Spot – Spot a acciones, mientras que /orderbooks/* y /funding/* reúnen seis cada uno. Las secciones siguientes siguen el orden en que se comprueba un par.

Hay diferencia de precio: spread_pct

Una fila de la documentación de Spot — Spot: FUEL, compra en ByBit a 0,0007029, venta en Gate a 0,0007037, spread_pct 0,11. Comprobación: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11 %. El spread de la fila se calcula a partir de price_buy y price_sell, los precios de las últimas operaciones; en el sitio es la columna Precio.

En los conjuntos de datos DEX – Spot y DEX – Futures el signo importa: el más significa que el token es más barato en el DEX, el menos, que es más caro. Los parámetros y campos de los siete conjuntos están en la guía de endpoints de arbitraje.

spread_pct responde solo a la primera pregunta: no incluye comisiones, transferencia ni libro de órdenes.

Puedes mover la moneda: depósitos, retiros, red y contrato

Un par spot entre exchanges requiere una transferencia: compras la moneda en un exchange, la retiras y la depositas en el otro. Por eso la fila tiene dos flags que leer: withdraw_enabled_buy, si los retiros están abiertos en el exchange de compra, y deposit_enabled_sell, si los depósitos están abiertos en el exchange de venta. La petición no tiene parámetros para ellos, así que tu código filtra las filas.

network y contract indican si se trata del mismo token. Monedas distintas pueden cotizar con un mismo ticker en distintos exchanges, así que compara la dirección del contrato con las páginas de retiro y depósito de ambos exchanges. Los contratos de una moneda por red, y los exchanges que usan cada uno, se obtienen con /coins/search en cualquier plan (Coin Search).

En los conjuntos DEX los flags pertenecen al lado CEX: deposit_enabled y withdraw_enabled. En Cross-chain el token se mueve por un puente entre las redes buy.chain y sell.chain, así que no hay flags de exchange.

El libro de órdenes tiene profundidad: spread de la fila frente a spread tras la ejecución

Una orden de mercado recorre el libro de órdenes: una compra toma asks hacia arriba desde el mejor, una venta toma bids hacia abajo. Cuanto mayor es el volumen, peor es el precio medio y menos queda del spread de la fila. Order-book Δ, /orderbooks/spreads/{dataset} en los planes Pro y Max, devuelve lo que queda para tu volumen (documentación).

Ejemplo ilustrativo: moneda LMN, compra en OKX a 0,4000, venta en Bitget a 0,4060. Spread de la fila: (0,4060 − 0,4000) / 0,4000 × 100 = 1,5 %. Petición a /orderbooks/spreads/spot-spot con coin=LMN y distintos valores de volume:

VolumenCompra → ventaOrder-book ΔEn dólares
00,4002 → 0,40581,3993 %—
500 $0,4004 → 0,40551,2737 %6,37 $
2500 $0,4012 → 0,40410,7228 %18,07 $
10 000 $—exhausted—

volume=0 usa el mejor ask de OKX y el mejor bid de Bitget: las mejores órdenes están peor que las últimas operaciones, así que se pierden 0,1 puntos porcentuales incluso con el volumen más pequeño. Con 2500 $ el precio medio de compra es 0,4012 y el de venta 0,4041: (0,4041 − 0,4012) / 0,4012 × 100 ≈ 0,7228 %. Con 10 000 $ se agotaron los bids de Bitget y order_delta.status es exhausted.

Cada exchange cobra una comisión taker; el ejemplo supone el 0,1 % (maker y taker). Con 2500 $ te quedas con 0,7228 − 2 × 0,1 = 0,5228 %, es decir, 2500 × 0,5228 / 100 ≈ 13,07 $. Las comisiones de retiro no figuran en las respuestas: consúltalas en la página de retiros del exchange y réstalas por separado.

En Trial y Start los endpoints de libros de órdenes devuelven 403 plan_restricted, así que el libro se revisa en el terminal del exchange. El precio de ejecución y el slippage se explican en API de libro de órdenes cripto, y los seis endpoints, en la guía de endpoints de libros de órdenes.

El funding paga: spread, intervalos y pagos

El arbitraje de funding consiste en un short donde la tasa de financiación (funding) es más alta y un long donde es más baja: los movimientos de precio apenas cambian el resultado y se acumula la diferencia de tasas. Los candidatos salen de /funding/spread en cualquier plan: el mejor par de exchanges en best y su spread_pct (Funding spread).

El spread del par no indica cuándo ni con qué frecuencia se paga. interval_1 e interval_2 son los intervalos de funding de los dos exchanges, y next_payout_1 y next_payout_2 son las horas de los próximos pagos en UTC: solo recibe funding una posición abierta en el momento de la liquidación. Las tasas con intervalos distintos se comparan normalizándolas a 8 horas, que es el campo funding_8h_pct de /funding/rates.

Ejemplo ilustrativo: un spread del 0,03 % por 8 horas, con una posición de 5000 $ en cada pierna. Una liquidación aporta 5000 × 0,03 / 100 = 1,5 $. Cuatro operaciones, abrir y cerrar ambas piernas, cuestan 4 × 5000 × 0,1 / 100 = 20 $ con una comisión taker del 0,1 %. Las comisiones se amortizan tras 20 / 1,5 ≈ 13,3 liquidaciones: son 14 liquidaciones de ocho horas, casi cinco días, si las tasas se mantienen.

El historial muestra si la diferencia se mantiene: en Pro y Max, /funding/analytics/summary con coin devuelve, para cada exchange, sum (funding acumulado), cov (cobertura) y flips (cambios de signo) de cada periodo. Los detalles están en API de tasa de financiación (funding) y en la guía de endpoints de funding.

Qué hacen los grandes jugadores: on-chain y open interest

Los datos on-chain y el open interest explican por qué un par puede cerrarse antes de que lo ejecutes. Una moneda que entra en el exchange de venta significa vendedores que llegan antes que tu transferencia. Un open interest al alza significa nuevas posiciones apalancadas, y un movimiento brusco en su contra desencadena liquidaciones.

Qué vesPeticiónCamposPlanes
Flujos de monedas desde y hacia exchanges/onchain/coin-trafficdirection, target, total_usdStart, Pro, Max
Desbloqueos de tokens/onchain/unlocksunlock_value_usd, hours_leftStart, Pro, Max
Open interest por exchange/market/open-interestoi_usd, oi_change_1h, price_change_1hTodos

La respuesta de ejemplo en la documentación de Genesis Onchain muestra 18 transferencias de LAB a Gate por 573 796,98 $ en 5,69 horas, con direction igual a deposit. Si LAB tiene un par que vende en Gate en ese momento, un flujo así es un motivo para reducir el volumen u omitir la entrada. Más en API de datos on-chain y API de open interest.

Frescura de los datos y marcas de tiempo

Cada respuesta lleva su hora: meta.updated_at es el tiempo unix en que se construyó la instantánea, y meta.freshness_sec es el paso de actualización de tu plan: 60 segundos en Trial, 30 en Start, 10 en Pro y 5 en Max. La antigüedad de la instantánea es la hora actual menos updated_at (frescura de los datos).

Ejemplo ilustrativo: plan Trial, la respuesta llegó en 1783802455 y updated_at es 1783802410. La instantánea tiene 1783802455 − 1783802410 = 45 segundos: sus pares se calcularon con precios de casi un minuto atrás y algunos pueden haber desaparecido ya en los exchanges.

Los libros de órdenes tienen su propio reloj: en /orderbooks/book y /orderbooks/coin/{coin} cada libro tiene book_ts, age_sec (su antigüedad en segundos) y stale: true cuando tiene más de 30 segundos. Los libros van con un retraso de 5 a 20 segundos respecto al exchange, así que comprueba la antigüedad de ambas piernas: una diferencia de precio entre un libro reciente y uno antiguo puede ser una diferencia de tiempo.

Por qué un solo campo no basta: la comprobación en cuatro puntos

Cada campo cierra una pregunta, y solo se puede entrar cuando todas están cerradas. Un spread del 3 % con los retiros cerrados deja la moneda atascada en el exchange de compra. Con exhausted tu volumen no se ejecutará. Con una instantánea de 50 segundos, el par puede haber desaparecido ya.

PuntoCamposEl par falla si
1. Diferencia de preciospread_pctel spread menos dos comisiones queda por debajo del umbral
2. Transferenciawithdraw_enabled_buy, deposit_enabled_sell, contractlos retiros o depósitos están cerrados, o el contrato no coincide
3. Libro de órdenesorder_delta.status, order_delta.spread_pctel estado no es ok o lo que queda está por debajo del umbral
4. Frescurameta.updated_at, age_sec, stalela instantánea o un libro es más antiguo que el umbral

La función recibe una fila data de /arbitrage/spot-spot, el objeto order_delta del mismo par de exchanges (None en Trial y Start) y el meta de la respuesta. Los umbrales son ilustrativos: ajústalos a tus comisiones y a tu plan.

import time

FEE = 0.1      # comisión taker supuesta por pierna, %
MIN_NET = 0.3  # al menos 0,3 % tras las comisiones
MAX_AGE = 60   # instantánea de no más de 60 segundos


def check(row, od, meta):
    """Los puntos en los que falló un par Spot – Spot."""
    fails = []
    if row["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("1: el spread no cubre las comisiones")
    if not row["withdraw_enabled_buy"]:
        fails.append("2: retiros cerrados en el exchange de compra")
    if not row["deposit_enabled_sell"]:
        fails.append("2: depósitos cerrados en el exchange de venta")
    if od is None:
        fails.append("3: libro sin comprobar (Trial o Start)")
    elif od["status"] != "ok":
        fails.append("3: libro — " + od["status"])
    elif od["spread_pct"] - 2 * FEE < MIN_NET:
        fails.append("3: queda muy poco tras el libro")
    if time.time() - meta["updated_at"] > MAX_AGE:
        fails.append("4: instantánea más antigua que MAX_AGE segundos")
    return fails

Una lista vacía significa que el par superó los cuatro puntos. El par LMN con 2500 $ lo supera: 1,5 − 0,2 = 1,3 % en la fila, 0,7228 − 0,2 = 0,5228 % tras el libro y una instantánea de 45 segundos. Con 10 000 $ la función devuelve "3: libro — exhausted". El código no puede verificar el contrato: la dirección se comprueba en las páginas de retiro y depósito de los exchanges, y la antigüedad de los libros de ambas piernas sale de /orderbooks/book.

La misma comprobación sobre la tabla del sitio, sin código, está en la lección Spread, profundidad, volumen: cómo leer la tabla, y el sondeo de la API en un bucle, en la lección 4.

Qué datos vienen con cada plan

PlanFrescuraDatos de arbitraje
Trial, 20 $ al mes60 sSpot – Spot, Spot – Futures, Futures – Futures, tasas y spread de funding, open interest, Fair – Last, pumps, búsqueda de monedas
Start, 50 $30 sTodo lo de Trial más acciones, secciones on-chain /onchain/{section}, arbitraje de predicciones en los modos exact y dutch
Pro, 100 $10 sTodos los endpoints: libros de órdenes y Order-book Δ, DEX – Spot, DEX – Futures, Cross-chain, analítica de funding
Max, 200 $5 sLos mismos endpoints que Pro, con 15 peticiones por segundo

Un endpoint fuera de tu plan devuelve 403 plan_restricted, y esa respuesta no consume cuota. Las cuotas de llamadas y los límites de peticiones por segundo están en la página de precios de Genesis API.

Práctica

  1. Toma un par

    En la documentación de Spot — Spot, abre el formulario Probar, pega tu clave y elige una fila con un spread del 1 % o más.

  2. Aplica los puntos 1 y 2

    Resta dos comisiones supuestas del 0,1 % a spread_pct y comprueba withdraw_enabled_buy y deposit_enabled_sell. Compara contract con la respuesta de /coins/search para esta moneda.

  3. Aplica el punto 3

    En Pro o Max, solicita /orderbooks/spreads/spot-spot con esta moneda y volume=1000, y busca la fila con el mismo par de exchanges. En Trial y Start, abre el libro de órdenes en el terminal del exchange.

  4. Aplica el punto 4

    Resta meta.updated_at del tiempo unix actual: date +%s lo muestra en una terminal.

  5. Anota el veredicto

    Qué punto rechazaría primero el par y cuánto del spread quedaría con 1000 $.

Preguntas y respuestas

¿Qué datos hacen falta para el arbitraje de criptomonedas?

Los precios de la moneda en distintos exchanges y el spread entre ellos, el estado de depósitos y retiros con la red y el contrato, los libros de órdenes para calcular la ejecución según tu volumen y la hora de la instantánea. El arbitraje de funding añade tasas, intervalos y horas de pago. En Genesis API eso es /arbitrage/*, /orderbooks/* y /funding/*.

¿Se puede operar a través de Genesis API?

No. Genesis API solo lee datos y no envía órdenes: las operaciones las abres tú mismo en los exchanges.