API de datos de mercado cripto

#Datos de mercado cripto para agentes de IA y LLM

Pregunta a un agente de IA conectado a BytNode «¿Cómo se ha movido BTC en las últimas 24 horas?», «¿Hubo grandes órdenes en ETH esta mañana?» o «Muéstrame las velas horarias de SOL esta semana»: responde con esta familia, mediante la herramienta MCP get_pair_data, sin construir ninguna URL.

{
  "name": "get_pair_data",
  "arguments": {
    "symbol": "BTCUSDT",
    "fields": ["klines", "price_change"],
    "timeframe": "1h",
    "limit": 24
  }
}

• Para el LLM: una vela se fecha por el inicio de su ventana (time, UTC) — la vela horaria de las 14:00 cubre de 14:00 a 15:00 — y las filas llegan de la más reciente a la más antigua.
• Para desarrolladores: ¿construyes tu propio agente de IA? Expón /v1/klines/history como herramienta (tool calling) y el modelo busca las velas por sí solo, o carga las herramientas MCP y evita el adaptador.
• Dónde funciona: Claude, ChatGPT, Cursor y cualquier cliente MCP, incluidos los frameworks de agentes compatibles con MCP, como LangChain o n8n.

Conecta tu agente de IA con la guía del servidor MCP, o enséñale BytNode con los Agent Skills de código abierto.

#Velas OHLCV

Dos rutas: /v1/klines devuelve la última vela CERRADA (un objeto; ?live=1 para la vela en curso, is_closed: false), /v1/klines/history las velas, de la más reciente a la más antigua (los parámetros de abajo). El tamaño de la vela va en timeframe, obligatorio: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w. Ausente o fuera de la lista: 422.

curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/klines/history?symbol=BTCUSDT&timeframe=1h&limit=100"

#Variación de precio

La variación porcentual en las ocho temporalidades, calculada bajo demanda frente al precio de hace un minuto, cinco minutos, una hora, una semana. Una temporalidad sin historial es null, nunca un error.

{
  "status": "ok",
  "server_time": "2026-10-10T08:51:08.454Z",
  "data_type": "price_change",
  "symbol": "BTCUSDT",
  "data": {
    "time": "2026-10-10T08:50:00.000Z",
    "price": 82818.72,
    "changes_pct": {
      "1m": 0.0201927489674, "5m": 0.0452759586592, "15m": -0.0102140384352,
      "30m": -0.0437873393277, "1h": 0.0500741326695, "4h": 0.18183489701,
      "1d": 0.240522875817, "1w": -2.15235074281
    }
  }
}

Es una de las pocas rutas servidas para las stablecoins: en ese caso recurre a los ticks spot.

#Operaciones agregadas por segundo

Una fila por segundo, sumada sobre todos los mercados. El parámetro limit cuenta por tanto segundos, no operaciones.

El mismo reparto compra/venta por minuto o por bucket, para los futuros perpetuos, es el buy_volume / sell_volume de /v1/cvd/futures/history.

#Operaciones individuales y grandes órdenes

Las operaciones individuales (ejecuciones), una por fila, de todos los mercados y sin etiqueta de fuente: las mismas, con el mismo id, que los canales WebSocket trades.spot y trades.futures. limit va de 1 a 10 000. Sin otros parámetros obtienes las últimas operaciones. Para leer un intervalo de tiempo, añade since_ms, until_ms y/o order (asc o desc): una página cubre como máximo 15 minutos, y la respuesta incluye next, la URL de la página siguiente, lista para llamar (null cuando el intervalo está leído). Siguiendo next, cada operación se devuelve una sola vez y en orden. Lo mismo vale para /v1/trades/large, y para /v1/trades-kline/futures/seconds por páginas de limit segundos.

El mismo flujo de futuros, filtrado por tamaño: la lectura de la cinta, para detectar las órdenes que importan.

# The last fifty orders above $250,000
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/trades/large?symbol=BTCUSDT&min_usd=250000&limit=50"

#Velas de operaciones (trades kline)

Velas construidas sobre las operaciones en lugar del precio — una «trades kline»: cuántas órdenes pasaron, en qué dirección y por qué importe, siempre agregadas sobre todos los mercados. Las operaciones individuales son /v1/trades/spot y /v1/trades/futures.

Cada ruta tiene su historial: /v1/trades-kline/history, /v1/trades-kline/spot/history, /v1/trades-kline/futures/history.

# The 5-minute trade candle in progress
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/trades-kline?symbol=BTCUSDT&timeframe=5m&live=1"