Convenciones

#Símbolos

Se siguen veintidós activos: veinte perpetuos USDT-M y dos stablecoins, estas últimas solo en spot. La lista viva la sirve /v1/symbols, y esa es la que manda.

#Temporalidades

En las rutas por intervalos, siete valores:

1m5m15m30m1h4h1d

Los indicadores técnicos aceptan un octavo, la semana, porque se calculan directamente sobre las velas:

1m5m15m30m1h4h1d1w

Dos excepciones que recordar:

• El ratio largo/corto rechaza 1m: ningún mercado publica un ratio de cuenta global en esa temporalidad.
• Los instrumentos macro intradía rechazan 30m y cinco de ellos solo se sirven en 1d. El catálogo de la familia indica cuáles.

Un valor fuera de la lista devuelve 422 con los valores aceptados, nunca una alternativa silenciosa a otra temporalidad.

#Agregación multimercado

Ninguna respuesta nombra su mercado. Las métricas multimercado llegan ya fusionadas: es el contrato de la plataforma, y la razón por la que varias integraciones se convierten en una. Tres reglas de fusión, según la naturaleza de la magnitud:

Una sola excepción en toda la API: /v1/spread/interexchange nombra los mercados, ya que un diferencial no tiene sentido sin ellos. En todos los demás casos el parámetro exchange no existe: pasarlo devuelve 422.

#Velas cerradas y periodo en curso

Seis familias sirven datos cortados en ventanas: las velas de operaciones, el VWAP por ventana, el CVD, el libro de órdenes agregado, los diferenciales entre mercados y el ratio largo/corto. En ellas, cada fila lleva un booleano is_closed, lo hayas pedido o no.

Por defecto solo se sirven las ventanas cerradas. Para ver el periodo en curso, añade ?live=1:

# The latest CLOSED hourly candle: its value will not move again.
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/cvd?symbol=BTCUSDT&timeframe=1h"

# The candle IN PROGRESS: provisional, flagged is_closed: false.
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/cvd?symbol=BTCUSDT&timeframe=1h&live=1"

#Cobertura de las fuentes

Como el mercado nunca se nombra, un funding calculado sobre dos mercados tiene la misma forma que uno calculado sobre seis. Dos mecanismos devuelven esa información:

• venue_count, fila a fila: el número real para la ventana concreta. Varía de una ventana a otra, así que no puede ser un atributo global. El funding lo llama exchange_count, por razones históricas.
• la clave coverage del snapshot, para lo que es constante en todas las filas: cuántos mercados se esperaban y el efecto de una ausencia.

{
  "coverage": {
    "oi_history": {
      "status": "available",
      "effect": "additive",
      "count_field": "venue_count",
      "venues_expected": 6
    },
    "cvd@1h": { "status": "unavailable", "reason": "pre_aggregated" }
  }
}

#Marcas de tiempo y orden

• Las marcas de tiempo de los datos están en ISO 8601, en UTC: 2026-08-29T11:38:00+00:00. La clave bucket designa el inicio de la ventana, nunca su final.
• Los límites de la petición (since_ms y until_ms) están en milisegundos desde la época Unix. Un límite negativo, o un since_ms mayor que until_ms, devuelve 422.
• Los arrays de valores (la serie de un indicador, la serie interna de un CVD) van del más antiguo al más reciente.
• Las listas de historial se devuelven del más reciente al más antiguo. La fila más fresca va primero.
• El día empieza a medianoche UTC: es el reinicio del VWAP intradía y la alineación de las series diarias.