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_sellyspread_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:
- API de exchange: datos y acceso a la cuenta de una sola plataforma. El exchange sirve precios, libros de órdenes y operaciones de forma pública, mientras que los saldos, las órdenes y el historial de operaciones requieren una clave y una petición firmada. Binance lo define como tipos de seguridad:
NONEpara datos de mercado abiertos,TRADEpara colocar y cancelar órdenes,USER_DATApara los datos de la cuenta (documentación de Binance). - API de datos de mercado: muchos exchanges y redes en un único formato. Sirve lo que exige combinar plataformas: spreads entre exchanges, tasas de funding normalizadas a un mismo periodo, open interest por exchange. Genesis API es de este tipo y solo lee datos.
- API on-chain: datos de la blockchain, como transacciones, transferencias de tokens y saldos de direcciones. Etiquetas como «exchange», «equipo del proyecto» o «ballena» provienen de servicios de análisis construidos sobre los datos de la red.
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.
| Tarea | Qué hace el programa | Datos de Genesis API |
|---|---|---|
| Seguimiento de spreads | Pares por encima de un umbral con depósitos y retiradas abiertos | /arbitrage/spot-spot, /arbitrage/spot-futures |
| Funding | Compara las tasas de los exchanges normalizadas a 8 horas | /funding/rates, /funding/spread |
| Open interest | Detecta cambios bruscos del OI entre 5 minutos y 1 hora | /market/open-interest |
| Alertas | Te avisa en Telegram cuando se cumple una condición | Cualquier endpoint de datos |
| Registro | Guarda cada par que encuentra con su marca de tiempo | La respuesta y meta.updated_at |
| Panel | Muestra tus columnas y umbrales en tu propia página | Peticiones desde tu servidor |
| Investigación histórica | Busca 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
| Tarea | Mejor opción | Por qué |
|---|---|---|
| Ver pares y gráficos | Sitio de Genesis Arbitrage | Tablas y filtros, sin código |
| Señales sin programar | Alertas de Telegram en el sitio | Umbrales definidos en la interfaz |
| Tus propias reglas en más de 20 exchanges | Genesis API | Spreads calculados, un único formato |
| Órdenes, saldos, retiradas | API del exchange | Solo el exchange acepta órdenes |
| Cada operación en tiempo real | WebSocket del exchange | Genesis API sirve instantáneas cada 60–5 s |
| Velas pasadas | API del exchange | Genesis API no tiene velas |
| Historial de funding en 13 exchanges | Genesis API, Pro y Max | Hasta 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
- Una clave de Genesis API: elige un plan en la página de precios y obtén la clave con el botón «Obtener clave» de tu perfil; los pasos están en el inicio rápido de Genesis API. Guarda la clave en la variable de entorno
GENESIS_API_KEYy nunca la pongas en la URL de una petición. - curl para tus primeras peticiones desde la terminal.
- Python 3.10+ y la biblioteca
requests(pip install requests) para los scripts de las lecciones 2 y 4. - La documentación de Genesis API: cada endpoint tiene sus parámetros, campos, un ejemplo de curl y un formulario «Probar» que envía la petición directamente desde la página.
Las lecciones se apoyan unas en otras:
- lección 2: tu primera petición, con la dirección, los encabezados, los códigos de estado y JSON;
- lección 3: qué datos sirven para qué decisiones, desde spreads y libros de órdenes hasta funding y flujos on-chain;
- lección 4: un monitor de spreads y funding en Python;
- lección 5: riesgos de la automatización, entre ellos datos obsoletos, errores, claves y agentes de IA.
Pruébalo tú mismo
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.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.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.
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
coinymin_spread. Enviarás esa petición en la lección 2.