Primeros pasos

Guía rápida

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 en una sola llamada.

#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 (precio y volumen, derivados, indicadores, macro) sin tarjeta: 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.

#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_KEY="your_key"

curl -H "X-API-KEY: $BYTNODE_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

Respuesta
{
  "status": "ok",
  "timestamp": 1775648290510,
  "data_type": "funding_rate_8h",
  "data": {
    "bucket": "2026-08-29T08:00:00+00:00",
    "rate": 0.000082,
    "apr": 0.08979,
    "exchange_count": 7
  }
}

Las cuatro claves del sobre

  • status: ok o error.
  • timestamp: el instante en que se produjo la respuesta, en milisegundos. No es la marca de tiempo del dato: el dato lleva su propio timestamp o su bucket.
  • data_type: el nombre del tipo devuelto. Permite enrutar una respuesta sin depender de la ruta llamada.
  • data: la carga útil, que es un objeto, una lista o null cuando no hay nada disponible.

Lo que dice esta respuesta en concreto

  • bucket abre la ventana de ocho horas sobre la que se calculó la tasa, alineada en 00:00, 08:00 y 16:00 UTC.
  • apr anualiza la tasa, aquí alrededor del 9 % anual.
  • exchange_count indica sobre cuántos mercados se construyó el compuesto. Ese número varía de una ventana a otra: es una información, no una constante.

#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 de minutos según el campo, true para los campos que solo tienen un valor actual.

curl
Veinticuatro velas horarias, el funding, una hora de delta del interés abierto, dos horas de liquidaciones, el CVD horario y el índice de sentimiento.
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT\
&klines_1h=24\
&funding_rate_8h=true\
&oi_delta=60\
&liq_cumulative=120\
&cvd@1h=24\
&fear_greed=true"

Los campos multitemporalidad se piden con el sufijo @tf (cvd@1h), y la clave vuelve sin cambios en la respuesta. El detalle de los sesenta y un campos, junto con las claves unavailable y coverage que acompañan la respuesta, está en la página Snapshot.

#Y después

AutenticaciónDónde poner la clave en cada uno de los tres canales y cómo rotarla sin interrupción.ConvencionesSímbolos, temporalidades, agregación, velas cerradas: las reglas que valen en todas partes.Catálogo de endpointsTodo lo que se puede llamar, en una sola página.Flujo WebSocketPasar de la consulta periódica a la escucha continua, en cuatro canales.