Guía rápida: primera llamada o agente de IA
Tres minutos, una clave y una petición. Esta página va de la creación de la cuenta a la lectura de la primera respuesta, y después muestra cómo obtener varias familias de datos de mercado en una sola llamada. Para dar los datos a un agente de IA, conéctalo al servidor MCP: sin código que escribir.
#Obtener una clave
Crea una cuenta: tu primera clave se genera automáticamente y te espera en la consola. El plan gratuito abre cuatro familias de datos de mercado (precio y volumen, derivados, indicadores, macro) y 10.000 peticiones al mes: suficiente para saber en una tarde si los datos te convienen.
La clave aparece oculta en la consola: muéstrala o cópiala cuando la necesites y guárdala en un gestor de secretos o en una variable de entorno. Si se ve comprometida, una rotación la sustituye.
Una sola clave para todos los canales: tu código llama a REST y al flujo WebSocket con ella, y el servidor MCP la acepta para tus agentes de IA, con el mismo plan.
#La primera llamada
El funding compuesto de Bitcoin, agregado sobre todos los mercados que lo publican y llevado a una base de ocho horas.
export BYTNODE_API_KEY="your_key"
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
"https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT"Solo dos cosas son obligatorias: la cabecera X-API-KEY y el parámetro symbol. No hay símbolo por defecto. Una petición sin símbolo se rechaza en lugar de servirse con Bitcoin, que no es necesariamente lo que querías.
#Leer la respuesta
{
"status": "ok",
"server_time": "2026-11-08T12:51:38.169Z",
"data_type": "funding_rate",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T00:00:00.000Z",
"period_end_at": "2026-11-08T08:00:00.000Z",
"settled_at": "2026-11-08T08:00:00.009Z",
"rate_pct": 0.00825097837214,
"apr_pct": 9.0348213175,
"is_closed": true
}
}Las claves del sobre
status:okoerror.server_time: el instante en que se produjo la respuesta, en ISO 8601. No es la hora del dato: el dato lleva su propiotime.data_type: el nombre del tipo devuelto. Permite enrutar una respuesta sin depender de la ruta llamada.symbol,timeframe,market…: el recordatorio de la petición (aquímarket: "futures", el único mercado del funding), presentes cuando la ruta los tiene, para que una respuesta guardada se pueda leer sin la petición que la produjo.data: la carga útil, que es un objeto, una lista onullcuando no hay nada disponible.
Lo que dice esta respuesta en concreto
timeabre la ventana de ocho horas a la que se aplica la tasa, alineada en 00:00, 08:00 y 16:00 UTC;period_end_atla cierra, ysettled_ates la liquidación que la pagó.rate_pctes la tasa de la ventana, en porcentaje;apr_pctla anualiza (rate_pct × 1095 liquidaciones de 8 horas al año).timees la única clave de tiempo de cada objeto con marca de tiempo (aquí el inicio de la ventana de funding), para que un cliente genérico lea una sola clave;is_closed: trueindica que el valor es definitivo y no cambiará.
#Varias familias en una petición
Llamar a diez endpoints para llenar un panel es un desperdicio: /v1/snapshot hace el trabajo en un solo viaje. Cada parámetro es un nombre de campo y su valor es la profundidad solicitada: un número de filas, o 1 (o true) para obtener solo el último valor. El snapshot está incluido a partir del plan Traders.
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
"https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT\
&klines@1h=24\
&funding_rate=1\
&oi_change=1\
&liquidations_cumulative=1\
&cvd@1h=24\
&buy_sell_ratio@1h=24"Los campos multitemporalidad se piden con el sufijo @tf (cvd@1h), y la clave vuelve sin cambios en la respuesta. El detalle de los cuarenta y ocho campos, junto con la clave unavailable que acompaña a la respuesta, está en la página Snapshot.
Un agente de IA obtiene los mismos campos en una llamada MCP: la herramienta get_pair_data sirve los campos del snapshot de un par en una sola petición, o de hasta diez pares comparados lado a lado. Ver el servidor MCP.