Volumen 24h—Interés abierto—Liquidaciones 24h$1.36B Largo/Corto 24h—Dominancia BTC—Dominancia ETH—

App

Idioma ▾

€ EUR ▾

/api/sd/coin

GETDisponible

Paquete único por moneda (OI, financiación, liquidaciones, volumen, largos/cortos)

Capa de datos propia: paquete único por moneda (OI / financiación / liquidaciones / volumen / largos-cortos, con aislamiento de fallos por bloque)

GET/api/sd/coin

Solicitud

Parámetros de consulta

Nombre	Tipo	Obligatorio	Valor por defecto	Valores admitidos	Descripción
coin	string	Obligatorio	—	—	Símbolo de la moneda; 400 cuando falta. Alias: `base`. Ejemplo: BTC

Solicitud de ejemplo

curl -s "https://www.coinboss.com/api/sd/coin?coin=BTC"

Campos de la respuesta

La tabla de campos se genera a partir de respuestas reales, por lo que recoge exactamente lo que devuelve el endpoint. Las rutas usan a[] para los elementos de un array y {*} para los objetos cuya clave es un nombre dinámico, como una moneda o un exchange.

Campo	Tipo	Unidad	Descripción
success	boolean	—	true cuando la solicitud se completó correctamente. En caso de fallo, el cuerpo es `{ success: false, code, error, request_id }`.
coin	string	—	Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
now	number	ms	Hora del servidor en el momento de generar la respuesta.
oi	object	—	El mismo objeto que devuelve `/api/sd/oi` para esta moneda.
oi.coin	string	—	Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
oi.now	number	ms	Hora del servidor en el momento de generar la respuesta.
oi.total_usd	number	USD	Interés abierto de todos los exchanges y contratos incluidos, tal como lo informa cada exchange (nocional USD).
oi.n_exchanges	number	—	Número de exchanges incluidos en el total.
oi.n_contracts	number	—	Número de contratos incluidos en el total.
oi.asof	number	ms	Hora de actualización más reciente entre las filas incluidas.
oi.total_usd_single_adjusted	number	USD	`total_usd` con las cifras de los exchanges que informan ambos lados (`double_sided.exchanges`) divididas entre dos, de modo que cada plataforma cuente un solo lado.
oi.double_sided	object	—	Exchanges de los que se sabe que publican el interés abierto largo + corto como una única cifra.
oi.double_sided.exchanges	array	—	Exchanges.
oi.double_sided.exchanges[]	string	—	Exchanges.
oi.double_sided.oi_usd	number	USD	Interés abierto informado por esos exchanges antes de dividirlo entre dos.
oi.by_kind	object	—	Reparto entre lineales e inversos.
oi.by_kind.linear_usd	number	USD	Interés abierto de los contratos lineales (con margen y liquidación en una stablecoin o en USD).
oi.by_kind.inverse_usd	number	USD	Interés abierto de los contratos inversos (con margen en moneda), convertido a USD al precio del contrato.
oi.by_margin	object	—	Reparto por moneda de margen.
oi.by_margin.other	number	USD	Otras monedas de margen (por ejemplo, plataformas con liquidación en USD como CME).
oi.by_margin.usdt	number	USD	Contratos con margen en USDT.
oi.by_margin.usdc	number	USD	Contratos con margen en USDC. puede faltar
oi.by_margin.coin	number	USD	Contratos con margen en moneda. puede faltar
oi.by_contract_type	object	—	Reparto entre perpetuos y futuros con vencimiento.
oi.by_contract_type.perpetual_usd	number	USD	Contratos perpetuos.
oi.by_contract_type.delivery_usd	number	USD	Futuros con fecha (contratos con vencimiento).
oi.change	object	—	Variación del interés abierto en 1h / 4h / 24h, calculada sobre el mismo conjunto de contratos en ambos extremos. claves dinámicas: h1,h4,h24
oi.change.{*}	object	—	Variación en el periodo indicado.
oi.change.{*}.pct	number	%	Variación porcentual entre `prev` y `cur`.
oi.change.{*}.cur	number	USD	Suma actual de los contratos emparejados.
oi.change.{*}.prev	number	USD	Suma de los mismos contratos en `prev_ts`.
oi.change.{*}.n_matched	number	—	Contratos (o exchanges) presentes en ambos extremos.
oi.change.{*}.n_total	number	—	Contratos (o exchanges) presentes ahora.
oi.change.{*}.matched_share_pct	number	%	Proporción del interés abierto actual cubierta por el conjunto emparejado. puede faltar
oi.change.{*}.prev_ts	number	ms	Hora de la instantánea de referencia.
oi.change.{*}.span_min	number	min	Distancia real entre la referencia y el momento actual.
oi.change.{*}.basis	string	—	Serie de instantáneas de la que procede la referencia.
oi.change.{*}.frozen_excluded	object	—	Filas excluidas de la variación porque su valor no cambió entre las dos instantáneas (el origen no se actualiza). puede faltar
oi.change.{*}.frozen_excluded.n_baseline	number	—	Elementos de la instantánea de referencia. puede faltar
oi.change.{*}.frozen_excluded.n_current	number	—	Elementos de la instantánea actual. puede faltar
oi.change.{*}.frozen_excluded.cur_usd	number	USD	Valor actual. puede faltar
oi.change.{*}.frozen_excluded.prev_usd	number	USD	Valor de referencia. puede faltar
oi.by_exchange	array	—	Desglose por exchange.
oi.by_exchange[]	object	—	Desglose por exchange.
oi.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
oi.by_exchange[].oi_usd	number	USD	Interés abierto en nocional USD.
oi.by_exchange[].share_pct	number	%	Cuota sobre el total.
oi.by_exchange[].n_contracts	number	—	Número de contratos.
oi.by_exchange[].linear_usd	number	USD	Contratos lineales.
oi.by_exchange[].inverse_usd	number	USD	Contratos inversos (con margen en moneda).
oi.by_exchange[].perpetual_usd	number	USD	Contratos perpetuos.
oi.by_exchange[].delivery_usd	number	USD	Contratos con vencimiento.
oi.by_exchange[].oi_side	string	—	`double` cuando el exchange informa ambos lados en una sola cifra, `single` cuando informa un lado, `unstated` cuando el exchange no lo documenta.
oi.by_exchange[].oi_usd_single_adjusted	number\|null	USD	Equivalente a un solo lado; null cuando la convención de lados no está declarada.
oi.by_exchange[].updated_at	number	ms	Momento de la última actualización de esta fila.
oi.by_exchange[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
oi.by_exchange[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
oi.contracts	array	—	Filas por contrato.
oi.contracts[]	object	—	Filas por contrato.
oi.contracts[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
oi.contracts[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
oi.contracts[].native_symbol	string\|null	—	Símbolo exactamente como lo escribe el exchange.
oi.contracts[].oi_usd	number	USD	Interés abierto en nocional USD.
oi.contracts[].oi_side	string	—	`double`, `single` o `unstated`: indica si el exchange informa ambos lados del interés abierto en una sola cifra.
oi.contracts[].oi_usd_single	number\|null	USD	Equivalente a un solo lado de `oi_usd`; null cuando la convención de lados no está declarada.
oi.contracts[].margin	string	—	Clase de moneda de margen: `usdt`, `usdc`, `coin` u `other`.
oi.contracts[].kind	string	—	`linear` o `inverse`.
oi.contracts[].contract_type	string	—	`perpetual` o `delivery`.
oi.contracts[].expiry_ts	number\|null	ms	Vencimiento de un contrato con vencimiento; null en los perpetuos o cuando no se publica.
oi.contracts[].margin_basis	string	—	Cómo se determinó la clase de margen (a partir de la especificación del contrato o del valor por defecto de la plataforma).
oi.contracts[].updated_at	number	ms	Momento de la última actualización de esta fila.
oi.contracts[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
oi.contracts[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
oi.contracts[].collector	string	—	Recolector interno que generó la fila.
oi.contracts[].included_since	number\|null	ms	Momento en que este contrato entró en los totales; null para el conjunto base.
oi.coverage	object	—	Qué se incluye y qué no en las cifras anteriores. Conviene revisarlo antes de comparar totales con otra fuente.
oi.coverage.included_exchanges	array	—	Exchanges cuyos datos se incluyen en los totales.
oi.coverage.included_exchanges[]	string	—	Exchanges incluidos en los totales.
oi.coverage.pending	array	—	Contratos que se recopilan pero aún no se incluyen en los totales (por ejemplo, mientras se sigue formando su propio historial de 25 horas). Se listan con su valor actual para que la diferencia sea visible.
oi.coverage.pending[]	object	—	Elementos recopilados pero aún no incluidos.
oi.coverage.pending[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
oi.coverage.pending[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
oi.coverage.pending[].native_symbol	string	—	Símbolo exactamente como lo escribe el exchange.
oi.coverage.pending[].margin	string	—	Clase de moneda de margen.
oi.coverage.pending[].contract_type	string	—	`perpetual` o `delivery`.
oi.coverage.pending[].oi_usd	number	USD	Interés abierto en nocional USD.
oi.coverage.pending[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
oi.coverage.pending[].reason	string	—	Código de motivo.
oi.coverage.pending[].detail	string\|null	—	Detalle.
oi.coverage.pending_usd	number\|null	USD	Suma de los contratos pendientes; no forma parte de `total_usd`.
oi.coverage.stale_excluded	array	—	Filas excluidas porque su última actualización está fuera de la ventana de uso. vacío en las muestras usadas para generar esta tabla
oi.coverage.unavailable	array	—	Pares exchange / contrato que no pudieron incluirse, cada uno con su motivo. Nunca se cuentan como 0.
oi.coverage.unavailable[]	object	—	Elementos para los que no hay datos disponibles, con sus motivos. Nunca se informan como 0.
oi.coverage.unavailable[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
oi.coverage.unavailable[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
oi.coverage.unavailable[].native_symbol	string	—	Símbolo exactamente como lo escribe el exchange.
oi.coverage.unavailable[].margin	string	—	Clase de moneda de margen.
oi.coverage.unavailable[].contract_type	string	—	`perpetual` o `delivery`.
oi.coverage.unavailable[].reason	string	—	Código de motivo.
oi.coverage.unavailable[].detail	string	—	Detalle.
oi.method	object	—	Enunciado en texto plano de las fórmulas utilizadas en esta respuesta.
oi.method.total	string	—	Total.
oi.method.usd	string	USD	Valor.
oi.method.change_h1_h4	string	—	Definición en texto plano de las variaciones de 1h y 4h del interés abierto: cada contrato se compara con su propia instantánea más cercana al inicio de la ventana.
oi.method.change_h24	string	—	Definición en texto plano de la variación de 24h del interés abierto: emparejamiento dentro del mismo exchange frente a la instantánea horaria más cercana a hace 24 horas, excluidas las referencias congeladas.
oi.method.oi_side	string	—	`double`, `single` o `unstated`: indica si el exchange informa ambos lados del interés abierto en una sola cifra.
funding	object	—	El mismo objeto que devuelve `/api/sd/funding` para esta moneda.
funding.coin	string	—	Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
funding.now	number	ms	Hora del servidor en el momento de generar la respuesta.
funding.unit	string	—	Unidad de todos los campos de tasa de esta respuesta: `fraction` (0.0001 = 0.01 %).
funding.avg_8h	number	fraction per 8h	Media simple de las tasas normalizadas a 8h, con un contrato por exchange.
funding.oi_weighted_8h	number	fraction per 8h	Media ponderada por interés abierto de las tasas normalizadas a 8h.
funding.apr_pct	number	% per year	Anualización simple: tasa de 8h × 3 × 365 × 100.
funding.apr_basis	string	—	Agregado en el que se basa el `apr_pct` principal.
funding.n_exchanges	number	—	Número de exchanges que aportan datos.
funding.n_normalized	number	—	Exchanges cuyo intervalo de financiación se conoce y pudo normalizarse a 8h.
funding.n_unknown_interval	number	—	Exchanges excluidos de los agregados porque se desconoce su intervalo de financiación.
funding.settled_cum_7d	object	—	Suma de las tasas de financiación efectivamente liquidadas en los últimos 7 días, promediada entre los exchanges con historial de pagos.
funding.settled_cum_7d.avg	number	fraction	Media simple entre exchanges.
funding.settled_cum_7d.oi_weighted	number	fraction	Media ponderada por interés abierto.
funding.settled_cum_7d.n	number	—	Exchanges con una ventana completa.
funding.settled_cum_30d	object	—	Lo mismo, a 30 días.
funding.settled_cum_30d.avg	number	fraction	Media simple entre exchanges.
funding.settled_cum_30d.oi_weighted	number	fraction	Media ponderada por interés abierto.
funding.settled_cum_30d.n	number	—	Exchanges con una ventana completa.
funding.by_exchange	array	—	Una fila por exchange: su contrato principal para esta moneda (el de mayor interés abierto).
funding.by_exchange[]	object	—	Desglose por exchange.
funding.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
funding.by_exchange[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
funding.by_exchange[].margin	string	—	Clase de moneda de margen.
funding.by_exchange[].kind	string	—	Clase.
funding.by_exchange[].primary	boolean	—	True para el contrato que representa a su exchange en los agregados (el de mayor interés abierto); siempre true en esta lista.
funding.by_exchange[].rate	number	—	Tasa.
funding.by_exchange[].interval_h	number	h	Intervalo.
funding.by_exchange[].rate_8h	number	—	Tasa normalizada a un periodo de 8 horas.
funding.by_exchange[].apr_pct	number	% per year	Porcentaje anualizado.
funding.by_exchange[].next_funding_time	number\|null	ms	Marca de tiempo.
funding.by_exchange[].next_derived	boolean	—	True cuando el exchange no publicó `next_funding_time` y se infiere como la siguiente hora UTC en punto (solo en plataformas con pago horario).
funding.by_exchange[].predicted_rate	null	—	Tasa indicativa del próximo periodo; null cuando no se publica.
funding.by_exchange[].oi_usd	number\|null	USD	Interés abierto en nocional USD.
funding.by_exchange[].updated_at	number	ms	Momento de la última actualización de esta fila.
funding.by_exchange[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
funding.by_exchange[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
funding.by_exchange[].settled	object\|null	—	Registros de pagos reales; null cuando no existe historial público.
funding.by_exchange[].settled.last_rate	number	fraction	Tasa de financiación efectivamente cobrada en el pago más reciente (`last_time`), según el historial de financiación del exchange (0.0001 = 0.01 %). puede faltar
funding.by_exchange[].settled.last_time	number	ms	Marca de tiempo. puede faltar
funding.by_exchange[].settled.interval_h	number	h	Intervalo. puede faltar
funding.by_exchange[].settled.cum_7d	number	fraction	Suma de las tasas de financiación liquidadas en este contrato en los últimos 7 días (0.0015 = 0.15 %); null cuando no se registró ningún pago. puede faltar
funding.by_exchange[].settled.n_7d	number	count	Número de registros de pagos recopilados de los últimos 7 días. puede faltar
funding.by_exchange[].settled.n_7d_expected	number	count	Pagos que debería contener una ventana completa de 7 días: 168 ÷ intervalo de pago en horas; null cuando se desconoce el intervalo. puede faltar
funding.by_exchange[].settled.cum_7d_complete	boolean	—	True cuando el historial cubre el inicio de la ventana de 7 días y contiene al menos el 90 % de los pagos esperados. puede faltar
funding.by_exchange[].settled.cum_30d	number	fraction	Suma de las tasas de financiación liquidadas en este contrato en los últimos 30 días (0.006 = 0.6 %). puede faltar
funding.by_exchange[].settled.n_30d	number	count	Número de registros de pagos recopilados de los últimos 30 días. puede faltar
funding.by_exchange[].settled.n_30d_expected	number	count	Pagos que debería contener una ventana completa de 30 días: 720 ÷ intervalo de pago en horas; null cuando se desconoce el intervalo. puede faltar
funding.by_exchange[].settled.cum_30d_complete	boolean	—	True cuando el historial cubre el inicio de la ventana de 30 días y contiene al menos el 90 % de los pagos esperados. puede faltar
funding.by_exchange[].settled.history_from	number	ms	Registro más antiguo conservado. puede faltar
funding.other_contracts	array	—	Otros contratos de la misma moneda (USDC, con margen en moneda, …). No forman parte de los agregados.
funding.other_contracts[]	object	—	Un contrato de financiación adicional de un exchange (con margen en moneda, USDC, …) que no es su contrato principal y se excluye de los agregados.
funding.other_contracts[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
funding.other_contracts[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
funding.other_contracts[].margin	string	—	Clase de moneda de margen.
funding.other_contracts[].kind	string	—	Clase.
funding.other_contracts[].primary	boolean	—	False en todas las filas de esta lista: el contrato no es el que representa a su exchange en los agregados.
funding.other_contracts[].rate	number	—	Tasa.
funding.other_contracts[].interval_h	number\|null	h	Intervalo.
funding.other_contracts[].rate_8h	number\|null	—	Tasa normalizada a un periodo de 8 horas.
funding.other_contracts[].apr_pct	number\|null	% per year	Porcentaje anualizado.
funding.other_contracts[].next_funding_time	number\|null	ms	Marca de tiempo.
funding.other_contracts[].next_derived	boolean	—	True cuando el exchange no publicó `next_funding_time` y se infiere como la siguiente hora UTC en punto (solo en plataformas con pago horario).
funding.other_contracts[].predicted_rate	number\|null	—	Tasa indicativa del próximo periodo; null cuando no se publica.
funding.other_contracts[].oi_usd	number\|null	USD	Interés abierto en nocional USD.
funding.other_contracts[].updated_at	number	ms	Momento de la última actualización de esta fila.
funding.other_contracts[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
funding.other_contracts[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
funding.other_contracts[].settled	object\|null	—	Registros de pagos reales; null cuando no existe historial público.
funding.other_contracts[].settled.last_rate	number	fraction	Tasa de financiación efectivamente cobrada en el pago más reciente (`last_time`), según el historial de financiación del exchange (0.0001 = 0.01 %). puede faltar
funding.other_contracts[].settled.last_time	number	ms	Marca de tiempo. puede faltar
funding.other_contracts[].settled.interval_h	number	h	Intervalo. puede faltar
funding.other_contracts[].settled.cum_7d	number	fraction	Suma de las tasas de financiación liquidadas en este contrato en los últimos 7 días (0.0015 = 0.15 %); null cuando no se registró ningún pago. puede faltar
funding.other_contracts[].settled.n_7d	number	count	Número de registros de pagos recopilados de los últimos 7 días. puede faltar
funding.other_contracts[].settled.n_7d_expected	number	count	Pagos que debería contener una ventana completa de 7 días: 168 ÷ intervalo de pago en horas; null cuando se desconoce el intervalo. puede faltar
funding.other_contracts[].settled.cum_7d_complete	boolean	—	True cuando el historial cubre el inicio de la ventana de 7 días y contiene al menos el 90 % de los pagos esperados. puede faltar
funding.other_contracts[].settled.cum_30d	number	fraction	Suma de las tasas de financiación liquidadas en este contrato en los últimos 30 días (0.006 = 0.6 %). puede faltar
funding.other_contracts[].settled.n_30d	number	count	Número de registros de pagos recopilados de los últimos 30 días. puede faltar
funding.other_contracts[].settled.n_30d_expected	number	count	Pagos que debería contener una ventana completa de 30 días: 720 ÷ intervalo de pago en horas; null cuando se desconoce el intervalo. puede faltar
funding.other_contracts[].settled.cum_30d_complete	boolean	—	True cuando el historial cubre el inicio de la ventana de 30 días y contiene al menos el 90 % de los pagos esperados. puede faltar
funding.other_contracts[].settled.history_from	number	ms	Registro más antiguo conservado. puede faltar
funding.coverage	object	—	Qué se incluye y qué no en las cifras anteriores. Conviene revisarlo antes de comparar totales con otra fuente.
funding.coverage.settle_history_exchanges	array	—	Exchanges de los que se recopilan registros de pagos reales.
funding.coverage.settle_history_exchanges[]	string	—	Id del exchange del que se recopilan registros de pagos reales de financiación para esta moneda.
funding.coverage.no_settle_history	array	—	Exchanges sin una fuente pública de historial de pagos; su `settled` es null.
funding.coverage.no_settle_history[]	string	—	Id del exchange de un contrato principal sin historial de pagos recopilado, por lo que su bloque `settled` es null.
funding.coverage.unknown_interval	array	—	Filas cuyo intervalo de financiación no pudo determinarse. vacío en las muestras usadas para generar esta tabla
funding.coverage.no_liveness_excluded	array	—	Filas excluidas porque el contrato no muestra señales de negociación (sin ticker, interés abierto ni cotización recientes). vacío en las muestras usadas para generar esta tabla
funding.method	object	—	Enunciado en texto plano de las fórmulas utilizadas en esta respuesta.
funding.method.rate	string	—	Tasa.
funding.method.rate_8h	string	—	Tasa normalizada a un periodo de 8 horas.
funding.method.apr_pct	string	% per year	Porcentaje anualizado.
funding.method.aggregate	string	—	Agregado entre exchanges.
funding.method.settled	string	—	Registros de pagos reales; null cuando no existe historial público.
funding.method.predicted_rate	string	—	Tasa indicativa del próximo periodo; null cuando no se publica.
funding.method.liveness	string	—	Regla en texto plano para descartar contratos muertos: una fila de financiación solo cuenta si tiene un ticker de menos de 1h, interés abierto de menos de 3h o una cotización propia de menos de 3h.
liquidations	object	—	El mismo objeto que devuelve `/api/sd/liquidations` para esta moneda.
liquidations.coin	string	—	Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
liquidations.now	number	ms	Hora del servidor en el momento de generar la respuesta.
liquidations.windows	object	—	Totales de cada ventana (claves como `1h`, `4h`, `12h`, `24h`). claves dinámicas: 1h,4h,12h,24h
liquidations.windows.{*}	object	—	Valores por ventana.
liquidations.windows.{*}.long_usd	number	USD	Posiciones largas liquidadas; null cuando ninguna fuente cubrió la ventana.
liquidations.windows.{*}.short_usd	number	USD	Posiciones cortas liquidadas; null cuando ninguna fuente cubrió la ventana.
liquidations.windows.{*}.total_usd	number	USD	Largos + cortos.
liquidations.windows.{*}.count	number	—	Número de órdenes de liquidación.
liquidations.windows.{*}.long_pct	number	%	Cuota de los largos sobre el total.
liquidations.windows.{*}.max_order	object	—	Mayor liquidación individual de la ventana.
liquidations.windows.{*}.max_order.exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
liquidations.windows.{*}.max_order.symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
liquidations.windows.{*}.max_order.side	string	—	`long` / `short` o `buy` / `sell`.
liquidations.windows.{*}.max_order.price	number	—	Último precio en la moneda de cotización (USD o USDT salvo que se indique otra cosa).
liquidations.windows.{*}.max_order.qty	number	—	Cantidad.
liquidations.windows.{*}.max_order.contract_multiplier	number	x	Monedas por unidad cotizada del contrato de la orden más grande (1000 en los contratos del tipo 1000PEPE); `price` y `qty` ya están convertidos a monedas individuales.
liquidations.windows.{*}.max_order.value_usd	number	USD	Valor.
liquidations.windows.{*}.max_order.timestamp	number	ms	Marca de tiempo.
liquidations.by_exchange	object	—	Reparto por exchange para cada ventana. claves dinámicas: 1h,4h,12h,24h
liquidations.by_exchange.{*}	array	—	Desglose por exchange.
liquidations.by_exchange.{*}[]	object	—	Desglose por exchange.
liquidations.by_exchange.{*}[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
liquidations.by_exchange.{*}[].long_usd	number	USD	Lado largo.
liquidations.by_exchange.{*}[].short_usd	number	USD	Lado corto.
liquidations.by_exchange.{*}[].total_usd	number	USD	Total.
liquidations.by_exchange.{*}[].count	number	—	Número de elementos.
liquidations.by_exchange.{*}[].share_pct	number	%	Cuota sobre el total.
liquidations.last_event_at	number	ms	Hora de la liquidación más reciente de esta moneda.
liquidations.last_event_age_s	number	s	Segundos transcurridos desde ese evento.
liquidations.sources	array	—	Estado de cada feed de liquidaciones: cómo se recopila y cuándo entregó datos por última vez.
liquidations.sources[]	object	—	Fuentes de datos.
liquidations.sources[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
liquidations.sources[].via	string	—	Método de recopilación (`ws`, `rest`, …).
liquidations.sources[].status	string	—	Estado del feed, evaluado a partir de las horas de sus propios eventos y de sus latidos.
liquidations.sources[].feed_last_event_age_s	number\|null	s	Segundos transcurridos desde el evento.
liquidations.sources[].ws_heartbeat_age_s	number\|null	s	Segundos transcurridos desde el evento.
liquidations.sources[].judged_by	string	—	Marca de tiempo a partir de la cual se evaluó el estado.
liquidations.sources[].coin_last_event_age_s	number\|null	s	Segundos transcurridos desde el evento.
liquidations.sources[].min_event_usd	number	USD	Tamaño mínimo de orden que publica el feed; las liquidaciones menores no son visibles en esta plataforma.
liquidations.sources[].note	string\|null	—	Nota.
liquidations.sources[].node_heartbeat_age_s	number	s	Segundos transcurridos desde el evento. puede faltar
liquidations.sources[].pipeline_last_event_age_s	number	s	Segundos transcurridos desde el evento. puede faltar
liquidations.coverage	object	—	Qué se incluye y qué no en las cifras anteriores. Conviene revisarlo antes de comparar totales con otra fuente.
liquidations.coverage.collected_exchanges	array	—	Exchanges con un feed público de liquidaciones que CoinBoss recopila.
liquidations.coverage.collected_exchanges[]	string	—	Exchanges recopilados.
liquidations.coverage.unavailable	array	—	Pares exchange / contrato que no pudieron incluirse, cada uno con su motivo. Nunca se cuentan como 0.
liquidations.coverage.unavailable[]	object	—	Elementos para los que no hay datos disponibles, con sus motivos. Nunca se informan como 0.
liquidations.coverage.unavailable[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
liquidations.coverage.unavailable[].reason	string	—	Código de motivo.
liquidations.method	object	—	Enunciado en texto plano de las fórmulas utilizadas en esta respuesta.
liquidations.method.event	string	—	Nota en texto plano sobre qué es un evento de liquidación: una orden de liquidación enviada por el flujo del exchange o devuelta por su API REST pública.
liquidations.method.side	string	—	`long` / `short` o `buy` / `sell`.
liquidations.method.value_usd	string	USD	Valor.
liquidations.method.dedupe	string	—	Nota en texto plano sobre la deduplicación: los eventos son únicos por exchange, símbolo, lado, precio, valor y marca de tiempo, más el id de orden del exchange cuando se proporciona.
liquidations.method.null_rule	string	—	Nota en texto plano que indica que una ventana sin ningún evento recopilado devuelve null y no 0, y dónde se listan los exchanges sin un feed público.
liquidations.method.binance_note	string	—	Advertencia en texto plano de que Binance envía como máximo una liquidación por símbolo y segundo, por lo que los totales de Binance son un límite inferior.
liquidations.method.min_event_usd	string	USD	Orden más pequeña que publica el feed.
volume	object	—	El mismo objeto que devuelve `/api/sd/volume` para esta moneda.
volume.coin	string	—	Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
volume.now	number	ms	Hora del servidor en el momento de generar la respuesta.
volume.futures	object	—	Bloque o valor del mercado de futuros.
volume.futures.total_usd	number	USD	Volumen de futuros de 24h entre exchanges (nocional USD).
volume.futures.n_exchanges	number	—	Número de exchanges que aportan datos.
volume.futures.by_exchange	array	—	Desglose por exchange.
volume.futures.by_exchange[]	object	—	Desglose por exchange.
volume.futures.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
volume.futures.by_exchange[].vol_usd	number	USD	Volumen en nocional USD.
volume.futures.by_exchange[].legacy_usd	number	USD	Parte del volumen que procede del conjunto de tickers de perpetuos USDT.
volume.futures.by_exchange[].sd_usd	number	USD	Parte que procede de contratos adicionales (USDC, con margen en moneda, con vencimiento) ya incluidos.
volume.futures.by_exchange[].share_pct	number	%	Cuota sobre el total.
volume.futures.change_24h	object	—	Variación de 24h.
volume.futures.change_24h.pct	number	%	Porcentaje.
volume.futures.change_24h.cur	number	—	Valor actual.
volume.futures.change_24h.prev	number	—	Valor anterior (referencia).
volume.futures.change_24h.n_matched	number	—	Elementos presentes en ambos extremos de la comparación.
volume.futures.change_24h.n_total	number	—	Elementos presentes ahora.
volume.futures.change_24h.prev_ts	number	ms	Hora de la instantánea de referencia.
volume.futures.change_24h.basis	string	—	Precio de futuros menos precio spot, o el bloque de base.
volume.futures.selfdata_contracts	object	—	Contratos adicionales: qué está ya incluido y qué sigue pendiente.
volume.futures.selfdata_contracts.included_usd	null	USD	Volumen de 24h de los contratos recopilados adicionalmente (con margen en moneda, USDC, con vencimiento) ya contabilizados en el total de futuros; null cuando aún no se contabiliza ninguno.
volume.futures.selfdata_contracts.n_included	number	count	Número de contratos recopilados adicionalmente que se contabilizan en el total de futuros (los que tienen su propia instantánea de hace unas 24 horas).
volume.futures.selfdata_contracts.pending_usd	number\|null	USD	Suma de los elementos pendientes; no está en el total.
volume.futures.selfdata_contracts.n_pending	number	count	Número de contratos recopilados adicionalmente que aún no se contabilizan porque carecen de su propia referencia de hace 24h; los mayores se listan en `pending`.
volume.futures.selfdata_contracts.pending	array	—	Elementos recopilados pero aún no incluidos.
volume.futures.selfdata_contracts.pending[]	object	—	Elementos recopilados pero aún no incluidos.
volume.futures.selfdata_contracts.pending[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
volume.futures.selfdata_contracts.pending[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
volume.futures.selfdata_contracts.pending[].margin	string	—	Clase de moneda de margen.
volume.futures.selfdata_contracts.pending[].contract_type	string	—	`perpetual` o `delivery`.
volume.futures.selfdata_contracts.pending[].vol_usd	number	USD	Volumen en nocional USD.
volume.futures.selfdata_contracts.pending[].reason	string	—	Código de motivo.
volume.spot	object	—	Bloque o valor del mercado spot.
volume.spot.total_usd	number	USD	Volumen spot de 24h entre exchanges.
volume.spot.n_exchanges	number	—	Número de exchanges que aportan datos.
volume.spot.asof	number	ms	Hora del dato más reciente utilizado.
volume.spot.by_exchange	array	—	Desglose por exchange.
volume.spot.by_exchange[]	object	—	Desglose por exchange.
volume.spot.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
volume.spot.by_exchange[].vol_usd	number	USD	Volumen en nocional USD.
volume.spot.by_exchange[].quote	string	—	Monedas de cotización incluidas para este exchange.
volume.spot.by_exchange[].ts	number	ms	Marca de tiempo.
volume.spot.by_exchange[].price	number	—	Último precio en la moneda de cotización (USD o USDT salvo que se indique otra cosa).
volume.spot.by_exchange[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
volume.spot.by_exchange[].share_pct	number	%	Cuota sobre el total.
volume.spot.change_24h	object	—	Variación de 24h.
volume.spot.change_24h.pct	number	%	Porcentaje.
volume.spot.change_24h.cur	number	—	Valor actual.
volume.spot.change_24h.prev	number	—	Valor anterior (referencia).
volume.spot.change_24h.n_matched	number	—	Elementos presentes en ambos extremos de la comparación.
volume.spot.change_24h.n_total	number	—	Elementos presentes ahora.
volume.spot.change_24h.prev_ts	number	ms	Hora de la instantánea de referencia.
volume.spot.change_24h.basis	string	—	Precio de futuros menos precio spot, o el bloque de base.
volume.ratios	object	—	Ratios de volumen: `futures_to_spot` (volumen de futuros de 24h ÷ volumen spot de 24h) y `oi_to_futures_volume`; cada uno es null cuando falta un dato de entrada.
volume.ratios.futures_to_spot	number	—	Volumen de futuros dividido entre el volumen spot.
volume.ratios.oi_to_futures_volume	number	—	Interés abierto dividido entre el volumen de futuros de 24h.
volume.method	object	—	Enunciado en texto plano de las fórmulas utilizadas en esta respuesta.
volume.method.futures	string	—	Bloque o valor del mercado de futuros.
volume.method.spot	string	—	Bloque o valor del mercado spot.
volume.method.change	string	—	Variación en el periodo indicado.
volume.method.oi_to_futures_volume	string	—	Definición en texto plano de `ratios.oi_to_futures_volume`: interés abierto total en USD ÷ volumen de futuros de 24h en USD.
ls	object	—	El mismo objeto que devuelve `/api/sd/ls` para esta moneda.
ls.coin	string	—	Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
ls.now	number	ms	Hora del servidor en el momento de generar la respuesta.
ls.account	object	—	Proporción de todas las cuentas que están netamente largas frente a netamente cortas.
ls.account.long_pct	number	%	Cuota de largos.
ls.account.short_pct	number	%	Cuota de cortos.
ls.account.ratio	number	—	Ratio.
ls.account.n_exchanges	number	—	Número de exchanges que aportan datos.
ls.account.by_exchange	array	—	Desglose por exchange.
ls.account.by_exchange[]	object	—	Desglose por exchange.
ls.account.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
ls.account.by_exchange[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
ls.account.by_exchange[].long_pct	number	%	Cuota de largos.
ls.account.by_exchange[].short_pct	number	%	Cuota de cortos.
ls.account.by_exchange[].ratio	number	—	Ratio.
ls.account.by_exchange[].updated_at	number	ms	Momento de la última actualización de esta fila.
ls.account.by_exchange[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
ls.account.by_exchange[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
ls.account.by_exchange[].source	string	—	De dónde procede el valor.
ls.account.by_exchange[].period	string	—	Periodo.
ls.top_account	object	—	Lo mismo, restringido a los top traders definidos por el exchange.
ls.top_account.long_pct	number\|null	%	Cuota de largos.
ls.top_account.short_pct	number\|null	%	Cuota de cortos.
ls.top_account.ratio	number\|null	—	Ratio.
ls.top_account.n_exchanges	number	—	Número de exchanges que aportan datos.
ls.top_account.by_exchange	array	—	Desglose por exchange.
ls.top_account.by_exchange[]	object	—	Desglose por exchange.
ls.top_account.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
ls.top_account.by_exchange[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
ls.top_account.by_exchange[].long_pct	number	%	Cuota de largos.
ls.top_account.by_exchange[].short_pct	number	%	Cuota de cortos.
ls.top_account.by_exchange[].ratio	number	—	Ratio.
ls.top_account.by_exchange[].updated_at	number	ms	Momento de la última actualización de esta fila.
ls.top_account.by_exchange[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
ls.top_account.by_exchange[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
ls.top_account.by_exchange[].source	string	—	De dónde procede el valor.
ls.top_account.by_exchange[].period	string	—	Periodo.
ls.top_position	object	—	Cuota de largos frente a cortos de las posiciones mantenidas por los top traders.
ls.top_position.long_pct	number\|null	%	Cuota de largos.
ls.top_position.short_pct	number\|null	%	Cuota de cortos.
ls.top_position.ratio	number\|null	—	Ratio.
ls.top_position.n_exchanges	number	—	Número de exchanges que aportan datos.
ls.top_position.by_exchange	array	—	Desglose por exchange.
ls.top_position.by_exchange[]	object	—	Desglose por exchange.
ls.top_position.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
ls.top_position.by_exchange[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
ls.top_position.by_exchange[].long_pct	number	%	Cuota de largos.
ls.top_position.by_exchange[].short_pct	number	%	Cuota de cortos.
ls.top_position.by_exchange[].ratio	number	—	Ratio.
ls.top_position.by_exchange[].updated_at	number	ms	Momento de la última actualización de esta fila.
ls.top_position.by_exchange[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
ls.top_position.by_exchange[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
ls.top_position.by_exchange[].source	string	—	De dónde procede el valor.
ls.top_position.by_exchange[].period	string	—	Periodo.
ls.position_all	object	—	Cuota de largos frente a cortos de todas las posiciones (plataformas que la publican).
ls.position_all.long_pct	number\|null	%	Cuota de largos.
ls.position_all.short_pct	number\|null	%	Cuota de cortos.
ls.position_all.ratio	number\|null	—	Ratio.
ls.position_all.n_exchanges	number	—	Número de exchanges que aportan datos.
ls.position_all.by_exchange	array	—	Desglose por exchange.
ls.position_all.by_exchange[]	object	—	Desglose por exchange.
ls.position_all.by_exchange[].exchange	string	—	Id del exchange, en minúsculas (por ejemplo `binance`).
ls.position_all.by_exchange[].symbol	string	—	Símbolo del instrumento tal como lo normaliza CoinBoss (por ejemplo BTCUSDT).
ls.position_all.by_exchange[].long_pct	number	%	Cuota de largos.
ls.position_all.by_exchange[].short_pct	number	%	Cuota de cortos.
ls.position_all.by_exchange[].ratio	number	—	Ratio.
ls.position_all.by_exchange[].updated_at	number	ms	Momento de la última actualización de esta fila.
ls.position_all.by_exchange[].age_s	number	s	Segundos transcurridos desde la última actualización de esta fila.
ls.position_all.by_exchange[].is_stale	boolean	—	true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
ls.position_all.by_exchange[].source	string	—	De dónde procede el valor.
ls.position_all.by_exchange[].period	string	—	Periodo.
ls.taker	object	—	Cuota del volumen de compra taker frente al de venta taker.
ls.taker.long_pct	number\|null	%	Cuota de largos.
ls.taker.short_pct	number\|null	%	Cuota de cortos.
ls.taker.ratio	number\|null	—	Ratio.
ls.taker.n_exchanges	number	—	Número de exchanges que aportan datos.
ls.taker.by_exchange	array	—	Desglose por exchange.
ls.definitions	object	—	Definición de cada medida. Las cinco medidas responden a preguntas distintas y nunca se mezclan. puede faltar
ls.definitions.account	string	—	Medida basada en cuentas. puede faltar
ls.definitions.top_account	string	—	Medida por cuentas de top traders. puede faltar
ls.definitions.top_position	string	—	Medida por posiciones de top traders. puede faltar
ls.definitions.position_all	string	—	Medida de todas las posiciones. puede faltar
ls.definitions.taker	string	—	Medida de compra / venta taker. puede faltar
ls.method	object	—	Enunciado en texto plano de las fórmulas utilizadas en esta respuesta. puede faltar
ls.method.normalize	string	—	Nota en texto plano sobre la normalización: el valor de cada exchange se reescala para que % de largos + % de cortos = 100, y ratio = % de largos ÷ % de cortos. puede faltar
ls.method.aggregate	string	—	Agregado entre exchanges. puede faltar
ls.method.freshness	string	—	Regla de frescura en texto plano: se muestran las filas actualizadas en las últimas 24 horas e `is_stale` marca las filas con más de 2 horas de antigüedad. puede faltar
errors	object	—	Partes del paquete que no pudieron construirse, indexadas por nombre de parte; vacío cuando todas las partes están presentes. puede faltar

Generada 2026-11-11 23:00 UTC a partir de 4 respuestas reales.

Respuesta de ejemplo

No se guarda ningún ejemplo porque la última respuesta correcta era demasiado grande para mostrarla. Llame al endpoint en el Playground.

Muestras verificadas

Además del ejemplo anterior, la sonda llama a este endpoint con estos parámetros y comprueba el esquema en cada ocasión.

Parámetros	HTTP	Latencia	Resultado
coin=ETH	200	73 ms	Correcto
coin=SOL	200	59 ms	Correcto
coin=ARKM	200	59 ms	Correcto
—	400	2 ms	Correcto devuelve el error esperado

Comprobado 2026-11-13 03:57:35 UTC

Detalles

Autenticación: Ninguna. Endpoint público.
Límite de solicitudes: 1200 solicitudes por minuto por IP
Caché del servidor: 15s
Microcaché de borde: 10s
Frecuencia de actualización: véanse /api/sd/oi, /api/sd/funding, /api/sd/liquidations, /api/sd/volume, /api/sd/ls (consulta cada 60 s a 5 min; liquidaciones en tiempo real; spot cada 10 min)
Ventana: última instantánea por bloque, más las ventanas móviles propias de cada bloque
Fuentes de datos: Bloques combinados de interés abierto, financiación, liquidaciones, volumen y largos/cortos de una moneda, todos construidos a partir de los recolectores propios de CoinBoss, que consultan las API públicas de unas 30 plataformas (p. ej. binance, okx, bybit, bitget, gate, hyperliquid).
Cobertura de exchanges: igual que los cinco endpoints de bloque único; la lista de contratos se trunca a 60 filas
Unidades: USD notional for OI / volume / liquidations; funding as fraction; long/short in percent
Método: same builders as the five single-block endpoints
Marcas de tiempo: Milisegundos de época Unix (UTC), salvo que la descripción del campo indique otra cosa
Formato de respuesta: json
Estabilidad: Estable
Disponible desde: 2026-11-11

Estado en vivo

DisponibleComprobado 2026-11-13 03:57:35 UTCHTTP 200875 msEl esquema coincideAntigüedad del dato más reciente: 0s

Disponibilidad, últimos 30 días

100% de 411 comprobaciones superadas

Desviación del esquema detectada por la última sonda

Devuelto pero no documentado: oi.coverage.stale_excluded[], oi.coverage.stale_excluded[].exchange, oi.coverage.stale_excluded[].symbol, oi.coverage.stale_excluded[].oi_usd, oi.coverage.stale_excluded[].age_s, oi.coverage.stale_excluded[].reason, ls.taker.by_exchange[], ls.taker.by_exchange[].exchange, ls.taker.by_exchange[].symbol, ls.taker.by_exchange[].long_pct

Errores

Las llamadas fallidas tienen la misma estructura en todos los endpoints. La lista completa está en la página de errores. Errores y límites de solicitudes →

Código	HTTP	Significado	Qué hacer
INVALID_PARAM	400	Falta un parámetro obligatorio o un valor no se acepta. `param` indica el nombre del parámetro cuando se conoce.	No reintente sin cambios; corrija la solicitud.
UNAUTHORIZED	401	Se envió la cabecera `CB-API-KEY`, pero la clave es desconocida o está revocada. Los datos públicos no necesitan clave: elimine la cabecera o use una clave válida.	No reintente sin cambios.
FORBIDDEN	403	La ruta no forma parte de la API pública (interna o solo para cuentas).	No reintente.
NOT_FOUND	404	Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe.	No reintente; compruebe la ruta y los identificadores en el catálogo.
RATE_LIMITED	429	Más solicitudes que el límite por minuto. `Retry-After` indica los segundos de espera.	Espere el tiempo de `Retry-After` y después reintente con espera progresiva.
INTERNAL	500	Error inesperado del servidor. El mensaje es genérico por diseño; cite `request_id` al informar del error.	Reintente una vez tras unos segundos; si persiste, infórmelo con el ID de solicitud.
UPSTREAM_FAILED	503	La fuente de datos de este endpoint no respondió a tiempo. No se devuelven cifras desactualizadas ni sustitutas en su lugar.	Reintente con espera progresiva; consulte la página de estado.
UNAVAILABLE	501 / 503	El conjunto de datos no está listo temporalmente (calentamiento de la caché) o el endpoint aún no tiene una fuente pública lícita.	Reintente más tarde; el catálogo marca los endpoints que no están disponibles por diseño.
REQUEST_FAILED	200	Algunos endpoints antiguos responden HTTP 200 con `success: false`. Compruebe siempre `success`, no solo el estado HTTP.	Depende del mensaje; trátelo como una solicitud fallida.

Pruébelo

GET/api/sd/coinDisponible

Parámetros

coin Obligatorio

string — Coin symbol; 400 when missing. Alias: `base`.

URL de la solicitudhttps://www.coinboss.com/api/sd/coin?coin=BTC

Elija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.

Paquete único por moneda (OI, financiación, liquidaciones, volumen, largos/cortos) /api/sd/coin
Volumen de futuros de una moneda /api/sd/volume
Screener de monedas de derivados /api/derivatives/coins
Tabla completa de monedas de derivados /api/derivatives/coins-full
Velas de derivados de una moneda /api/derivatives/kline
Lista de RSI por moneda /api/derivatives/rsi
Serie MACD de una moneda /api/indicators/ta/macd/:coin
Series históricas de una moneda /api/market/history
Tickers de derivados agregados por moneda /api/market/tickers
Ranking de volumen de derivados /api/market/volume-rank