Comunes a todos los endpoints cripto get_alpha / get_exposure:
period — tamaño de la vela, {n}min / {n}h / {n}d ({n}m se interpreta como minutos). Los valores documentados son 5min, 15min, 1h, 4h, 8h, 1d; los indicadores con un mínimo más amplio lo indican en su bloque. Un period ausente o imposible de interpretar devuelve 403 {"error": "period is required"} (un 400 en unusual_movement y liquidation).
start_date / end_date — YYYY-MM-DD (UTC). end_date es hoy por defecto; start_date es end_date − 365 días por defecto. Un rango de más de 365 días se recorta sin aviso (start_date pasa a end_date − 365 días). Una fecha mal formada no se valida y termina en un 500 — envíe siempre YYYY-MM-DD.
symbol — perpetuo USDT-M de Binance, p. ej. BTCUSDT; también se aceptan BTC, btc, BTC/USDT, BTC-USDT (a un token sin sufijo se le añade USDT). Los endpoints get_symbols listan los símbolos cubiertos.
Se devuelven solo velas cerradas — la última vela, aún en formación, se descarta.
La respuesta es {"data": {"timestamp": [...], "alpha": [...], ...}} — arrays paralelos, un elemento por vela. timestamp está en segundos Unix (UTC) y es la etiqueta de la vela.
Para un historial de más de 365 días, envíe una solicitud por año y concatene los resultados.
Objeto stat — lo devuelven los indicadores cuyo bloque lo incluye. Es un modelo logístico ajustado con el último año de este indicador para el símbolo frente al movimiento del precio en las 24h siguientes:
Campo
Tipo
Descripción
up_prob
float
Probabilidad de una subida en 24h dado el último valor del indicador (0–1)
avg_up_return
float
Rentabilidad media a 24h en las subidas pasadas (decimal, 0.02 = +2%)
avg_down_return
float
Rentabilidad media a 24h en las bajadas pasadas (decimal, negativo)
El token sin USDT (p. ej. BTC, incluso cuando se envió BTCUSDT)
price
float
USDT
Último precio
change_24h
float
decimal
Variación en 24h como fracción (0.025 = +2.5%)
Errores
Estado
Cuerpo
Cuándo
400
{"error": "symbol is required"}
Falta symbol
404
{"error": "symbol <SYMBOL> not found"}
No hay precio para ese token
Notas
Fuente del precio, en orden de respaldo: perpetuo USDT-M de Binance → spot de Binance → perpetuo de BingX.
change_24h normalmente procede del mismo mercado que price, pero ambos se almacenan en caché por separado (5 s cada uno), así que pueden diferir brevemente.
data tiene como clave el token (BTC, 1INCH, …). Cada token asocia nombre del indicador → {param: value} ("-" cuando el indicador no tiene parámetro). "" = datos insuficientes. Además de los indicadores:
Clave
Descripción
statistics
up_prob (prob. de una subida en 24h), exp_value (rentabilidad esperada), avg_up_return, avg_down_return, return_ratio, is_data_sufficient
{"-": 1234567890} — capitalización de mercado en USD
market_cap_percentile
{"-": 85.3} — percentil entre todas las monedas listadas
funding_rate
{"binance": -0.01, ...} — por exchange
oi_imbalance
{"-": 0.12} — desequilibrio de OI (detalle completo: /oi_imbalance/get_overview_data)
fields — una entrada por indicador: id, name (clave usada en data), param (nombre del parámetro o null), name_en, name_zh.
note — con el id del indicador como clave: una lista de bandas de valores {min, max, note: {en, zh}, direction: {en, zh}, color, background_color} que sirve para etiquetar un valor (p. ej. max: -3 → "Overly Bearish").
Errores
Solo errores comunes.
Notas
Úselo en primer lugar para cualquier filtro o ranking de varias monedas — una sola solicitud cubre todos los símbolos.
Compruebe siempre statistics.is_data_sufficient antes de usar statistics.
Obtenga siempre datos nuevos; no reutilice una respuesta anterior.
2020-01-01, o la fecha de listado del contrato si es posterior
Actualización
Aproximadamente un minuto después del cierre de cada vela
Cobertura. Todos los perpetuos USDⓈ-M de Binance cuyo símbolo termina en USDT — 740 contratos en octubre de 2026, incluidos los perpetuos USDT de acciones tokenizadas, materias primas y otros activos TradFi. Los 740 tienen todo su historial de 1 minuto almacenado en el servidor, desde 2020-01-01 o desde la fecha de listado. Un perpetuo recién listado puede consultarse unos 5–10 minutos después de su listado.
Sin cobertura: contratos cotizados en USDC, USD1, U o BTC (p. ej. BTCUSDC, ETHBTC) y contratos trimestrales con entrega — estos devuelven el error 400 unknown symbol or no data indicado más abajo. Los contratos deslistados no están garantizados: pueden responder con el historial que aún esté almacenado o con ese mismo 400 (los deslistados antes de octubre de 2026 no tienen historial de 1min–4min).
Parámetros
Nombre
Descripción
Valores permitidos
Predeterminado
symbol
string · queryObligatorio
Perpetuo USDⓈ-M USDT de Binance. A un token sin sufijo se le añade USDT; un token sin sufijo que solo existe con un prefijo multiplicador se resuelve a este (PEPE → 1000PEPEUSDT)
BTCUSDT; también BTC, btc, BTC/USDT, BTC-USDT
period
string · queryObligatorio
Tamaño de la vela. Se acepta cualquier tamaño en minutos enteros, no solo los ejemplos indicados
end_date − 365 días (period ≥ 5min); end_date − 30 días (period < 5min)
end_date
string · query
Último día, inclusive (velas hasta el final de ese día UTC)
YYYY-MM-DD (UTC)
ahora
Ventana por solicitud: period ≥ 5min → como máximo 365 días; un rango más largo se recorta sin aviso (start_date pasa a end_date − 365 días, sin error). Period < 5min → como máximo 30 días; un rango más largo devuelve un 400.
Un array JSON sin envoltorio (no va dentro de {"data": ...}), en orden ascendente por tiempo.
Campo
Tipo
Unidad
Descripción
time
float
Segundos Unix (UTC)
Hora de apertura de la vela
open / high / low / close
float
moneda de cotización (USDT)
Precios
volume
float | null
activo base
Volumen negociado; null cuando la fuente no tiene volumen para esa vela
Errores
Estado
Cuerpo
Cuándo
403
{"error": "symbol is required"}
Falta symbol
403
{"error": "period is required"}
Falta periodo no se puede interpretar
400
{"error": "minimum supported period is 1min"}
period inferior a un minuto
400
{"error": "periods below 5min must be a whole number of minutes"}
e.g. 90s
400
{"error": "date range exceeds max 30 days for periods below 5min"}
Period < 5min y rango > 30 días
400
{"error": "invalid date format, expected YYYY-MM-DD"}
start_date / end_date mal formados
400
{"error": "unknown symbol or no data: <symbol>"}
Símbolo sin cobertura (véase Sin cobertura) o que no es un contrato real, p. ej. BTCUSDC, ETHBTC, un error tipográfico. <symbol> devuelve el valor enviado. No es transitorio — no reintentar
Notas
Una ventana totalmente anterior a la fecha de listado de un contrato cubierto devuelve 200 con [], no un error.
Con 1min, todas las velas devueltas están cerradas. Un periodo más largo puede terminar en una vela parcial cuando end_date es hoy — se construye con las velas cerradas hasta el momento (a las 07:09 UTC, la vela 1h de las 07:00 contiene 07:00–07:05); descártela si solo necesita velas cerradas.
Para un historial que supere una ventana, envíe una solicitud por ventana y concatene los resultados (p. ej. 3 años de 5min = 3 solicitudes; 1 año de 1min = 13 solicitudes de ≤30 días).
Los 740 perpetuos USDT tienen todo el historial de 1 minuto en disco, así que una solicitud profunda se responde con datos almacenados — no hay una primera obtención lenta.
La fecha de inicio se aplica a todos los intervalos, incluido 1min.
La última vela cerrada de 1 minuto suele estar disponible en el minuto siguiente; en casos poco frecuentes de servicio degradado, las velas más recientes pueden retrasarse unos 5–10 minutos.
Caché del servidor: 30 s (1min), 300 s (1h / 4h / 1d), 60 s (cualquier otro periodo); solo 5 s cuando la última vela cerrada aún no ha llegado.
Sin symbol: alpha es una única serie de todo el mercado, no una por moneda. BTCUSDT se usa internamente solo para alinear las velas; no se devuelve y no modifica alpha. Véase Convenciones de los indicadores cripto.
{"data": {<condition_id>: {...}}}, con el id de la condición como clave (una clave de cadena JSON, p. ej. "12"; envíela de vuelta como el entero condition_id). Solo las condiciones propias de esta cuenta.
Campo
Tipo
Descripción
filters
object[]
Los filtros de la condición, todos combinados con AND: indicator_id (int), indicator_name ({"en", "zh"}), param (string; "-" = el valor por defecto del indicador), operator_id (int), operator_symbol (string, p. ej. >), value (umbral)
note
string
El nombre que usted le dio a la condición al guardarla
name_en / name_zh
string | null
Solo se define en las condiciones oficiales / de la comunidad; en las condiciones propias cabe esperar vacío o null, y debe leerse note en su lugar
description_en / description_zh
string | null
Solo se define en las condiciones oficiales / de la comunidad; puede estar vacío o ser null
Errores
Estado
Cuerpo
Cuándo
403
{"error": "unsupported api feature"}
Clave no vinculada a una cuenta de usuario
Notas
Cada solicitud lee en vivo las condiciones guardadas de la cuenta.
Uno por cada indicador de filtro distinto, en el orden de los filtros: en / zh (nombre para mostrar, con el parámetro entre paréntesis cuando lo hay), name (clave del indicador), type, url; además de value_format, value_decimals, polarity cuando el indicador los define
symbols
object[]
Tokens que cumplen todos los filtros
symbols[].symbol
string
Token sin USDT (p. ej. BTC)
symbols[].id
int
Id del token (0 cuando se desconoce)
symbols[].user_selected
bool
El token está en la lista de seguimiento de la cuenta
symbols[].price
float
Último precio en USDT (el mismo feed que /price; 0 cuando no está disponible)
symbols[].24h_chg
float
Variación en 24h como fracción (0.025 = +2.5%)
symbols[].alphas
float[]
El valor del token para cada indicador de filtro, en paralelo a alpha_names
symbols[].alpha_notes
object[]
Por indicador: indicator_id, color, direction, note (más background_color cuando se cumplió una regla; colornull y cadenas vacías cuando no se cumplió ninguna)
Errores
Estado
Cuerpo
Cuándo
400
{"error": "Missing parameter: condition_id is required."}
Falta
400
{"error": "Invalid parameter: condition_id must be an integer."}
No es un entero
404
{"error": "Invalid condition_id: <id> not found for user."}
Tasa de financiación × 100 (0.01 = 0.01%); positivo = los largos pagan a los cortos
close
float[]
USDT
Precio de cierre del perpetuo
stat
object
—
Véase objeto stat
Errores
Estado
Cuerpo
Cuándo
403
{"error": "symbol is required"} / {"error": "period is required"}
Falta un parámetro
400
{"error": "exchange must be one of binance, okx, bingx, bybit"}
exchange fuera de la lista
Notas
2025-09-30 es la primera vela 1d de BTCUSDT; otros símbolos pueden empezar más tarde, y exchange=bybit empieza más tarde — lea la primera marca de tiempo.
{"data": {"alpha": {<sector>: {"data": [...], "name_en": ..., "name_zh": ...}}, "timestamp": [...]}}. timestamp está junto a alpha en el nivel superior de data, no dentro de cada sector; es el eje temporal común a todas las series de sector.
Campo
Tipo
Descripción
timestamp
float[]
Segundos Unix (UTC), uno por punto — 366 puntos diarios en la respuesta observada
alpha.<sector>.data
float[]
La serie del sector, con la misma longitud y el mismo orden que timestamp (366); el primer elemento es 0.0
alpha.<sector>.name_en / name_zh
string
Nombre para mostrar del sector
Errores
Solo errores comunes.
Notas
La serie es una ventana diaria de los últimos doce meses (366 puntos diarios), y cada sector empieza en 0.0. No hay parámetros, y cada reconstrucción recalcula solo los últimos 365 días, así que no existe un historial más largo.
La reconstruye una tarea programada, con reconstrucciones cada 50–60 minutos; se sirve desde la salida de la tarea, sin caché adicional del servidor.
Z-score de la variación del OI (o del volumen) sumada en timeframe frente a su media de 30 días
stat
object
Véase objeto stat
Errores
Estado
Cuerpo
Cuándo
403
{"error": "symbol is required"} / {"error": "period is required"}
Falta un parámetro
403
{"error": "Invalid score_type"}
score_type no permitido
Notas
Cubre solo Binance — interés abierto y volumen de perpetuos USDT-M.
timeframe no se valida en el servidor. Se probó un valor fuera de la lista, 2h, y devolvió 200 con datos. Es una única observación — no demuestra que funcione cualquier {n}h. Use los valores de la lista salvo que verifique el que necesita.
2021-12-01 es la primera vela 1d de BTCUSDT; otros símbolos pueden empezar más tarde.
black = squeeze activo (Bandas de Bollinger dentro de los Canales de Keltner), grey = squeeze inactivo
stat
object
Véase objeto stat
Errores
Estado
Cuerpo
Cuándo
403
{"error": "symbol is required"}
Falta un parámetro
Notas
Cubre solo Binance — precio de perpetuos USDT-M.
La serie lleva relleno: hay filas de BTCUSDT desde 2020-01-01, pero alpha es 0.0 hasta 2020-02-09. Una solicitud que empiece antes de la fecha de Datos desde devuelve esas filas de relleno — son relleno, no señal. Descarte los ceros iniciales o empiece en la fecha de Datos desde.
2020-02-09 es el primer alpha distinto de cero de BTCUSDT; otros símbolos pueden empezar más tarde.
Sin symbol: alpha es una única serie de todo el mercado, no una por moneda. BTCUSDT se usa internamente solo para alinear las velas; no se devuelve y no modifica alpha. Véase Convenciones de los indicadores cripto.
{"data": {"timestamp": [...], "alpha": [...]}}. Sin stat.
Campo
Tipo
Descripción
timestamp
float[]
Segundos Unix (UTC)
alpha
float[]
Exposición neta de los top traders de Blave (el 10% superior por activos de la cuenta) — la mediana, entre esos traders, de la posición nocional neta de cada trader ÷ sus propios activos, ×100 (positivo = neto largo). Es un ratio sin procesar, no un z-score
Errores
Estado
Cuerpo
Cuándo
403
{"error": "period is required"}
Falta un parámetro
Notas
Una única serie de todo el mercado que abarca todas las monedas que tienen estos traders; no hay dimensión de símbolo.
(liquidaciones de cortos − de largos, en monedas) sumadas en timeframe ÷ su desviación estándar móvil de 30 días; no se resta la media. > 0 = se liquidaron más cortos que largos, < 0 = más largos
stat
object
Véase objeto stat
Errores
Estado
Cuerpo
Cuándo
400
{"error": "symbol is required"} / {"error": "period is required"}
Falta un parámetro
Notas
La serie lleva relleno: hay filas de BTCUSDT desde 2020-01-01, pero alpha es 0.0 hasta 2023-01-01. Una solicitud que empiece antes de la fecha de Datos desde devuelve esas filas de relleno — son relleno, no señal. Descarte los ceros iniciales o empiece en la fecha de Datos desde. Los símbolos distintos de BTC/ETH pasan a ser distintos de cero aún más tarde, así que compruébelo para cada símbolo.
Asignación estimada del interés abierto de Binance a cada tramo (estimación del modelo, no posiciones reales)
cumsum
float[]
USD
Exposición acumulada a liquidaciones a lo largo de los tramos
liquidation
object
USD
{"24h": {"buy_liq": [...], "sell_liq": [...]}} — liquidaciones reales por órdenes forzosas de Binance en las últimas 24 h por tramo, cada una dividida por un supuesto fijo de cuota de Binance de 0.3: buy_liq = liquidaciones de cortos, sell_liq = liquidaciones de largos
Nueva exposición estimada a liquidaciones en las últimas 0–1 h, por tramo: diferencia positiva entre instantáneas del mapa del modelo, no liquidaciones reales
hist_1_8h
float[]
USD
Últimas 1–8 h
hist_8_24h
float[]
USD
Últimas 8–24 h
Errores
Estado
Cuerpo
Cuándo
400
{"error": "symbol is required"}
Falta un parámetro
Notas
Cada solicitud reconstruye el mapa actual (caché del servidor de 5 s) y lo compara con las instantáneas del mapa guardadas hace aproximadamente 1 h, 8 h y 24 h. Las instantáneas se guardan cada 30 minutos para todos los símbolos, y además en cada solicitud del mapa.
Las liquidaciones forzosas de una moneda en todos los feeds de exchanges que recopila Blave: cuatro ventanas móviles con el desglose por exchange, una serie horaria de 24 puntos y las notas de cobertura de cada feed. Es flujo real de liquidaciones (como la entrada de get_alpha), no la estimación del modelo que hay detrás de get_map.
Parámetros
Nombre
Descripción
Valores permitidos
Predeterminado
symbol
string · queryObligatorio
Moneda. Se elimina el sufijo de la moneda de cotización; el symbol de la respuesta es el nombre normalizado de la moneda
Posición entre las 50 primeras monedas por total de 24 h entre exchanges; null fuera de las 50 primeras o sin ningún evento
updated_at
string / null
ISO 8601 UTC
Hora del último tramo de 5 minutos utilizado
windows
object
—
Las claves son las cadenas "1", "4", "12", "24" (horas). Cada una es una ventana móvil que termina en el último tramo de 5 minutos, con los campos siguientes
Suma entre exchanges; long = posiciones largas liquidadas (el precio bajó), short = cortos liquidados (el precio subió)
windows.<h>.long_pct / short_pct
float / null
ratio 0–1
Proporción del total de la ventana; null cuando el total de la ventana es 0
windows.<h>.covered_hours
float
h
Cuántas horas de la ventana tienen realmente tramos (< h justo después de un reinicio del recolector)
windows.<h>.by_exchange
object
USD
{exchange: {total_liq_usd, long_liq_usd, short_liq_usd}}. Un exchange sin ningún evento en la ventana no tiene clave — lea exchanges[] para distinguir «feed activo, esta moneda sin actividad» de «feed ausente»
exchanges[]
object[]
—
Una fila por feed (seis actualmente, presentes incluso sin eventos), ordenadas por total de 24 h descendente y luego por el orden de la lista de feeds
exchanges[].exchange
string
—
binance, bybit, gate, okx, htx, bitfinex
exchanges[].listed
bool / null
—
Si ese exchange lista un perpetuo con margen en USDT para la moneda; null cuando no se pudo obtener la lista de contratos (Bitfinex siempre null)
exchanges[].last_event_at
string / null
ISO 8601 UTC
Último tramo recibido de ese feed (cualquier moneda); null si nunca se ha recibido
exchanges[].price_basis
string
—
Precio usado para la conversión a USD: trade_avg, bankruptcy, unverified
exchanges[].coverage
string
—
Grado de completitud del feed: full, full_unstated, sampled_1s, aggregated_1s, sampled_undisclosed
exchanges[].time_basis
string
—
event — agrupado por la marca de tiempo del propio evento
detail_complete
bool
—
false cuando la moneda puede haber quedado fuera de una lista de detalle completa por tramo (los feeds conservan las 100 primeras monedas por tramo de 5 minutos): en ese caso windows puede contar de menos. Las 50 primeras monedas son casi siempre true
series.bucket_seconds
int
s
Siempre 3600
series.points
object[]
—
Siempre 24 entradas, de la más antigua → a la más reciente, en horas de reloj; la última es la hora en curso hasta updated_at (la instantánea se reconstruye cada 5 min, así que puede ir unos minutos por detrás de la solicitud). Cada una es {ts, long_liq_usd, short_liq_usd}; las horas sin eventos son 0, nunca faltan
windows["24"] es el mismo marco móvil que la matriz por exchange, así que la misma moneda muestra allí la misma cifra de 24 h. series va en horas de reloj, por lo que Σ points ≠ windows["24"] por diseño: tome los totales de windows y la evolución temporal de series.
Errores
Estado
Cuerpo
Cuándo
400
{"error": "symbol is required"}
Falta symbol, está en blanco, tiene más de 32 caracteres o no queda nada tras eliminar el sufijo de la moneda de cotización (p. ej. symbol=USDT)
404
{"error": "<SYMBOL> is not a collected symbol"}
Ningún exchange lista la moneda y ningún feed la reportó en las últimas 24 h — es una respuesta, no un fallo transitorio
503
{"error": "liquidation data unavailable"}
Los tramos del origen de datos no respondieron — reintentar más tarde; nunca debe leerse como «0 liquidaciones»
Notas
Cubre los feeds de liquidaciones de Binance, Bybit, Gate.io, OKX, HTX y Bitfinex.
Solo instantánea: sin start_date / end_date, y nada anterior a 24 h. Para el historial use get_alpha (un desequilibrio long/short normalizado, no importes en USD).
El tratamiento del símbolo difiere del de los demás endpoints de liquidaciones: get_alpha / get_map necesitan el formato de perpetuo de Binance (BTCUSDT); aquí BTC y BTCUSDT son la misma moneda.
Caché del servidor: 5 minutos.
El nocional en USD se convierte en el momento de la recopilación, así que los exchanges pueden sumarse.
Liquidaciones forzosas de todo el mercado, agregadas por exchange y como matriz moneda × exchange — el complemento de todo el mercado de /liquidation/get_coin. Usa el mismo marco móvil alineado a 5 minutos, así que el total de 24 h de una moneda es la misma cifra en ambos.
Parámetros
Nombre
Descripción
Valores permitidos
Predeterminado
hours
int · query
Longitud de la ventana. Fuera del rango → 400 (no se recorta); un valor no entero recurre sin aviso al valor por defecto
1–168
24
top_n
int · query
Cuántas monedas se listan individualmente; el resto va a others. Mismas reglas de rango / valor no entero que hours
Una fila por feed, ordenadas por total descendente: exchange, total_liq_usd, long_liq_usd, short_liq_usd, long_pct, short_pct, events, last_event_at. Siempre se listan todos los feeds: importes null = no se recibieron datos de ese feed en la ventana (se ordenan al final), 0.0 = conectado pero sin liquidaciones
exchanges[].price_basis / .coverage / .time_basis
string
—
Hasta qué punto es comparable esa fila: trade_avg / bankruptcy / unverified; full, full_unstated, sampled_1s, aggregated_1s, sampled_undisclosed; event. Consérvelos al volver a publicar las cifras — un feed muestreado no es un feed completo
coins[]
object[]
—
Las top_n primeras por total entre exchanges: token, token_id (0 cuando el símbolo no tiene id de token), total_liq_usd, long_liq_usd, short_liq_usd, by_exchange{name: {total/long/short_liq_usd}}. by_exchange es disperso — un feed sin nada para esa moneda no tiene clave; léalo como 0 cuando el total de ese feed en exchanges[] no es null
others
object
—
Todo lo que top_n dejó fuera, con los mismos campos más coin_count, de modo que coins[] + others vuelve a sumar el total de cada exchange
{"error": "hours must be between 1 and 168"} / {"error": "top_n must be between 1 and 50"}
Parámetro fuera de rango
Notas
Cubre los feeds de liquidaciones de Binance, Bybit, Gate.io, OKX, HTX y Bitfinex.
La ausencia total de datos (feeds caídos o fuente de datos inaccesible) sigue siendo un 200 con la misma estructura y todos los importes en null, buckets: 0 — nunca una tabla de ceros. Compruebe total.total_liq_usd antes de usar las cifras.
Solo totales — sin serie temporal. La evolución horaria de una moneda está en /liquidation/get_coin; una señal normalizada con historial largo, en /liquidation/get_alpha.
La ventana es móvil, no un día natural, y es el mismo marco que /liquidation/get_coin usa para windows["24"].
Caché del servidor: 5 minutos.
El nocional en USD se convierte en el momento de la recopilación, así que los exchanges pueden sumarse.
Todas las monedas recopiladas × todas las fuentes de ratio long/short, en este momento. Diez fuentes: Binance, OKX y Gate.io publican tres tipos cada uno — todas las cuentas, cuentas de top traders, posiciones de top traders — y Bybit publica solo cuentas. Las filas se ordenan por el nocional de interés abierto de Binance. Solo se listan las monedas que corresponden a una entrada de la lista de tokens de Blave; la respuesta con clave API es la tabla completa (full: true); la versión anónima de Studio, solo las filas de su lista blanca de 30 monedas.
Parámetros
Ninguno.
Ejemplo
Python
data = requests.get(f"{BASE_URL}/long_short_ratio/get_table", headers=headers, timeout=30).json()["data"]keys = [s["key"] for s in data["sources"] ifnot s["stale"]]btc = next(c for c in data["coins"] if c["token"] == "BTC")print({k: btc[k] for k in keys if btc[k] is notNone})#Live capture 2026-09-22 via the anonymous studio twin (/studio/charts/long_short_ratio/table) —#same inner shape; the API-key response wraps it in "data" and has full: true with every row.#{"coins": [{"binance_account": 0.8818, "binance_top_account": 1.0149, "binance_top_position": 2.2666,#"bybit_account": 1.0375, "gate_account": 0.7294, "gate_top_account": 0.6944,#"gate_top_position": 1.6436, "okx_account": 0.9084, "okx_top_account": 0.8655,#"okx_top_position": 1.0222, "token": "BTC", "token_id": 1}, ...],#"sources": [{"exchange": "binance", "key": "binance_account", "last_at": "2026-09-22T05:50:00+00:00",#"stale": false, "type": "account"}, ...,#{"exchange": "bybit", "key": "bybit_account", "last_at": "2026-09-22T05:50:00+00:00",#"stale": false, "type": "account"}],#"summary": {"binance_long_majority": 436, "binance_tokens": 509},#"tokens_shown": 30, "tokens_total": 611, "full": false, "updated_at": "2026-09-22T05:50:00+00:00"}
Inicio de la recopilación (primer tramo almacenado, medido en BTC el 2026-09-22)
Todas las fuentes tienen ya más antigüedad que los 7 días que sirve este conjunto de datos, así que ninguna limita una consulta — las fechas solo importan si se indica que una fuente «no tiene historial».
Una fila por moneda: token, token_id, más un valor por cada clave de fuente
coins[].<source key>
float / null
ratio
Cuentas (o posiciones) largas ÷ cortas. null = ese exchange no tiene ese feed para la moneda. Proporción de largos = r / (1 + r) — la API no la precalcula
sources[]
object[]
—
Los diez feeds, en el orden de las columnas. Lea este campo, nunca una lista de claves escrita a mano en el código
sources[].key
string
—
<exchange>_<type>, p. ej. binance_top_position — la clave usada en coins[]
La muestra más reciente de ese feed tiene más de 1 hora (medida respecto al momento actual). El updated_at del nivel superior es el de la fuente más reciente y no dice nada sobre ninguna en particular — evalúe cada fuente por su propio last_at / stale
summary.binance_tokens / .binance_long_majority
int
—
Monedas con un ratio de cuentas de Binance / de ellas, cuántas están por encima de 1. Se calcula sobre toda la tabla, no sobre las filas mostradas
tokens_shown / tokens_total
int
—
Filas devueltas / filas de la tabla. Son iguales con una clave API
full
bool
—
true con una clave API; false en la versión anónima de Studio
updated_at
string
ISO 8601 UTC
Tramo más reciente entre todas las fuentes
«Top trader» es una población distinta en cada exchange — no compare los niveles entre exchanges.
Bolsa
Quién cuenta como top trader (texto oficial original)
Binance
"the top 20% users with the highest margin balance"
OKX
"the top 5% of traders with the largest open position value"
Gate.io
No se ha publicado nunca — la documentación solo nombra los campos
Por tanto, que binance_top_account esté por encima de okx_top_account no dice nada sobre en qué exchange los grandes traders están más largos. Compare cada fuente con su propio historial.
Errores
Estado
Cuerpo
Cuándo
503
{"error": "long short ratio data unavailable"}
Sin instantánea reciente — reintentar más tarde; nunca debe leerse como un mercado vacío
Notas
Es un corte transversal, no un historial. Para una serie use /long_short_ratio/get_coin (7 días) — no existe un endpoint de historial largo para este conjunto de datos.
La granularidad es de 5 minutos, pero cada fuente publica a su propio ritmo — no lo describa como «se actualiza cada 5 minutos».
La instantánea es el último tramo que ha publicado cada fuente; los tramos de Gate.io y OKX llegan con unos 10 minutos de retraso.
Últimos 7 días, por hora + el último punto de 5 minutos
Actualización
Tramos de 5 minutos
Una moneda, las diez fuentes: el último valor de 5 minutos de cada una, una serie horaria de 7 días por fuente y el cierre del perpetuo de Binance en el mismo marco.
Parámetros
Nombre
Descripción
Valores permitidos
Predeterminado
symbol
string · queryObligatorio
Moneda. Se elimina el sufijo de la moneda de cotización; el symbol de la respuesta es el nombre normalizado de la moneda
BTC, BTCUSDT, btc (≤ 32 caracteres)
Ejemplo
Python
params = {"symbol": "BTC"}data = requests.get(f"{BASE_URL}/long_short_ratio/get_coin", headers=headers, params=params, timeout=30).json()["data"]latest = data["latest"]["binance_top_position"] # null when Binance does not list the coinif latest is notNone:r = latest["value"]print("top-trader long share:", round(r / (1 + r), 4))#Live capture 2026-09-22 (abridged with ...; anonymous studio twin, same inner shape):#{"latest": {"binance_account": {"ts": "2026-09-22T05:50:00+00:00", "value": 0.8818},#"binance_top_account": {"ts": "2026-09-22T05:50:00+00:00", "value": 1.0149}, ... 10 keys},#"series": {"bucket_seconds": 3600, "days": 7, "price_symbol": "BTCUSDT", "price_multiplier": 1,#"provisional_from": 1790053200,#"timestamp": [..., 1790049600, 1790053200],#"binance_account": [..., 0.8699, 0.8818], "price": [..., 85424.7, 85495.8], ... one array per source},#"sources": [{"exchange": "binance", "key": "binance_account", "last_at": "2026-09-22T05:50:00+00:00",#"listed": true, "stale": false, "type": "account"}, ... 10 rows],#"symbol": "BTC", "token_id": 1, "updated_at": "2026-09-22T05:50:00+00:00"}
{value, ts} — la muestra de 5 minutos más reciente de esa fuente; null cuando la fuente no lista la moneda
series.bucket_seconds / .days
int
s / d
3600 / 7
series.timestamp
int[]
s epoch
168 posiciones, de la más antigua → a la más reciente, una por hora
series.<source key>
float[] / null
ratio
Última muestra de cada hora; null para una hora sin muestra. Todo el campo es un único null (no un array) para una fuente que no lista la moneda
series.price
float[] / null
USD
Cierre del perpetuo de Binance en el mismo marco. Un único null (con price_symbol / price_multiplier también null) cuando la moneda no tiene perpetuo en Binance
series.price_symbol / .price_multiplier
string / int
—
De qué perpetuo procede el precio y su multiplicador de contrato (1000PEPEUSDT → 1000; price ÷ price_multiplier = precio por moneda)
series.provisional_from
int / null
s epoch
Primera posición que aún puede cambiar (las fuentes cierran sus datos hasta ~10 min tarde); null cuando ninguna fuente tiene datos
sources[]
object[]
—
La lista completa de fuentes, con los mismos campos que la tabla más listed
sources[].listed
bool
—
false = ese exchange no tiene ese feed para esta moneda; sus entradas latest y series son null
symbol / token_id / updated_at
—
—
Como en la tabla
Errores
Estado
Cuerpo
Cuándo
400
{"error": "symbol is required"}
Falta symbol, está en blanco, tiene más de 32 caracteres o no queda nada tras eliminar el sufijo de la moneda de cotización
404
{"error": "<SYMBOL> is not a collected symbol"}
Ninguna fuente recopila la moneda — es una respuesta, no un fallo transitorio
503
{"error": "long short ratio data unavailable"}
No se pudo leer una fuente listada. null solo significa «ese exchange no la lista»
Notas
Cubre los feeds de ratio long/short de Binance, OKX, Gate.io y Bybit.
La advertencia sobre los «top traders» entre exchanges de /long_short_ratio/get_table se aplica también aquí.
7 días es todo el historial que sirve este endpoint; no hay start_date / end_date.
Sobre la «versión anónima de Studio» en todas las capturas de los endpoints de datos sin procesar de esta página: las páginas de Studio (/studio/charts/...) sirven el mismo payload, generado por el mismo código, sin clave, y de ahí se tomaron estos ejemplos. No sustituyen a los endpoints con clave API: las tablas se recortan a 30 monedas (full: false), y una moneda fuera de la lista blanca de Studio responde 403 {"error_code": "ERR001", ..., "anon_whitelist": [...]} en lugar de datos. Los endpoints con clave API documentados aquí no tienen lista blanca ni recorte de filas.
Los tramos de Gate.io y OKX llegan con unos 10 minutos de retraso.
Todas las monedas recopiladas × cinco exchanges, en nocional USD. Base: solo perpetuos con margen en USDT, nocional en USD, un solo lado. Un exchange que reporta ambos lados se divide a la mitad (exchanges[].side_factor, Gate.io = 0.5). Como todos los valores ya son nocional en USD, los contratos con multiplicador (1000PEPE y similares) se suman entre exchanges sin reescalar.
Parámetros
Ninguno.
Ejemplo
Python
data = requests.get(f"{BASE_URL}/oi_imbalance/get_table", headers=headers, timeout=30).json()["data"]crowded = sorted((c for c in data["coins"] if c["oi_mcap"] is notNone), key=lambda c: -c["oi_mcap"])[:10]print(data["total"]["oi"], [(c["token"], round(c["oi_mcap"], 4)) for c in crowded])#Live capture 2026-09-22 (abridged with ...; anonymous studio twin, same inner shape):#{"coins": [{"token": "BTC", "token_id": 1, "oi_total": 18645450917.48, "chg_1h": -0.001775,#"chg_4h": -0.001046, "chg_24h": 0.128725, "market_cap": 1629947967503.241, "oi_mcap": 0.011439,#"by_exchange": {"binance": {"oi": 9417422808.02, "chg_1h": 2e-05, "chg_4h": 0.010203, "chg_24h": 0.067527},#"bingx": {"oi": 1328003926.8, ...},#"bybit": {"oi": 2569097877.96, "chg_1h": -0.008636, "chg_4h": -0.030159, "chg_24h": null},#"gate": {...}, "okx": {"oi": 2575361192.92, ..., "chg_24h": null}}}, ...],#"exchanges": [{"key": "binance", "oi": 24712717530.01, "side_factor": 1.0, "since": null, "full_7d": true,#"last_at": "2026-09-22T05:25:00+00:00", "stale": false}, ... 5 rows],#"total": {"oi": 47428938620.05, "chg_1h": -0.008919, "chg_4h": -0.010508, "chg_24h": 0.073881,#"n_exchanges": 5, "n_full_7d": 3},#"summary": {"oi_mcap_leader": "SAGA", "oi_mcap_leader_value": 1.718336},#"tokens_shown": 30, "tokens_total": 622, "full": false, "updated_at": "2026-09-22T05:30:00+00:00"}
Inicio de la recopilación (primer tramo almacenado, medido en BTC el 2026-09-22)
Bolsa
Recopilación desde
binance
2021-12-01
bingx
2025-04-15
gate
2026-08-12
okx
2026-09-21
bybit
2026-09-21
OKX y Bybit son la razón de que n_full_7d sea 3 de 5 y de que su chg_24h siguiera siendo null el 2026-09-22 — lea exchanges[].since / full_7d en lugar de estas fechas, que pierden vigencia.
Variación decimal (0.0675 = +6.75 %). Cada ventana cuenta solo los exchanges que tienen una referencia al inicio de esa ventana, con numerador y denominador sobre el mismo conjunto; null cuando ninguno la tiene
coins[].market_cap
float / null
USD
Capitalización de mercado; null cuando no hay ninguna utilizable
coins[].oi_mcap
float / null
ratio
oi_total ÷ market_cap; null cuando el token no tiene capitalización de mercado
coins[].by_exchange
object
—
{exchange: {oi, chg_1h, chg_4h, chg_24h}}, una clave por exchange; null cuando la moneda no está listada allí. Un null en una ventana concreta significa que ese exchange no tenía una referencia tan antigua — un feed más reciente que la ventana
exchanges[]
object[]
—
binance, okx, bingx, bybit, gate — oi de todo el mercado, side_factor, since, full_7d, last_at, stale
exchanges[].since / .full_7d
string / bool
fecha
El primer día del feed cuando tiene menos de 7 días de historial (full_7d: false); si no, null / true. Es informativo en esta tabla (no tiene ventana de 7 días); en /oi_imbalance/get_coin, un feed así no tiene referencia de 7 d y queda fuera de series.total
total
object
—
oi de todo el mercado, chg_1h/4h/24h, n_exchanges, n_full_7d
summary.oi_mcap_leader / _value
string / float
—
El mayor OI ÷ capitalización de mercado entre las 100 primeras monedas por OI
tokens_shown / tokens_total / full / updated_at
—
—
Como en la tabla de ratio long/short
No es la misma cifra que el indicador OI 失衡./oi_imbalance/get_overview_data (y el alpha oi_imbalance que hay detrás de las condiciones del screener y de las alertas) es un agregado de tres exchanges — Binance + OKX + BingX. Esta tabla abarca cinco exchanges con la base indicada arriba. Los dos valores de oi_total difieren, así que un umbral ajustado con uno no sirve para el otro.
Errores
Estado
Cuerpo
Cuándo
503
{"error": "open interest data unavailable"}
La tarea no tiene un resultado reciente (falta o tiene más de una hora) — nunca una tabla de ceros
Notas
chg_24h: null en OKX / Bybit en la captura anterior es la regla del feed reciente, no un hueco en el mercado: esos dos empezaron el 2026-09-21, así que aún no tenían referencia de 24 h.
Es un corte transversal, no un historial. Los últimos 7 días de una moneda (por hora, los cinco exchanges) están en /oi_imbalance/get_coin; un historial de longitud suficiente para backtests de una moneda en un exchange, en /oi_imbalance/get_history.
La instantánea incluye las variaciones de 1 h / 4 h / 24 h. La reconstruye una tarea programada aproximadamente cada 15 minutos a partir de tramos de origen de 5 minutos; los tramos de Gate.io y OKX llegan con unos 10 minutos de retraso.
El interés abierto de una moneda por exchange, con la misma base que la tabla: valor actual y proporción, cuatro ventanas de variación con los exchanges contados en cada una, y una línea de total horario de 7 días.
Parámetros
symbol, exactamente igual que en /long_short_ratio/get_coin.
La lista completa de los cinco exchanges: key, oi (USD), share (de oi_total), chg_1h/4h/24h/7d, side_factor, listed, since, full_7d, last_at, stale
exchanges[].listed
bool
—
false = la moneda no está listada allí; sus valores son null
oi_total / market_cap / oi_mcap
float
USD / ratio
Como en la tabla
oi_mcap_rank / tokens_total
int / null
—
Posición por oi_mcap en la última ronda de la tarea de la tabla; null cuando esa tarea no tiene un resultado reciente
windows.<1h|4h|24h|7d>.chg / .chg_usd
float / null
fracción / USD
Variación del total de los exchanges contados
windows.<w>.exchanges
string[]
—
Qué exchanges se contaron en esa ventana — un feed reciente no aparece, así que 24 h / 7 d pueden contar menos exchanges que 1 h
series.timestamp
int[]
s epoch
168 posiciones horarias, de la más antigua → a la más reciente
series.total
float[] / null
USD
OI total por posición — en esta línea solo están los series.total_exchanges (los feeds full_7d), así que no es comparable en nivel con oi_total. Una posición es null cuando alguno de esos exchanges no tiene muestra en esa hora; todo el campo es null cuando ningún exchange es full_7d para la moneda
400 / 404 / 503 exactamente igual que en /long_short_ratio/get_coin, con {"error": "open interest data unavailable"} en el 503.
Notas
Cubre el interés abierto de Binance, OKX, BingX, Bybit y Gate.io.
Que windows["1h"]["exchanges"] tenga cinco entradas mientras windows["24h"] tiene tres es la regla del feed reciente, no datos faltantes — lea esa lista antes de comparar ventanas.
La advertencia sobre OI 失衡 de /oi_imbalance/get_table se aplica también a este oi_total.
Solo siete días. Para una serie más larga con la que hacer backtests, use /oi_imbalance/get_history (un exchange, en monedas en lugar de USD — una base distinta de oi_total).
Los tramos de Gate.io y OKX llegan con unos 10 minutos de retraso.
El interés abierto de una moneda en un solo exchange, como serie temporal apta para backtests — la misma base que la tarjeta 未平倉量 del panel de Studio. alpha es interés abierto de un solo lado en monedas, no en USD. Los contratos con multiplicador se convierten de nuevo a monedas (1000PEPE devuelve un número de PEPE). Cada tramo es la última lectura de su periodo — el interés abierto es un saldo, nunca se suma.
Parámetros
Nombre
Descripción
Valores permitidos
Predeterminado
symbol
string · queryObligatorio
Moneda, con la misma regla que /oi_imbalance/get_coin
BTC, BTCUSDT, btc
period
string · queryObligatorio
Tamaño del tramo. 1w devuelve un 400 (unidad no admitida); 1m se interpreta como 1min, así que devuelve un 400 por ser inferior a 5min
binance, bybit, gate (sin distinguir mayúsculas de minúsculas)
binance
Ventana por solicitud: como máximo 365 días; un rango más largo se recorta sin aviso (start_date pasa a end_date − 365 días, sin error), como en /kline.
{"data": {"timestamp", "alpha", "close", "exchanges"}}, arrays paralelos, del más antiguo → al más reciente.
Campo
Tipo
Unidad
Descripción
timestamp
float[]
Segundos Unix (UTC)
Inicio del tramo
alpha
float[]
monedas
Interés abierto de un solo lado en oi_exchange, última lectura del tramo
close
float[]
USDT
Precio del perpetuo USDT-M de Binance — por unidad de contrato, es decir, por 1000 monedas en 1000PEPE
exchanges
string[]
—
El exchange realmente leído, p. ej. ["binance"]
alpha × close no es el interés abierto en USD en un contrato con multiplicador. Ahí close es el precio por unidad de contrato (por 1000 monedas en 1000PEPE), mientras que alpha está en monedas individuales — divida antes close por el multiplicador. En los contratos sin multiplicador, como BTC, alpha × close ≈ interés abierto en USD.
Gate.io: envíe siempre start_date ≥ 2026-03-28 — la ventana por defecto (end_date − 365 días) empieza antes del historial de Gate y devuelve un 400.
No es la misma cifra que /oi_imbalance/get_table / get_coin (cinco exchanges sumados, en USD) ni que el indicador OI 失衡 (/oi_imbalance/get_overview_data).
Errores
Estado
Cuerpo
Cuándo
400
{"error": "symbol is required"} / {"error": "period is required"}
Falta (aquí es un 400, no el 403 de los endpoints de indicadores)
400
{"error": "period must be at least 5min, in min / h / d units"}
period inferior a 5min (incluido 1m, que se interpreta como 1min) o en una unidad distinta de min / h / d (1w)
400
{"error": "invalid date format, expected YYYY-MM-DD"}
start_date / end_date mal formados
400
{"error": "start_date must not be after end_date"}
start_date > end_date
400
{"error": "oi_exchange must be one of binance, bybit, gate"}
oi_exchange fuera de la lista
400
{"error": "no <exchange> open interest for <TOKEN> at start_date; this exchange's history may start later — try a later start_date"}
La ventana empieza antes del historial de ese exchange (véase Datos desde). Sin start_date, oi_exchange=gate siempre cae en este caso hasta que su historial supere los 365 días (≈ 2027-03) — para Gate envíe siempre start_date ≥ 2026-03-28
404
{"error": "<TOKEN> is not a collected symbol on <exchange>"}
Ese exchange no lista la moneda, la moneda no tiene perpetuo en Binance o está deslistada — es una respuesta, no un fallo transitorio
503
{"error": "<exchange> open interest data unavailable for <TOKEN>"}
Los datos no se pudieron leer en este momento — reintentar
Notas
Cubre el interés abierto de Binance, Bybit y Gate.io; close es el precio del perpetuo USDT-M de Binance.
Un 200 con arrays vacíos significa que no hay ningún tramo en esa ventana (p. ej. la moneda se listó después) — no lo almacene en caché como un «sin datos» permanente.
Cuando end_date es hoy, el último tramo sigue cambiando hasta que se cierra su periodo.
Para un historial de más de 365 días, envíe una solicitud por año y concatene los resultados.
La resolución es de 5 minutos. La serie de cada exchange empieza en la fecha de Datos desde, o en la fecha de listado de la moneda en ese exchange si es posterior. Solo contratos listados actualmente.
Instantánea (ventanas móviles de 1 h / 4 h / 24 h)
Actualización
Aproximadamente cada 15 minutos
Importe negociado de compra y venta taker (órdenes a mercado) por moneda, en USD, en tres exchanges: Binance a partir del volumen de compra taker en moneda de cotización de la vela de 5 minutos (venta = el total de la vela menos ese volumen), OKX a partir de su volumen taker en USD, Gate.io a partir de los contratos taker × el multiplicador y el precio mark de la misma fila. Solo perpetuos — sin spot — y agregado a partir de velas de 5 minutos, no de operaciones individuales. Se usa el importe negociado que reporta cada exchange; el volumen nunca se multiplica por un precio tomado de otro exchange.
Parámetros
Ninguno.
Ejemplo
Python
data = requests.get(f"{BASE_URL}/taker_intensity/get_cvd_table", headers=headers, timeout=30).json()["data"]buying = sorted((c for c in data["coins"] if c["net_24h"] is notNone), key=lambda c: -c["net_24h"])[:10]print(data["total"]["net_24h"], [(c["token"], c["net_24h"]) for c in buying])#Live capture 2026-09-22 (abridged with ...; anonymous studio twin, same inner shape):#{"coins": [{"token": "BTC", "token_id": 1, "buy_24h": 24607245298.03, "sell_24h": 23128502231.73,#"net_1h": -212647361.27, "net_4h": -207128163.51, "net_24h": 1478743066.31,#"by_exchange": {"binance": {"buy_24h": 12663681424.94, "sell_24h": 12135756153.44,#"net_1h": -191133129.94, "net_4h": -217337267.5, "net_24h": 527925271.5},#"gate": {...}, "okx": {...}}}, ...],#"exchanges": [{"key": "binance", "buy_24h": 34978603608.55, "sell_24h": 35112588381.38,#"net_24h": -133984772.74, "last_at": "2026-09-22T05:25:00+00:00", "stale": false}, ... 3 rows],#"total": {"buy_24h": 63543431942.93, "sell_24h": 62491177680.21, "net_24h": 1052254262.8},#"tokens_shown": 30, "tokens_total": 591, "full": false, "updated_at": "2026-09-22T05:25:00+00:00"}
Inicio de la recopilación (primer tramo almacenado, medido en BTC el 2026-09-22)
Bolsa
Campo de origen
Recopilación desde
binance
kline de 5 minutos (importe negociado de compra taker)
2020-01-01
gate
contract_stats
2026-08-12
okx
taker_volume_usd
2026-09-21
OKX tiene además el límite de que el exchange conserva solo 5 días, así que sigue en full_7d: false hasta una semana después de esa fecha. Esta tabla no incluye since / full_7d (no tiene ventana de 7 días) — léalos por moneda en exchanges[] de /taker_intensity/get_cvd_coin, no en estas fechas.
Importe negociado de compra / venta taker en las 24 h móviles, sumado entre los exchanges de la moneda que no están desfasados; null cuando todos lo están
coins[].net_1h / .net_4h / .net_24h
float / null
USD
buy − sell en cada ventana móvil (misma regla de null)
coins[].by_exchange
object
—
{exchange: {buy_24h, sell_24h, net_1h, net_4h, net_24h}}, una clave por exchange; null cuando la moneda no está listada allí o los datos de ese exchange para ella están desfasados
exchanges[]
object[]
—
binance, okx, gate — buy_24h, sell_24h, net_24h de todo el mercado, last_at, stale
exchanges[].stale
bool
—
La última vela de ese feed tiene más de una hora: sus ventanas se devuelven como null y el feed queda fuera de los totales, en lugar de aportar una suma que, sin aviso, cubre menos que la ventana
total
object
USD
buy_24h, sell_24h, net_24h de todo el mercado sobre los exchanges con datos recientes
tokens_shown / tokens_total / full / updated_at
—
—
Como en las demás tablas de datos sin procesar
Errores
Estado
Cuerpo
Cuándo
503
{"error": "cvd data unavailable"}
La tarea no tiene un resultado reciente — nunca ceros
Notas
No es lo mismo que el alpha taker_intensity (/taker_intensity/get_alpha), que es una señal normalizada de tipo z-score con años de historial. Esto es importe negociado en USD sin procesar, en este momento.
Las ventanas son móviles y terminan en la última vela cerrada de 5 minutos, así que net_24h no es un día natural.
La reconstruye una tarea programada aproximadamente cada 15 minutos a partir de tramos de origen de 5 minutos; los tramos de Gate.io y OKX llegan con unos 10 minutos de retraso.
Compra / venta / neto taker de una moneda por exchange (misma base que la tabla), más un neto horario de 7 días y su acumulado — la propia línea de CVD.
Parámetros
symbol, exactamente igual que en /long_short_ratio/get_coin.
{buy, sell, net} sumados entre los exchanges con datos recientes
exchanges[]
object[]
—
La lista completa: key, listed, windows (las mismas cuatro, por exchange), since, full_7d, last_at, stale
exchanges[].full_7d
bool
—
false = menos de 7 días de historial para esta moneda allí: su ventana de 7 d es null y queda excluido del total de 7 d y de la serie. OKX conserva solo 5 días, así que es false hasta una semana después del inicio del feed
series.timestamp
int[]
s epoch
168 posiciones horarias, de la más antigua → a la más reciente
series.net
float[]
USD
Flujo taker neto por hora de reloj, sumado entre series.exchanges; null para una hora sin datos. Cuando series.exchanges está vacío, todas las posiciones son null y cvd se mantiene plano en 0 — en ese caso la línea no aporta información
series.cvd
float[]
USD
Total acumulado de net; cvd[0] = 0 — la línea es una forma, no un nivel absoluto
400 / 404 / 503 exactamente igual que en /long_short_ratio/get_coin, con {"error": "cvd data unavailable"} en el 503.
Notas
Cubre el flujo taker de Binance, OKX y Gate.io.
Que series.exchanges sea más corto que exchanges[] es la regla de full_7d — compare la serie consigo misma, no con windows["24h"], que cuenta más exchanges.
cvd[0] = 0 por construcción: solo la pendiente y los puntos de giro aportan información.
Los tramos de Gate.io y OKX llegan con unos 10 minutos de retraso.
Semanal, los viernes a las 15:30 (hora del Este de EE. UU.)
La última fila semanal de la CFTC para cada uno de los cuatro futuros cripto de CME, más la suma de estándar + micro en monedas por activo. Misma estructura que una fila de /cme_cot/get_history, sin price.
Unidad de las posiciones de contracts[].latest: contratos (× coin_per_contract para obtener monedas)
source
Línea de atribución de la CFTC — muéstrela junto a cualquier cifra que publique
source_updated
Cuándo actualizó la CFTC el conjunto de datos por última vez
fetched_at
Cuándo lo obtuvo Blave (UTC)
stale
true = no se pudo acceder a la CFTC y se sirve la última copia almacenada
Errores
Estado
Cuerpo
Cuándo
503
{"error": "CFTC data unavailable. Please retry shortly."}
No se pudo acceder a la CFTC y no hay copia almacenada
Notas
Para el historial use /cme_cot/get_history.
Las posiciones corresponden al martes (al lunes cuando el martes es festivo en EE. UU.) y la CFTC las publica el viernes de esa semana a las 15:30 (hora del Este de EE. UU.); un festivo federal entre miércoles y viernes traslada la publicación al siguiente día hábil, y un cierre del Gobierno la retrasa semanas.
Semanal, los viernes a las 15:30 (hora del Este de EE. UU.)
El posicionamiento semanal de un contrato por categoría de trader. Las filas llevan la fecha del informe — el día al que corresponden las posiciones, normalmente un martes (un lunes cuando el martes es festivo en EE. UU.). Los datos se hicieron públicos más tarde: normalmente el viernes de esa semana a las 15:30 ET; un festivo federal entre miércoles y viernes traslada la publicación al siguiente día hábil, y un cierre del Gobierno la retrasa semanas (los informes de 2018-12-24 … 2019-02-26 salieron el 2019-02-01 … 03-05; los informes de 2025-09-30 … 2026-01-20, el 2025-11-19 … 2026-01-23 — CFTC Releases 7864-19 y 9138-25). Un backtest no debe actuar sobre una fila antes de su publicación.
Parámetros
Nombre
Descripción
Valores permitidos
Predeterminado
contract
string · query
Los contratos individuales están en contratos; *_combined = estándar + micro sumados en monedas
{"data": {"contract": {...}, "rows": [...], "price_source", "report", "units", "source", "source_updated", "fetched_at", "stale"}}, filas de la más antigua → a la más reciente.
contract: key, name, coin, y cftc_code + coin_per_contract (contrato individual) o components + micro_since + note (combinado).
Cada fila:
Campo
Tipo
Descripción
date
string
Fecha del informe — normalmente un martes, un lunes cuando el martes es festivo en EE. UU.
open_interest / open_interest_change
number
Interés abierto total y su variación semanal
tff
object
Grupos dealer, asset_manager, leveraged_funds, other_reportables, nonreportable
legacy
object | null
Grupos non_commercial, commercial, nonreportable; null si la CFTC no tiene fila Legacy para esa semana
price
float | null
Cierre diario UTC del spot BTCUSDT / ETHUSDT de Binance en la fecha del informe; null cuando no está disponible
included
string[]
Solo contratos combinados: qué contratos suma esta fila (["btc"] antes de micro_since)
Cada grupo: long, short, spread (no en nonreportable / commercial), net (= long − short), y long_change, short_change, spread_change, net_change. Unidades: contratos para un contrato individual, monedas para uno combinado. Los campos *_change son las cifras semanales de la propia CFTC, no diferencias entre filas — la CFTC se salta semanas (p. ej. cierres del Gobierno), así que nunca calcule diferencias entre filas por su cuenta.
Errores
Estado
Cuerpo
Cuándo
400
{"error": "contract must be one of btc, micro_btc, eth, micro_eth, btc_combined, eth_combined"}
Contrato desconocido
400
{"error": "Invalid start_date, expected YYYY-MM-DD"} (o end_date) / {"error": "start_date must not be after end_date"}
Fecha no válida / rango invertido
503
{"error": "CFTC data unavailable. Please retry shortly."}
No se pudo acceder a la CFTC y no hay copia almacenada
Notas
*_combined tiene una discontinuidad en micro_since: la semana en que se incorpora el micro, los totales dan un salto y el *_change de esa semana incluye toda la primera posición del micro. Empiece un backtest combinado después de micro_since, o use el contrato individual btc / eth.
El historial completo de BTC son ~440 filas semanales (~0.5 MB) — una sola solicitud, sin paginación.
Licencia: los datos de la CFTC son de dominio público, pero la CFTC pide que se la cite — mantenga source junto a cualquier cifra que muestre. Sin respaldo de la CFTC.
Fecha de inicio por contrato: btc 2018-04-10, micro_btc 2021-05-04, eth 2021-04-06, micro_eth 2021-12-14. Los futuros de BTC propios de CME entran en el COT el 2018-04-10, no en su lanzamiento de 2017-12.
Caché del servidor: 1 hora.
price es el cierre diario UTC del spot de Binance.
Deja que tu IA haga quant en tu propio ordenador
Blave Desktop es gratis, de código abierto y no requiere registro. Conecta Claude Code o Codex: escribe la estrategia, ejecuta el backtest y opera en vivo.
Descargando.Arrástralo a Aplicaciones,ábrelo y elige tu IA.El primer inicio prepara su entornoy tarda unos minutos.Si te gusta, dale una estrella en GitHub.
Descargando. Al abrir el instalador, Windows muestra primero un aviso de seguridad:
Haz clic en el enlace que aparece debajo del texto.
Abajo aparece un botón nuevo: haz clic en él. Blave se instala y se abre solo.
El primer inicio prepara su entorno de ejecución y tarda unos minutos.
Windows avisa porque el instalador aún no tiene firma de código (ya la solicitamos), así que no puede identificar al editor. El código fuente es público en GitHub. Ver los pasos completos
