API de criptomonedas: tipos de API de datos de mercado cripto y cómo elegir una para operar
En resumen
- Una API de criptomonedas da a tu código datos de mercado: precios, libros de órdenes, tasas de financiación, transacciones on-chain y cotizaciones de mercados de predicción. La API de un exchange cubre una plataforma y envía órdenes con una clave; una API de datos de mercado reúne muchas plataformas en un solo formato.
- Elige una API según nueve criterios: cobertura de plataformas y cadenas, frescura, normalización de campos, estado de depósitos y retiros, profundidad del libro de órdenes, rate limits, precio, documentación y condiciones de uso de los datos.
- Genesis API es una API REST de solo lectura: CEX, DEX, on-chain, mercados de predicción y surebets de casas de apuestas en un único formato JSON, con planes desde 20 $ al mes. No envía órdenes.
Una API de criptomonedas es una interfaz de programación con la que el código lee datos de mercado cripto o envía órdenes a un exchange: precios, libros de órdenes, tasas de financiación (funding), transacciones de la blockchain, cotizaciones de mercados de predicción. Los tipos de API difieren en alcance: la API de un exchange conoce una sola plataforma y envía órdenes con una clave, una API de datos de mercado reúne muchas plataformas en un solo formato y una API on-chain lee la blockchain.
Tipos de API de criptomonedas
| Tipo de API | Qué ofrece | Cuándo la necesitas |
|---|---|---|
| API de exchange | Precios, libros de órdenes y operaciones de un exchange; órdenes con una clave | Operar en ese exchange, flujo de operaciones de un par |
| API de datos de mercado | Muchos exchanges en un solo formato, spreads ya calculados | Comparar exchanges, escáneres, alertas |
| API on-chain | Transacciones, transferencias, saldos, eventos de contratos | Ballenas, flujos de exchanges, desbloqueos |
| API de DEX | Precios y liquidez de pools, swaps, slippage | Tokens que no están en CEX, estrategias DEX – CEX |
| Datos de derivados | Funding, interés abierto, precios de futuros | Arbitraje de funding, sesgo de posiciones |
| APIs de mercados de predicción y de cuotas | Precios YES y NO, libros de órdenes, cuotas de casas de apuestas | Arbitraje de mercados de predicción, surebets |
API de exchanges
La API de un exchange cripto es la interfaz de una sola plataforma y tiene dos partes. La parte pública ofrece datos de mercado sin clave: en Binance estos endpoints tienen el tipo de seguridad NONE, y GET /api/v3/ticker/price devuelve el precio de un par. La parte privada —órdenes, saldos, historial de operaciones— necesita una clave API y una firma de la petición; en Binance son los tipos TRADE y USER_DATA (documentación de Binance).
Una API así cubre un solo exchange: para comparar el precio de una moneda en 20 exchanges hacen falta 20 conexiones con formatos y límites distintos.
APIs de datos de mercado
Una API de datos de mercado recopila datos de muchos exchanges, los normaliza y los devuelve en una sola petición. La respuesta ya contiene lo que cuesta reunir entre plataformas: spreads entre exchanges, tasas de funding normalizadas a un mismo período, interés abierto por exchange.
APIs on-chain
Una API on-chain lee la blockchain: transacciones, transferencias de tokens, saldos de direcciones, eventos de contratos inteligentes. La capa inferior es un nodo de la red: todos los clientes de Ethereum hablan JSON-RPC, donde eth_getBalance devuelve un saldo en wei como número hexadecimal y eth_getLogs devuelve los eventos de contratos que cumplen un filtro.
Un nodo no sabe qué direcciones pertenecen a un exchange, a un equipo o a una ballena; los indexadores y los servicios de analítica on-chain añaden esas etiquetas. Qué datos necesita un trader se explica en API de datos on-chain.
APIs de DEX
Una API de DEX ofrece precios y liquidez de pools en exchanges descentralizados, swaps y slippage. Cuanto mayor es un swap respecto a la liquidez del pool, más mueve el precio, así que una estrategia DEX – CEX necesita el slippage para tu tamaño, y los tokens nuevos requieren el impuesto del token y una comprobación de honeypot. Más en API de DEX.
Datos de derivados: funding e interés abierto
Los futuros perpetuos requieren la tasa de funding, el interés abierto (el volumen de posiciones abiertas) y el precio del futuro junto al spot. Los exchanges liquidan el funding cada 8, 4 o 1 hora, por lo que las tasas se comparan tras normalizarlas a un mismo período. Más en API de tasas de funding y API de interés abierto.
APIs de mercados de predicción y de cuotas
Las plataformas de predicción ofrecen precios de contratos YES y NO y libros de órdenes. En Polymarket los datos públicos de mercado no requieren credenciales, mientras que una orden exige autenticación y una firma de la wallet (documentación de Polymarket).
Los formatos también difieren aquí: el libro de órdenes de Kalshi solo contiene bids, y el ask de YES es 1 $ menos el mejor bid de NO, de modo que un bid de NO de 0,56 $ implica un ask de YES de 0,44 $ (documentación de Kalshi). Las cuotas de las casas de apuestas se comparan con los precios YES y NO mediante la probabilidad implícita; consulta API de Polymarket y API de Kalshi y API de apuestas deportivas.
REST y WebSocket
Una API REST responde a una petición con una instantánea filtrada como tú pidas, y las actualizaciones se obtienen con polling periódico.
Un WebSocket mantiene la conexión abierta y el servidor envía cada operación y cada cambio del libro de órdenes. A cambio, debes procesar el flujo sin huecos, reconectar tras las caídas y reconstruir el libro a partir de una instantánea más actualizaciones, y Kalshi exige autenticación para conectarse incluso a los canales públicos. Las reacciones por debajo del segundo requieren un WebSocket; los escáneres y las alertas sobre más de 20 exchanges funcionan con REST.
Genesis API es solo REST, sin WebSocket ni webhooks: cada petición es un GET, las respuestas se comprimen con gzip en JSON y los datos se actualizan cada meta.freshness_sec segundos. Si repites una petición del conjunto completo sin filtros con el ETag anterior en If-None-Match, obtienes un 304 sin cuerpo cuando nada ha cambiado, y esa respuesta no consume cuota. Los patrones de polling están en Buenas prácticas de polling de API.
Cómo elegir una API de criptomonedas: lista de criterios
Los seis primeros criterios se ven en una respuesta real de la API; el resto está en la documentación y los precios.
| Criterio | Qué comprobar |
|---|---|
| Cobertura de plataformas y cadenas | Tus exchanges, spot y futuros, DEX y cadenas |
| Frescura y latencia | Hora de construcción en la respuesta, paso de actualización, antigüedad del libro de órdenes |
| Normalización de campos | Tickers, unidades, porcentajes y hora coherentes |
| Estado de depósitos y retiros | Indicadores de depósito y retiro por exchange y red |
| Profundidad del libro de órdenes | Precio de ejecución para tu tamaño |
| Rate limits y cuotas | Peticiones por segundo, llamadas por período, qué cuenta como llamada |
| Precio | Plan o pago por llamada, qué ocurre al superar el límite |
| Documentación y OpenAPI | Ejemplos de petición y respuesta, una especificación |
| Condiciones de uso de los datos | Si puedes crear tu propio producto con los datos |
Cobertura y frescura
Comprueba la cobertura con tu propia lista: si tu bot trabaja con MEXC y Gate, una API que no tenga alguno de los dos no sirve. La frescura de los datos es cuántos segundos han pasado desde que se construyó la instantánea; la latencia es todo el camino desde una operación en el exchange hasta tu código. Con una instantánea de un minuto, un bot ve spreads que ya no existen.
Normalización de campos
El mismo par BTC/USDT se escribe de forma distinta en las APIs de los exchanges: BTCUSDT en Binance, BTC-USDT en OKX (el perpetuo es BTC-USDT-SWAP), BTC_USDT en Gate. Binance devuelve los precios como cadenas ("price": "4.00000200" en el ejemplo de su documentación) y la hora en milisegundos. Tu código tiene que gestionar cada una de estas diferencias.
Una API de datos de mercado unifica los campos, como en esta entrada de /funding/rates de la documentación de Genesis API:
{
"coin": "TON",
"exchanges": [
{
"exchange": "MEXC",
"funding_pct": 0.02,
"funding_8h_pct": 0.04,
"next_payout": "00:00",
"interval": "4h",
"price": 2.184,
"trade_url": "https://futures.mexc.com/exchange/TON_USDT"
}
]
}
MEXC liquida el funding de esta moneda cada 4 horas, y la tasa de 0,02 % por intervalo se normaliza a 8 horas en funding_8h_pct: 0,02 × 8 / 4 = 0,04 % (consulta Tasas de funding).
Estado de depósitos y retiros
Una operación spot entre exchanges solo es ejecutable si la moneda puede retirarse del exchange de compra y depositarse en el de venta. En Binance, los estados de las redes salen de GET /sapi/v1/capital/config/getall, un endpoint USER_DATA firmado que necesita la clave API de tu cuenta (documentación de Binance). En Genesis API los estados llegan en cada fila de Spot – Spot como withdraw_enabled_buy y deposit_enabled_sell (documentación de Spot — Spot).
Profundidad del libro de órdenes
El spread a los mejores precios muestra la distancia en la parte superior del libro, mientras que una operación de 5000 $ recorre varios niveles de la profundidad de mercado. En el ejemplo de la documentación de Genesis API para /orderbooks/spreads/spot-futures, el spread de BTC es 0,031 % a los mejores precios y 0,0202 % tras recorrer los libros con 5000 $. El endpoint Precios de ejecución devuelve precios de ejecución para 500–10 000 $; más en API de libro de órdenes cripto.
Límites, precio y documentación
Los límites se cuentan de formas distintas. En Binance cada endpoint tiene un peso, las peticiones sobre muchos símbolos pesan más, y una IP que sigue enviando peticiones tras un 429 queda bloqueada entre 2 minutos y 3 días (límites de Binance). Para una API de datos, comprueba la cuota de llamadas, el rate limit por segundo y qué cuenta como llamada: en Genesis API solo una respuesta 200 consume cuota.
El precio es un plan con cuota o pago por llamada; averigua qué pasa al superar el límite: un error 429 o cargos adicionales. Una especificación OpenAPI es una descripción legible por máquina de la API para generar un cliente y conectar agentes de IA, y las condiciones de uso indican si puedes crear un producto con los datos y qué no puedes revender.
Comprobación con una sola petición
Este script descarga el conjunto completo de Spot – Spot (disponible en todos los planes de Genesis API) y, con una sola respuesta, comprueba la cobertura, la antigüedad de la instantánea y la proporción de operaciones transferibles:
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
r = requests.get(BASE + "/arbitrage/spot-spot",
headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]
# Cobertura: qué exchanges aparecen en las operaciones
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))
# Frescura: antigüedad de la instantánea y paso de actualización del plan
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")
# Transferencia: retiros abiertos en compra, depósitos abiertos en venta
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")
Los reintentos ante 429 y 503 vienen de la función get_json de Respuestas y errores de Genesis API. Después, comprueba los precios y estados de 3–5 operaciones en los exchanges mediante trade_url_buy y trade_url_sell.
Crearla tú mismo o usar una API ya hecha
Para uno o dos exchanges más operativa, lo natural es tu propio código sobre sus APIs. Para 20 exchanges con spot y futuros, eso supone hasta 40 conectores de datos de mercado: en Binance, spot y futuros USDⓈ-M son APIs distintas, api.binance.com y fapi.binance.com. Cada conector incluye instantáneas REST, un flujo WebSocket con reconexiones, sus propios límites y su formato de símbolos, y encima viene la unificación: las monedas se emparejan por contrato y red, porque un mismo ticker puede ser tokens distintos en distintos exchanges.
| Tarea | Código propio sobre APIs de exchanges | Genesis API |
|---|---|---|
| Enviar órdenes | La única vía: la API de trading del exchange | No, solo lectura |
| Cada operación de un par | WebSocket del exchange | No, instantáneas cada 60–5 s |
| Spreads en más de 20 exchanges | Hasta 40 conectores más la unificación | Una petición |
| Estado de depósitos y retiros | Un endpoint por exchange, con clave en Binance | Campos en la fila de la operación |
| DEX, on-chain, mercados de predicción | Nodos, indexadores, APIs de las plataformas | El mismo formato JSON |
Los enfoques se combinan: una API de datos encuentra las operaciones y la operación se abre en el exchange a mano o a través de su API de trading con una clave sin permiso de retiro (consulta Cómo proteger tu cuenta de exchange cripto). Un bot con alertas de Telegram se construye en Bot de arbitraje cripto en Python.
Dónde encaja Genesis API
Genesis API es la API REST de los datos de Genesis Arbitrage: CEX, DEX, on-chain, mercados de predicción y surebets de casas de apuestas en un único formato JSON, con la clave en la cabecera X-API-Key. Ofrece los mismos datos que publica el sitio a través de más de 35 endpoints (37 operaciones en la especificación) y solo lee datos.
| Datos | Endpoint de ejemplo | Planes de API |
|---|---|---|
| Spreads CEX | /arbitrage/spot-spot | Todos |
| DEX y cross-chain | /arbitrage/dex-spot | Pro, Max |
| Libros de órdenes | /orderbooks/exec | Pro, Max |
| Funding e interés abierto | /funding/rates | Todos |
| On-chain | /onchain/{section} | Start, Pro, Max |
| Mercados de predicción y surebets | /predictions/arbitrage | Start: exact, dutch; Pro, Max: llm, sport |
Cobertura: más de 20 exchanges CEX (Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, Kraken, WhiteBit, Coinbase, CoinW, edgeX, HTX, Hyperliquid y otros), funding de más de 1000 monedas normalizado a 8 horas, interés abierto en más de 13 exchanges de futuros. Los mercados de predicción son Polymarket, Kalshi, Limitless, Predict.fun y Opinion; el modo sport construye surebets de casas de apuestas en 13 plataformas, solo prepartido.
| Plan | Llamadas al mes | Peticiones por segundo | Frescura |
|---|---|---|---|
| Trial, 20 $/mes | 500 K | 1 | 60 s |
| Start, 50 $ | 2 M | 2 | 30 s |
| Pro, 100 $ | 5 M | 5 | 10 s |
| Max, 200 $ | 10 M | 15 | 5 s |
Los planes de API son independientes de la suscripción al sitio; se paga en cripto, con un 10 % de descuento por 3 meses y un 20 % por 6. Al superar los límites el servidor devuelve 429 y no cobra nada, y un endpoint fuera de tu plan devuelve 403 plan_restricted. Compara los planes en Precios de Genesis API; las reglas están en Planes y límites.
Cada sección de la documentación tiene su propia URL con parámetros, campos, un ejemplo de curl y un formulario Probar. Para programas y agentes de IA hay una especificación OpenAPI 3.1 y la referencia llms-full.txt; la configuración se explica en Genesis API para agentes de IA. Puedes crear tus propios servicios, bots y paneles sobre Genesis API; no puedes revender los datos en bruto tal cual.
La primera petición —un plan, una clave en tu perfil y un GET con X-API-Key— se explica en el inicio rápido, y los fundamentos en la lección Qué es una API de criptomonedas y qué puedes automatizar. Sin código, los mismos datos están en las tablas del sitio y en las alertas de Telegram.
Preguntas y respuestas
¿Existe una API de criptomonedas gratuita?
Sí: las APIs públicas de los exchanges ofrecen precios, libros de órdenes y operaciones gratis y sin clave (en Binance, los endpoints NONE), pero cada una cubre un solo exchange. Genesis API no tiene plan gratuito: Trial cuesta 20 $ al mes por 500 K llamadas.
¿Necesito un SDK para usar una API de criptomonedas?
Para una API REST basta un cliente HTTP: curl, requests en Python o fetch en JavaScript. Genesis API no tiene SDK oficial, y cada petición es un GET con una sola cabecera; puedes generar un cliente tipado a partir de la especificación OpenAPI 3.1.
¿Puedo operar a través de una API de datos de mercado?
No si la API es de solo lectura, como Genesis API: encuentra operaciones pero no envía órdenes. Las órdenes pasan por el exchange, a mano o con su API de trading mediante una clave y una firma (en Binance, endpoints TRADE), lo cual queda fuera de Genesis API y corre por tu cuenta y riesgo.
¿Cómo obtengo el precio de una criptomoneda desde una API?
El endpoint público de un exchange devuelve el precio de un par en ese exchange: en Binance es GET /api/v3/ticker/price, y el precio llega como cadena. Los precios de una moneda en todos los exchanges, con el estado de depósitos y retiros, se obtienen de /coins/search?query=BTC en Genesis API (consulta Búsqueda de monedas).