Genesis Arbitrage

Genesis Arbitrage · · 10 min de lectura

Qué es una API de criptomonedas y qué se puede automatizar

En resumen

  • Una API de criptomonedas es una interfaz de programación con la que tu programa pide datos de mercado y recibe una respuesta JSON: el mismo spread que ves en la tabla del sitio, entregado en los campos exchange_buy, exchange_sell y spread_pct.
  • La API de un exchange cubre los datos y la cuenta de una sola plataforma, una API de datos de mercado reúne muchos exchanges en un único formato y una API on-chain lee la blockchain. Genesis API es una API de datos de mercado de solo lectura.
  • Con una API, el trader automatiza el seguimiento de spreads, funding y open interest, las alertas, el registro de señales, los paneles y la investigación histórica.
  • Sin experiencia, deja manuales la ejecución de operaciones y las retiradas: las instantáneas de datos van con retraso respecto al exchange y un error en tu código se repite en cada ciclo.

Una API de criptomonedas es una interfaz de programación que tu código usa para pedir datos del mercado cripto y recibir una respuesta con la que puede trabajar: precios, spreads entre exchanges, tasas de financiación (funding), open interest. Una persona lee estas cifras en una tabla; un programa las recibe como campos JSON y puede compararlas con un umbral, registrarlas o enviar una alerta al instante. La definición general está en la entrada del glosario API.

Petición y respuesta

Trabajar con una API es un intercambio de dos mensajes: tu programa envía una petición a una dirección y el servidor devuelve una respuesta. El ejemplo más corto es la comprobación del estado de Genesis API, que no necesita clave:

curl "https://api.genesisarbitrage.com/health"
{"ok":true}

curl es un programa de línea de comandos para peticiones HTTP; curl --version indica si está instalado. Las peticiones de datos requieren una clave API, una cadena con la que el servidor identifica tu cuenta y tu plan. Un ejemplo ilustrativo: pares Spot – Spot de la moneda FUEL, con la clave tomada de la variable de entorno GENESIS_API_KEY:

URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
  "success": true,
  "data": [
    {
      "coin": "FUEL",
      "exchange_buy": "ByBit",
      "exchange_sell": "Gate",
      "price_buy": 0.0007029,
      "price_sell": 0.0007037,
      "spread_pct": 0.11,
      "withdraw_enabled_buy": true,
      "deposit_enabled_sell": true,
      …
    }
  ],
  "meta": {
    "count": 1,
    "updated_at": 1794675861,
    "freshness_sec": 60,
    "plan": "trial"
  }
}

La respuesta contiene un par: comprar FUEL en ByBit a 0,0007029 y venderlo en Gate a 0,0007037. El spread ya viene calculado en spread_pct: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11 %. Los flags withdraw_enabled_buy y deposit_enabled_sell indican que las retiradas desde ByBit y los depósitos en Gate están abiertos, y meta.updated_at dice cuándo se generó la instantánea. La tabla Spot – Spot muestra las mismas cifras y cada campo se describe en la sección Spot — Spot de la documentación.

La dirección de la petición se compone de una URL base, la ruta de un endpoint y parámetros, mientras que la clave viaja aparte, en el encabezado X-API-Key. La lección 2 desmonta cada parte de la petición, explica los códigos de estado y la lectura de JSON, y muestra cómo definir la variable de la clave.

Este tipo de intercambio, una petición seguida de una respuesta con una instantánea de datos, se llama REST API. Para obtener datos nuevos se envía la petición otra vez: Genesis API actualiza su salida cada meta.freshness_sec segundos, desde 60 en Trial hasta 5 en Max. Los exchanges ofrecen además un segundo canal, WebSocket: la conexión permanece abierta y el servidor envía operaciones y cambios del libro de órdenes en cuanto ocurren, como en los streams de Binance. Genesis API no tiene WebSocket.

Tipos de API de criptomonedas

Las API de criptomonedas se distinguen por el origen de los datos y por lo que se puede hacer con ellas:

Una comparación de seis tipos de API, REST frente a WebSocket y una lista de nueve puntos para elegir están en la guía tipos de API de criptomonedas y cómo elegir una.

Qué puede automatizar un trader

Automatiza lo que repites con una regla fija: abrir una tabla, comparar una cifra con un umbral, anotar el resultado. Un programa lo hace según un calendario y no se salta las horas de la noche.

TareaQué hace el programaDatos de Genesis API
Seguimiento de spreadsPares por encima de un umbral con depósitos y retiradas abiertos/arbitrage/spot-spot, /arbitrage/spot-futures
FundingCompara las tasas de los exchanges normalizadas a 8 horas/funding/rates, /funding/spread
Open interestDetecta cambios bruscos del OI entre 5 minutos y 1 hora/market/open-interest
AlertasTe avisa en Telegram cuando se cumple una condiciónCualquier endpoint de datos
RegistroGuarda cada par que encuentra con su marca de tiempoLa respuesta y meta.updated_at
PanelMuestra tus columnas y umbrales en tu propia páginaPeticiones desde tu servidor
Investigación históricaBusca patrones en datos pasados/funding/analytics/daily (Pro, Max)

Las alertas suelen ser un primer proyecto: el programa consulta un endpoint no más a menudo que meta.freshness_sec y te avisa cuando un spread o una tasa cruza tu umbral. Sin código, señales parecidas ofrecen las alertas de Telegram de Genesis Arbitrage en el plan Pro del sitio.

Un registro permite probar una idea antes de arriesgar dinero. Un ejemplo ilustrativo: un bot anota los pares con un spread de 1 % o más cada 30 segundos, es decir, 86 400 / 30 = 2880 instantáneas al día. Muestran cuántos pares duraron más de un minuto y cuántos habían desaparecido en la siguiente consulta.

Para el historial, Genesis API ofrece la analítica de funding, con hasta un año de sumas diarias del funding liquidado en 13 exchanges, y el historial de slippage del libro de órdenes; ambos están en los planes Pro y Max. Genesis API no tiene velas históricas: las sirven las API de los exchanges, en Binance mediante GET /api/v3/klines con hasta 1000 velas por petición (documentación de Binance). Tu programa construye por sí mismo el historial de spreads entre exchanges a partir de las instantáneas de su registro.

Qué no automatizar sin experiencia

Dos operaciones salen caras cuando fallan: la ejecución de operaciones y las retiradas.

Ejecución de operaciones

Un bot que coloca órdenes mediante la API de trading de un exchange se equivoca tantas veces como se ejecuta: un error en la condición de entrada con consultas cada 10 segundos produce 3600 / 10 = 360 órdenes por hora. Los datos también llegan con retraso: una instantánea de Genesis API se actualiza cada 60 a 5 segundos según el plan, los libros de órdenes van entre 5 y 20 segundos por detrás del exchange y el spread puede cerrarse en ese tiempo. Genesis API no coloca órdenes: encuentra los pares y tú abres la operación en el exchange.

Retiradas

Una clave de exchange con permiso de retirada permite a cualquiera que la consiga sacar fondos de la cuenta, de modo que la filtración de una clave así puede costar todo el saldo. Los bots que leen datos o hacen trading no necesitan este permiso. En Binance, una clave API nueva ni siquiera puede operar por defecto: el permiso de trading se activa por separado.

Sitio, API de exchanges o Genesis API

TareaMejor opciónPor qué
Ver pares y gráficosSitio de Genesis ArbitrageTablas y filtros, sin código
Señales sin programarAlertas de Telegram en el sitioUmbrales definidos en la interfaz
Tus propias reglas en más de 20 exchangesGenesis APISpreads calculados, un único formato
Órdenes, saldos, retiradasAPI del exchangeSolo el exchange acepta órdenes
Cada operación en tiempo realWebSocket del exchangeGenesis API sirve instantáneas cada 60–5 s
Velas pasadasAPI del exchangeGenesis API no tiene velas
Historial de funding en 13 exchangesGenesis API, Pro y MaxHasta un año de sumas diarias, un único formato

Una configuración práctica para empezar: Genesis API encuentra un par, tu bot envía una alerta y tú revisas el libro de órdenes del exchange y abres la operación. Los planes de Genesis API van desde Trial a 20 $ al mes (500K llamadas, frescura de 60 s) hasta Max a 200 $ (10M, 5 s), y no hay plan gratuito. Compáralos en la página de precios de Genesis API.

Qué necesitarás en el resto del curso

Las lecciones se apoyan unas en otras:

Pruébalo tú mismo

  1. Envía una petición sin clave

    Ejecuta curl "https://api.genesisarbitrage.com/health" en una terminal. La respuesta {"ok":true} significa que la petición llegó y el servidor respondió en JSON.

  2. Relaciona la tabla con los campos

    Abre la tabla Spot – Spot y la sección Spot — Spot de la documentación. Encuentra los campos de exchanges, precios, spread y estado de las transferencias: exchange_buy, price_sell, spread_pct, withdraw_enabled_buy.

  3. Haz una lista de tus tareas rutinarias

    Toma tres cosas que haces cada día y marca cada una con la tabla anterior: sitio, Genesis API o API del exchange.

  4. Encuentra el endpoint para una tarea

    Para una tarea de Genesis API, busca el endpoint en la documentación y anota los parámetros que necesitas, como coin y min_spread. Enviarás esa petición en la lección 2.