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

App

Idioma ▾

€ EUR ▾

/api/sd/liquidity/rank

GETParcialPARTIAL

Monedas ordenadas por profundidad del libro de órdenes

Monedas ordenadas por la profundidad agregada del libro de órdenes (compra + venta) dentro de una banda, con el número de contratos incluidos y el spread más estrecho.

GET/api/sd/liquidity/rank

Solicitud

Parámetros de consulta

Nombre	Tipo	Obligatorio	Valor por defecto	Valores admitidos	Descripción
market	string	Opcional	perp	perp, spot	Tipo de mercado. Los libros de perpetuos y de spot nunca se suman entre sí.
band	string	Opcional	1	0.5, 1, 2	Distancia desde el precio medio en porcentaje.
limit	integer	Opcional	50	≥ 1 · ≤ 200	Número de filas.

Solicitud de ejemplo

curl -s "https://www.coinboss.com/api/sd/liquidity/rank"

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 }`.
schema	string	—	Id de esquema de esta respuesta. Solo cambia cuando un campo existente cambia de significado o de tipo.
now	number	ms	Hora del servidor en el momento de generar la respuesta.
market	string	—	`perp` o `spot`.
band_pct	number	%	Banda seleccionada: distancia desde el precio medio.
limit	number	—	Límite de filas aplicado.
total_coins	number	—	Monedas que tienen al menos una fila de libro de órdenes.
rows	array	—	Una fila por moneda.
rows[]	object	—	Una fila por moneda.
rows[].coin	string	—	Símbolo de la moneda (en mayúsculas).
rows[].bid_depth_usd	number	USD	Nocional de compra pendiente entre el precio medio y el borde inferior de la banda. Es un límite inferior cuando `complete` es false.
rows[].ask_depth_usd	number	USD	Nocional de venta pendiente entre el precio medio y el borde superior de la banda. Es un límite inferior cuando `complete` es false.
rows[].total_depth_usd	number	USD	Profundidad de compra + profundidad de venta de la banda, usada solo como clave de ordenación del ranking.
rows[].n_included	number	—	Filas incluidas en la suma de profundidad: frescas y completas para la banda. Léalo junto con el valor de profundidad.
rows[].n_fresh	number	—	Filas frescas.
rows[].n_rows	number	—	Filas encontradas, incluidas las desactualizadas.
rows[].mid_median	number	USD	Mediana del precio medio de las filas frescas.
rows[].spread_bps_min	number	bp	Spread más estrecho entre las filas frescas.
rows[].included_exchanges	array	—	Fuentes cuyos datos frescos se incluyen.
rows[].included_exchanges[]	string	—	Fuentes cuyos datos frescos se incluyen.
rows[].uses_aggregated_buckets	boolean	—	True cuando una fila incluida usó tramos agregados por precio, lo que convierte la suma en un límite inferior.
rows[].rank	number	—	Posición en el ranking; `null` cuando la fila no tiene ningún valor que clasificar.
coverage	object	—	Qué se incluye y qué no en las cifras. Conviene revisarlo antes de comparar totales con otra fuente.
coverage.included_exchanges	array	—	Fuentes cuyos datos frescos se incluyen.
coverage.included_exchanges[]	string	—	Fuentes cuyos datos frescos se incluyen.
coverage.unavailable	array	—	Fuentes que no pudieron incluirse, cada una con su motivo. Nunca se cuentan como 0. vacío en las muestras usadas para generar esta tabla
coverage.stale_excluded	array	—	Filas excluidas porque su última actualización está fuera de la ventana de frescura.
coverage.stale_excluded[]	object	—	Filas excluidas porque su última actualización está fuera de la ventana de frescura.
coverage.stale_excluded[].exchange	string	—	Id del exchange (en minúsculas).
coverage.stale_excluded[].age_s	number	s	Segundos transcurridos desde que se recibió la fila.
coverage.n_fresh_rows	number	—	Filas frescas de todas las monedas.
coverage.n_stale_rows	number	—	Filas desactualizadas de todas las monedas.
coverage.n_incomplete_rows	number	—	Filas frescas cuya instantánea no alcanza el borde de la banda.
method	object	—	Enunciado en texto plano de las fórmulas utilizadas en esta respuesta, con una entrada por campo.
method.bid_depth_usd	string	—	Nota de fórmula de `bid_depth_usd`, en texto plano.
method.ask_depth_usd	string	—	Nota de fórmula de `ask_depth_usd`, en texto plano.
method.complete	string	—	Nota de fórmula de `complete`, en texto plano.
method.aggregate	string	—	Nota de fórmula de `aggregate`, en texto plano.
method.fresh	string	—	Nota de fórmula de `fresh`, en texto plano.
method.rank	string	—	Nota de fórmula de `rank`, en texto plano.
meta	object	—	Linaje y frescura de esta respuesta.
meta.schema	string	—	Id de esquema de esta respuesta. Solo cambia cuando un campo existente cambia de significado o de tipo.
meta.source	array	—	Endpoints públicos de origen de los que se recopilaron los datos.
meta.source[]	object	—	Endpoints públicos de origen de los que se recopilaron los datos.
meta.source[].exchange	string	—	Id del exchange (en minúsculas).
meta.source[].market	string	—	`perp` o `spot`.
meta.source[].endpoint	string	—	Endpoint público de la fuente que lee el recolector (se muestra por linaje; los clientes nunca lo llaman).
meta.observed_at	number	ms	Marca de tiempo que la fuente asigna a los datos.
meta.received_at	number	ms	Hora en que el recolector de CoinBoss recibió los datos.
meta.fetched_at	number	ms	Hora en que se compuso esta respuesta.
meta.window	string	—	Ventana temporal que cubren las cifras.
meta.quality	string	—	FRESH, PARTIAL, STALE, BROKEN o UNAVAILABLE, según las marcas de tiempo de los datos y la cobertura.
meta.is_stale	boolean	—	True cuando los datos son más antiguos que su ventana de frescura.
meta.cache_ttl_s	number	s	Tiempo de vida en caché de esta respuesta.
meta.fallback	string	—	Qué devuelve el endpoint cuando falla el recolector o una fuente.
meta.collector_heartbeat_age_s	number	s	Segundos transcurridos desde que el recolector informó por última vez de que está en ejecución.

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

Respuesta de ejemplo

/api/sd/liquidity/rank · Respuesta real capturada 2026-11-13 04:02:46 UTC. Los arrays y mapas largos se abrevian para su visualización: rows tenía 50 elementos; meta.source tenía 23 elementos; coverage.stale_excluded tenía 23 elementos; rows[].included_exchanges tenía 19 elementos; coverage.included_exchanges tenía 23 elementos.

{
- "success": true,
- "schema": "coinboss.sd.liquidity/1",
- "now": 1794542566023,
- "market": "perp",
- "band_pct": 1,
- "limit": 50,
- "total_coins": 89,
- "rows": [
  - { … 12 },
  - { … 12 }
  ],
- "coverage": {
  - "included_exchanges": [ … 8 ],
  - "unavailable": [],
  - "stale_excluded": [ … 2 ],
  - "n_fresh_rows": 1481,
  - "n_stale_rows": 82,
  - "n_incomplete_rows": 8
  },
- "method": {
  - "bid_depth_usd": "sum of resting bid notional with price >= mid * (1 - band%), in USD; notional = price * size * contract_value (inverse contracts: size * contract_value); USDT /…",
  - "ask_depth_usd": "sum of resting ask notional with price <= mid * (1 + band%), in USD; same notional rule as bid_depth_usd",
  - "complete": "true when BOTH sides of the snapshot reach the band edge (reach_pct >= band) or the whole side of the book was returned; when false the depth values are lower b…",
  - "aggregate": "per market and band: sum over rows that are fresh AND complete for that band; n_included / n_fresh is the denominator; lower_bound_* additionally adds the incom…",
  - "fresh": "a row is fresh when now - received_at <= max(3 * period_s, 300s); stale rows are listed in coverage.stale_excluded; rows older than 24h are dropped",
  - "rank": "coins ordered by bid_depth_usd + ask_depth_usd of the chosen market and band, aggregated as in aggregate; coins with no fresh complete row carry nulls and sort …"
  },
- "meta": {
  - "schema": "coinboss.sd.liquidity/1",
  - "source": [ … 2 ],
  - "observed_at": 1794542565862,
  - "received_at": 1794542565977,
  - "fetched_at": 1794542566023,
  - "window": "latest",
  - "quality": "PARTIAL",
  - "is_stale": false,
  - "cache_ttl_s": 30,
  - "fallback": "stale rows (older than max(3 * period_s, 300s)) are left out; coins whose rows are all stale or incomplete keep their place in the list with null depth",
  - "collector_heartbeat_age_s": 4
  }
}

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
market=spot	200	5 ms	Correcto PARTIAL
band=0.5&limit=10	200	7 ms	Correcto PARTIAL
limit=0	400	2 ms	Correcto devuelve el error esperado

Comprobado 2026-11-13 03:58:06 UTC

Detalles

Autenticación: Ninguna. Endpoint público.
Límite de solicitudes: 1200 solicitudes por minuto por IP
Caché del servidor: 30s
Microcaché de borde: 10s
Frecuencia de actualización: El mismo ciclo de recopilación que `/api/sd/liquidity`.
Ventana: Última instantánea por contrato.
Fuentes de datos: Instantáneas públicas por REST del libro de órdenes de 24 exchanges (mercados de perpetuos y spot), recopiladas y almacenadas por CoinBoss (sd_book_latest, sd_book_hist). CoinBoss calcula la profundidad y el deslizamiento a partir de los niveles de precio en bruto.
Cobertura de exchanges: 24 exchanges, 38 combinaciones exchange × mercado. Cuando una instantánea pública no alcanza el ±0.5 / 1 / 2 % desde el precio medio (por el tope de niveles de la plataforma), esa banda se marca con `complete: false`, su valor es un límite inferior y queda fuera del agregado; `n_included` / `n_fresh` dan el denominador y `excluded_incomplete` lista lo que se excluyó.
Paginación: Sin paginación; `limit` limita el número de filas (máx. 200).
Ordenación: `total_depth_usd` descendente; las monedas sin ninguna fila completa y fresca van al final con `rank: null`.
Unidades: Depth in USD notional, bid and ask side reported separately and never added. Spread and slippage in basis points (1 bp = 0.01 %). USDT / USDC / USD quotes are counted 1:1 as USD.
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

ParcialComprobado 2026-11-13 04:02:46 UTCHTTP 2009 msEl esquema coincideAntigüedad del dato más reciente: 0s

El endpoint informa de una calidad de datos PARTIAL

Disponibilidad, últimos 30 días

100% de 408 comprobaciones superadas

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/liquidity/rankParcial

Parámetros

market

string · por defecto perp — Market type. Perpetual and spot books are never added together.

band

string · por defecto 1 — Distance from mid price in percent.

limit

integer · por defecto 50 · mín. 1 · máx. 200 — Number of rows.

URL de la solicitudhttps://www.coinboss.com/api/sd/liquidity/rank

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

Profundidad del libro de órdenes y deslizamiento /api/sd/liquidity
Historial de profundidad del libro de órdenes /api/sd/liquidity/history
Monedas ordenadas por profundidad del libro de órdenes /api/sd/liquidity/rank
Monitor de grandes órdenes pendientes /api/indicators/large-orderbook