LootX

Interés abierto y tasa de financiación

Actualizado 18 de noviembre de 2026 Esta página en PDF

Barras de un minuto de interés abierto en dólares, monedas o en la unidad nativa del exchange; la tasa de financiación por minuto y los propios pagos; Long/Short ratio por buckets de 5 minutos; mark e index por segundos y minutos.

Solo contratos perpetuos: market = perp. Exchanges: binance, bybit, okx, bitget, gate, mexc, bingx, kucoin, hyperliquid, aster, kraken, coinbase. En long/short y mark e index están indicados los conjuntos de exchanges propios; se nombran en sus secciones.

Interés abierto

GET/v1/oi

Barras de un minuto de interés abierto: apertura, máximo, mínimo y cierre del minuto. Grupo de tarifa — oi.

Parámetro Qué
instrument obligatorio, solo perps
from inicio, ms. Por defecto — 24 horas antes de to
to fin, ms, no inclusivo
unit usd (por defecto), coins o native — como en el exchange: monedas, contratos o dólares
cursor cursor desde next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/oi?instrument=bybit:perp:ETHUSDT&unit=usd&from=1793750400000&to=1793750520000" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "bybit:perp:ETHUSDT",
  "tf": "1m",
  "columns": ["ts", "open", "high", "low", "close"],
  "rows": [
    [1793750400000, 1843204551.12, 1843990120.4, 1842871003.57, 1843511876.03],
    [1793750460000, 1843511876.03, 1844102233.9, 1843300418.65, 1843877021.18]
  ],
  "next_cursor": null
}

ts — inicio del minuto. La página contiene hasta una semana de minutos; para periodos más largos, navegue con el cursor.

Tasa de financiación

GET/v1/funding

La tasa de financiación, tal como el exchange la mostraba cada minuto, con el tiempo del siguiente abono cuando el exchange lo informa (en Hyperliquid, MEXC, Kraken y Coinbase next_funding_ts — null). Grupo de tarifa — funding.

Parámetro Qué
instrument obligatorio
from, to, cursor ventana y cursor
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "1m",
  "columns": ["ts", "rate", "next_funding_ts", "interval_hours"],
  "rows": [[1793750400000, 0.0001, 1793779200000, 8]],
  "next_cursor": null
}
  • rate — fracción por el periodo de pago del exchange: 0.0001 — esto es 0,01 % por 8 horas;
  • interval_hours — periodo de pago, tal como lo reporta la fuente.

Pagos de la tasa de financiación

GET/v1/funding/events

Los propios momentos de cálculo: qué tasa se aplicó y a qué precio mark. Mismo grupo funding.

Parámetro Qué
instrument obligatorio, solo perps
from inicio, ms. Por defecto — 30 días antes de to
to fin, ms, no inclusivo
cursor cursor desde next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/funding/events?instrument=binance:perp:BTCUSDT" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "columns": ["t", "rate", "mark_price"],
  "rows": [
    [1793721600000, 0.00009249, null],
    [1793721600006, 0.00009208, 104012.4],
    [1793750400000, 0.000072, 104250.5]
  ],
  "next_cursor": null
}

mark_price se rellena solo en Binance; en los demás exchanges es null; en Binance también hay null en la fila duplicada (ver arriba). Para calcular sus pagos multiplique la tasa por el nocional de la posición en el momento del abono: las sumas no se redondean al paso de precio ni aquí ni en sus cálculos.

Long/Short ratio

GET/v1/ls-ratio

Relación de largos y cortos y volumen taker por buckets de 5 minutos — tal como lo publica el exchange. Grupo de tarifa — ls_ratio.

Parámetro Qué
instrument obligatorio, solo perps. Hay series en binance (global_account, top_account, top_position, taker_volume), bybit (global_account) y okx (las mismas cuatro y global_account_ccy); en los demás exchanges de interés abierto la respuesta está vacía
kind tipo de serie: global_account, top_account, top_position, taker_volume, global_account_ccy. Por defecto — todas. Otro valor — 400 bad_request con param: "kind"
from inicio, ms, por ts. Por defecto — 24 horas antes de to
to fin, ms, no inclusivo
cursor cursor desde next_cursor

Las relaciones de distintos exchanges no se agregan: instruments= con dos o más instrumentos — 400 bad_request; solicite cada exchange con su propio instrument.

Shell
curl -s "https://market-api.lootx.trade/v1/ls-ratio?instrument=binance:perp:BTCUSDT&from=1793278200000&to=1793278500000" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "5m",
  "columns": ["ts", "as_of", "kind", "long_ratio", "short_ratio", "long_short_ratio", "buy_vol", "sell_vol", "unit"],
  "rows": [
    [1793278200000, 1793278200000, "global_account", 0.6849, 0.3151, 2.1736, null, null, null],
    [1793278200000, 1793278500000, "taker_volume", null, null, 1.1138, "82.8880", "74.4160", "base"],
    [1793278200000, 1793278200000, "top_account", 0.6982, 0.3018, 2.3135, null, null, null],
    [1793278200000, 1793278200000, "top_position", 0.6774, 0.3226, 2.0995, null, null, null]
  ],
  "next_cursor": null
}
Columna Qué
ts bucket del exchange (bucket_ts), ms. Las filas están ordenadas por ts, dentro — por kind
as_of instante al que corresponde el valor, ms. En global_account, top_account, top_position de Binance y en global_account de Bybit — ts: es la instantánea en ese punto. En taker_volume de Binance y en todos los tipos de OKX — ts + 5 minutos: valor para el periodo [ts, ts + 5 min). En otros pares — ts. Alinee series de distintos exchanges y tipos por as_of
long_ratio, short_ratio proporciones de largos y cortos, adimensionales: 0.6849 — 68,49 %
long_short_ratio ratio de largos a cortos; en taker_volume — compras taker sobre ventas
buy_vol, sell_vol volumen de compras y ventas del taker en el bucket — como cadena, registro decimal exacto del exchange, en la unidad unit. Sólo en taker_volume
unit unidad de buy_vol y sell_vol: base — monedas. En otros tipos — null

Lo que el exchange no publica es null: OKX, por ejemplo, envía sólo long_short_ratio, sin las proporciones. El exchange añade la última bucket incluso después de su fin: vuelva a consultar los últimos ~10 minutos. Ventana más larga que una semana el gateway la corta y devuelve next_cursor; la página incluye hasta 10 000 filas, y las filas de un mismo ts entran completas en una página.

GET/v1/ls-ratio/latest

La última fila de cada tipo — o solo del kind — en 35 días. Mismo grupo ls_ratio, mismas columnas, next_cursor — null.

Parámetro Qué
instrument obligatorio, solo perps
kind tipo de serie, como en /v1/ls-ratio. Por defecto — todas
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "5m",
  "columns": ["ts", "as_of", "kind", "long_ratio", "short_ratio", "long_short_ratio", "buy_vol", "sell_vol", "unit"],
  "rows": [
    [1793279100000, 1793279100000, "global_account", 0.684, 0.316, 2.1646, null, null, null],
    [1793278800000, 1793279100000, "taker_volume", null, null, 2.9092, "786.2880", "270.2730", "base"],
    [1793279100000, 1793279100000, "top_account", 0.6978, 0.3022, 2.3091, null, null, null],
    [1793279100000, 1793279100000, "top_position", 0.6779, 0.3221, 2.1047, null, null, null]
  ],
  "next_cursor": null
}

Cada tipo tiene su propia última fila, y sus ts pueden diferir, como en taker_volume del ejemplo. Si no hay ninguna fila en 35 días — 404 not_found; una serie que dejó de reportar antes, consúltela con /v1/ls-ratio usando una ventana.

Mark e index

GET/v1/mark

Precio de mark e index del perp por segundos o minutos. El grupo de tarifa depende del paso: tf=1m — mark, tf=1s — mark_1s.

Parámetro Qué
instrument obligatorio, solo perps: binance, bybit, okx, bitget, gate, hyperliquid, mexc, kraken, lighter, aster. Otro exchange — 400 unsupported_instrument
tf 1s — segundos, almacenados 7 días; 1m — minutos, sin caducidad. Por defecto 1m. Otro paso — 400 bad_request con param: "tf": agregue usted mismo a minutos si necesita mayor tamaño
from inicio, ms, por ts. Por defecto — 24 horas antes de to, para 1s — una hora
to fin, ms, no inclusivo. Por defecto — ahora; si to está en el futuro, el gateway lo mueve a «ahora»
cursor cursor desde next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/mark?instrument=binance:perp:BTCUSDT&tf=1m&from=1794531600000&to=1794531720000" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "1m",
  "columns": ["ts", "mark_open", "mark_high", "mark_low", "mark_close", "index_close", "premium", "secs"],
  "rows": [
    [1794531600000, "71111.39908546", "71137.9", "71045.18452774", "71045.18452774", "71084.41304348", -0.0005518581931035318, 60],
    [1794531660000, "71044.18909295", "71044.18909295", "70970.4", "71007.3", "71051.90695652", -0.0006278080129122655, 60]
  ],
  "next_cursor": null
}
Columna Qué
ts inicio del segundo o minuto, ms
mark (1s); mark_open, mark_high, mark_low, mark_close (1m) precio de mark en la moneda de cotización — como cadena, notación decimal con la precisión del exchange
index (1s), index_close (1m) precio index, como cadena, igual que mark. Si el exchange no lo tiene — null. En Hyperliquid es el precio oráculo (oraclePx)
premium mark / index − 1 (en 1m — con cierre de minuto): fracción adimensional, número. Sin index — null
secs solo en 1m: cuántos segundos del minuto tuvieron valor, 1…60

Los precios vienen como cadenas para no perder dígitos: trátelos como cadena o tipo decimal, no como float, y no redondee al paso de precio.

  • Segundos sin línea mantienen el valor anterior: el exchange envía solo los cambios. Prolongue el último valor conocido.
  • El minuto en curso no se devuelve en 1m — dibújelo a partir de segundos.
  • Segundos más antiguos de 7 días no se almacenan: una ventana tf=1s totalmente fuera del rango — 400 bad_request con param: "from", parcial — from se ajusta al borde de almacenamiento.
  • Paginación. Una ventana 1s más larga que una hora y una ventana 1m más larga que una semana el gateway las corta y devuelve next_cursor; la página incluye hasta 10 000 filas. En el borde en vivo, más reciente que hace 2 minutos, no hay cursor: la siguiente petición empiece desde la última fila recibida.

Los precios de los exchanges no se agregan: instruments= con dos o más instrumentos — 400 bad_request.

GET/v1/mark/latest

La última segunda de mark e index en 7 días: una fila con columnas tf=1s. Grupo de tarifa — mark.

Parámetro Qué
instrument obligatorio, perp de uno de los exchanges listados en /v1/mark
JSON
{
  "instrument": "binance:perp:BTCUSDT",
  "tf": "1s",
  "columns": ["ts", "mark", "index", "premium"],
  "rows": [[1794534182000, "70906.31457271", "70933.00695652", -0.00037630413477835085]],
  "next_cursor": null
}

Si no hay ninguna segunda en 7 días — 404 not_found. Las últimas ~3 segundos el origen puede no haberlas escrito todavía, por lo que no tiene sentido pedirlo más de una vez por segundo.