API REST

Derivados

El posicionamiento en futuros: cuánto capital está comprometido, a qué coste, en qué dirección y a qué precio frente al spot. Todas estas métricas son compuestos, y se indica la ponderación usada en cada una.

#Interés abierto

GET/v1/raw/oidata_type · raw_oi

El interés abierto total, sumado en todos los mercados, en ventanas de un minuto. Cada mercado conserva su último valor conocido cuando su actualización se salta un minuto, y un minuto solo se sirve si todos los mercados están representados: sin eso, el total oscilaría artificialmente.

ParámetroTipoPor defectoDescripción
symbolstringobligatorioEl activo.
limitinteger30Número de minutos, de 1 a 1000.
CampoTipoDescripción
timestampstringInicio del minuto.
oi_totalfloatInterés abierto sumado. El nombre indica el agregado: no es el valor de un solo mercado.
GET/v1/oi/deltadata_type · oi_delta
GET/v1/oi/delta/historydata_type · oi_delta_history

La variación del interés abierto: el capital que entra o sale. El porcentaje se recalcula a partir de los totales agregados, para ser coherente con la suma.

CampoTipoDescripción
oi_currentfloatInterés abierto acumulado actual.
oi_previousfloatEl anterior.
deltafloatLa diferencia.
delta_pctfloat | nullLa variación en porcentaje.
timestampstringMarca de tiempo del cálculo.

#Funding

Tres lecturas del mismo fenómeno: la última tasa aplicada, la próxima estimada y el total acumulado en las últimas veinticuatro horas. Todas son compuestos ponderados por el interés abierto (el mercado que lleva más posiciones pesa más) y normalizados a una base de ocho horas antes de ponderar, porque algunos pares liquidan cada cuatro horas o cada hora.

GET/v1/funding/ratedata_type · funding_rate_8h
GET/v1/funding/rate/historydata_type · funding_rate_8h_history
CampoTipoDescripción
bucketstringInicio de la ventana de 8 h, alineada en 00:00, 08:00 y 16:00 UTC.
ratefloatLa tasa compuesta en la ventana, en equivalente de 8 h.
aprfloatLa tasa anualizada: tasa × 1095, es decir, 1095 liquidaciones de 8 h al año. Ausente del historial.
exchange_countintegerNúmero de mercados agregados en la ventana.
GET/v1/funding/nextdata_type · funding_next_estimated
CampoTipoDescripción
estimated_ratefloatLa tasa estimada, en equivalente de 8 h.
settlement_atstringMarca de tiempo de la liquidación conocida más reciente.
is_pastbooleanVerdadero si esa liquidación ya ha pasado.
aprfloatAnualizada.
exchange_countintegerNúmero de mercados agregados.
GET/v1/funding/cumulativedata_type · funding_cumulative_24h
GET/v1/funding/cumulative/historydata_type · funding_cumulative_24h_history
curl
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/funding/cumulative?symbol=BTCUSDT"
CampoTipoDescripción
timestampstringBucket de la ventana de 8 h más reciente.
cumulative_ratefloatSuma de los compuestos de 8 h en el rango.
aprfloatAnualizado sobre el número de ventanas realmente sumadas, lo que sigue siendo exacto aunque falte una.
window_countintegerNúmero de ventanas de 8 h realmente sumadas, tres como máximo.

#Liquidaciones

GET/v1/raw/liquidationsdata_type · raw_liquidations

Las liquidaciones individuales, de todos los mercados. Aquí la cobertura es estructuralmente menor que en las operaciones: no todos los mercados publican un flujo público de liquidaciones.

ParámetroTipoPor defectoDescripción
symbolstringobligatorioEl activo.
limitinteger30Número de eventos, de 1 a 1000.
min_usdfloat—Filtro opcional sobre el valor en dólares.
CampoTipoDescripción
timestampstringMarca de tiempo.
sidestringlong o short: el lado de la posición liquidada, no el de la orden. La convención está normalizada entre mercados.
pricefloatPrecio de liquidación.
quantityfloatTamaño en unidades del activo base.
usd_valuefloatValor en dólares.
GET/v1/liquidations/cumulativedata_type · liquidations_cumulative
GET/v1/liquidations/cumulative/historydata_type · liquidations_cumulative_history
CampoTipoDescripción
timestampstringMarca de tiempo del cálculo.
long_usdfloatDólares de posiciones largas liquidadas.
short_usdfloatDólares de posiciones cortas liquidadas.
total_usdfloatEl total.
GET/v1/liquidations/ratiodata_type · liquidation_ratio
GET/v1/liquidations/ratio/historydata_type · liquidation_ratio_history

La relación entre las grandes liquidaciones (al menos 100 000 $) y las pequeñas. Distingue una purga de grandes cuentas de una cascada de pequeños tenedores.

CampoTipoDescripción
big_count / big_usdinteger / floatLiquidaciones de al menos 100 000 $.
small_count / small_usdinteger / floatLas que están por debajo.
ratiofloat | nullbig_usd dividido por small_usd. null si el denominador es cero.
timestampstringMarca de tiempo del cálculo.

#Ratio largo/corto

GET/v1/ls-ratiodata_type · ls_ratio_composite
GET/v1/ls-ratio/historydata_type · ls_ratio_composite_history

La proporción de cuentas posicionadas en largo, en la variante de cuenta global, compuesta sobre los mercados que la publican y ponderada por el interés abierto. Se necesitan al menos dos mercados en una ventana; si no, la respuesta es null.

ParámetroTipoPor defectoDescripción
symbolstringobligatorioEl activo.
timeframestringobligatorio5m, 15m, 30m, 1h, 4h, 1d. Se rechaza la temporalidad 1m: ningún mercado publica a esa cadencia.
livebooleanfalseExpone la ventana en curso.
limitinteger30En el historial, de 1 a 500.
CampoTipoDescripción
timestampstringInicio de la ventana.
timeframestringLa temporalidad solicitada.
part_longfloatProporción de cuentas largas, estrictamente entre 0 y 1.
ratiofloatLargos divididos por cortos.
venue_countintegerNúmero de mercados agregados, al menos dos.
weightingstringoi cuando se pudo aplicar la ponderación por interés abierto; geomean como alternativa.
is_closedbooleanFalso solo con live=1.

#Base

GET/v1/basisdata_type · basis
GET/v1/basis/historydata_type · basis_history

La diferencia entre el precio de futuros y el precio spot, una media ponderada por el interés abierto sobre los mercados que tienen ambos mercados. Los dos precios se ponderan igual, lo que garantiza que basis_value = futures_price − spot_price siga siendo cierto.

CampoTipoDescripción
basis_valuefloatLa diferencia en dólares.
basis_pctfloatLa diferencia en porcentaje.
futures_pricefloatPrecio de futuros compuesto.
spot_pricefloatPrecio spot compuesto.
timestampstringMarca de tiempo del cálculo.

Ventana por defecto del historial

Sin since_ms ni until_ms, la búsqueda se remonta limit minutos. Con una ventana explícita, se aplica esa ventana.

#Diferenciales entre mercados

GET/v1/spread/interexchangedata_type · spread_interexchange_<tf>
GET/v1/spread/interexchange/historydata_type · spread_interexchange_<tf>_history

La única superficie de la API que nombra los mercados, porque un diferencial no tiene sentido sin ellos. El modelo es una prima por mercado: un precio de referencia multimercado y después la diferencia de cada mercado con esa referencia. Cualquier par se deduce en el cliente, por la diferencia de dos primas.

ParámetroTipoPor defectoDescripción
symbolstringobligatorioEl activo.
timeframestringobligatorio1m, 5m, 15m, 30m, 1h, 4h, 1d.
livebooleanfalseExpone la ventana en curso.
limitinteger30En el historial, de 1 a 500. Sin ventana fechada.
Respuesta
{
  "status": "ok",
  "data_type": "spread_interexchange_1m",
  "data": {
    "timestamp": "2026-08-29T11:38:00+00:00",
    "timeframe": "1m",
    "is_closed": true,
    "ref_price": 71420.83,
    "weighting": "volume",
    "max_spread_bps": 5.4,
    "max_spread_pct": 0.054,
    "high": { "exchange": "venue_a", "price": 71423.10 },
    "low":  { "exchange": "venue_b", "price": 71414.55 },
    "venue_count": 2,
    "venues": [
      { "exchange": "venue_a", "price": 71423.10, "premium_bps":  3.2 },
      { "exchange": "venue_b", "price": 71414.55, "premium_bps": -2.2 }
    ]
  }
}
CampoTipoDescripción
ref_pricefloatPrecio de referencia multimercado.
weightingstringvolume en el régimen nominal; mean como alternativa cuando falta el volumen.
max_spread_bps / max_spread_pctfloatLa amplitud entre el mercado más alto y el más bajo.
high / lowobjectEl mercado extremo y su precio.
venue_countintegerNúmero de mercados en la ventana, al menos dos.
venuesarrayUna entrada por mercado: exchange, price, premium_bps. Ordenadas por prima decreciente.
is_closedbooleanFalso solo con live=1.