Interés abierto y tasa de financiación
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
/v1/oiBarras 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 |
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"{
"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
/v1/fundingLa 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 |
{
"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
/v1/funding/eventsLos 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 |
curl -s "https://market-api.lootx.trade/v1/funding/events?instrument=binance:perp:BTCUSDT" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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
/v1/ls-ratioRelació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.
curl -s "https://market-api.lootx.trade/v1/ls-ratio?instrument=binance:perp:BTCUSDT&from=1793278200000&to=1793278500000" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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.
/v1/ls-ratio/latestLa ú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 |
{
"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
/v1/markPrecio 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 |
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"{
"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=1stotalmente fuera del rango —400 bad_requestconparam: "from", parcial —fromse ajusta al borde de almacenamiento. - Paginación. Una ventana
1smás larga que una hora y una ventana1mmás larga que una semana el gateway las corta y devuelvenext_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.
/v1/mark/latestLa ú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 |
{
"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.