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.
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ámetro
Tipo
Por defecto
Descripción
symbol
string
obligatorio
El activo.
limit
integer
30
Número de minutos, de 1 a 1000.
Campo
Tipo
Descripción
timestamp
string
Inicio del minuto.
oi_total
float
Interés abierto sumado. El nombre indica el agregado: no es el valor de un solo mercado.
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.
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.
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ámetro
Tipo
Por defecto
Descripción
symbol
string
obligatorio
El activo.
limit
integer
30
Número de eventos, de 1 a 1000.
min_usd
float
—
Filtro opcional sobre el valor en dólares.
Campo
Tipo
Descripción
timestamp
string
Marca de tiempo.
side
string
long o short: el lado de la posición liquidada, no el de la orden. La convención está normalizada entre mercados.
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.
Campo
Tipo
Descripción
big_count / big_usd
integer / float
Liquidaciones de al menos 100 000 $.
small_count / small_usd
integer / float
Las que están por debajo.
ratio
float | null
big_usd dividido por small_usd. null si el denominador es cero.
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ámetro
Tipo
Por defecto
Descripción
symbol
string
obligatorio
El activo.
timeframe
string
obligatorio
5m, 15m, 30m, 1h, 4h, 1d. Se rechaza la temporalidad 1m: ningún mercado publica a esa cadencia.
live
boolean
false
Expone la ventana en curso.
limit
integer
30
En el historial, de 1 a 500.
Campo
Tipo
Descripción
timestamp
string
Inicio de la ventana.
timeframe
string
La temporalidad solicitada.
part_long
float
Proporción de cuentas largas, estrictamente entre 0 y 1.
ratio
float
Largos divididos por cortos.
venue_count
integer
Número de mercados agregados, al menos dos.
weighting
string
oi cuando se pudo aplicar la ponderación por interés abierto; geomean como alternativa.
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.
Campo
Tipo
Descripción
basis_value
float
La diferencia en dólares.
basis_pct
float
La diferencia en porcentaje.
futures_price
float
Precio de futuros compuesto.
spot_price
float
Precio spot compuesto.
timestamp
string
Marca 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.
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.