Volumen 24h—Interés abierto—Liquidaciones 24h$1.36BLargo/Corto 24h—Dominancia BTC—Dominancia ETH—
App
Idioma ▾
€ EUR ▾
/api/exchanges/detail
GETDisponible

Resumen de derivados de un exchange

Resumen de derivados de un exchange (OI, volumen, número de monedas, ...)

GET/api/exchanges/detail

Solicitud

Parámetros de consulta

NombreTipoObligatorioValor por defectoValores admitidosDescripción
exstringObligatorio——Id del exchange (se convierte a minúsculas, solo a-z0-9.); 400 cuando falta. Ejemplo: binance

Solicitud de ejemplo

curl -s "https://www.coinboss.com/api/exchanges/detail?ex=binance"

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.

CampoTipoUnidadDescripción
successboolean—true cuando la solicitud se completó correctamente. En caso de fallo, el cuerpo es `{ success: false, code, error, request_id }`.
dataobject—Carga útil.
data.exchangestring—Id del exchange, en minúsculas (por ejemplo `binance`).
data.namestring—Nombre.
data.volume_usdnumberUSDVolumen en nocional USD.
data.oi_usdnumberUSDInterés abierto en nocional USD.
data.liq_24h_longnumber—Largos liquidados en 24h.
data.liq_24h_shortnumber—Cortos liquidados en 24h.
data.liq_24h_totalnumber—Total de liquidaciones en 24h.
data.liq_24h_cntnumbercountNúmero de órdenes de liquidación registradas en el exchange en las últimas 24 horas; null cuando el exchange no tiene feed de liquidaciones.
data.liq_sourceboolean—True cuando existen registros de liquidaciones de este exchange en los últimos 7 días; cuando es false, los campos `liq_24h_*` son null, no cero.
data.contractsnumber—Filas por contrato.
data.options_vol_usdnullUSDReservado para el volumen de opciones del exchange; por ahora no se rellena, por lo que el valor es siempre null.
data.taker_feenumber%Comisión taker del nivel base para perpetuos USDT según la tabla pública de comisiones del exchange (0.05 = 0.05 %); valor de referencia estático, null cuando se desconoce.
data.maker_feenumber%Comisión maker del nivel base para perpetuos USDT según la tabla pública de comisiones del exchange (0.02 = 0.02 %); valor de referencia estático, null cuando se desconoce.
data.is_dexboolean—True para los exchanges descentralizados de perpetuos (por ejemplo Hyperliquid, dYdX, Aster) y false para los centralizados.
data.scorenumber—Puntuación.
data.has_lsboolean—True cuando hay datos del ratio largos/cortos disponibles para este exchange.
data.total_assets_usdnumber|nullUSDActivos totales en las billeteras divulgadas del exchange (el mismo valor que `reserve.tvl_usd`), según una fuente externa; null cuando no hay cobertura.
data.reserveobject|null—Instantánea de reservas de las billeteras divulgadas del exchange procedente de una fuente externa, actualizada cada 6 horas aproximadamente; null cuando el exchange no está cubierto.
data.reserve.tvl_usdnumberUSDValor total bloqueado.
data.reserve.clean_tvl_usdnumberUSDActivos en billeteras sin contar el token de plataforma del propio exchange, según la definición de la fuente externa; null cuando no se publica.
data.reserve.inflow_24hnumberUSDEntrada neta en las billeteras del exchange en las últimas 24 horas (negativo = salida neta), según informa la fuente externa.
data.reserve.inflow_1wnumberUSDEntrada neta en las billeteras del exchange en los últimos 7 días (negativo = salida neta), según informa la fuente externa.
data.reserve.inflow_1mnumberUSDEntrada neta en las billeteras del exchange en el último mes (negativo = salida neta), según informa la fuente externa.
data.reserve.wallets_linkstring—URL de la divulgación de billeteras o de la prueba de reservas del propio exchange; null cuando no se conoce ninguna.
data.reserve.updated_atnumbermsMomento de la última actualización de esta fila.
data.dist_oiarray—Las 20 primeras monedas por interés abierto en este exchange, de mayor a menor; se excluyen los contratos que no se han actualizado recientemente.
data.dist_oi[]object—Una moneda: `coin` es el activo base y `v` su interés abierto en este exchange en USD.
data.dist_oi[].coinstring—Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
data.dist_oi[].vnumber—Valor.
data.dist_volarray—Las 20 primeras monedas por volumen de futuros de 24 horas en este exchange, de mayor a menor; se excluyen los tickers que no se han actualizado en la última hora.
data.dist_vol[]object—Una moneda: `coin` es el activo base y `v` su volumen de 24 horas en este exchange en USD.
data.dist_vol[].coinstring—Símbolo de la moneda, en mayúsculas (por ejemplo BTC).
data.dist_vol[].vnumber—Valor.

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

Respuesta de ejemplo

/api/exchanges/detail?ex=binance · Respuesta real capturada 2026-11-13 03:52:50 UTC. Los arrays y mapas largos se abrevian para su visualización: data.dist_oi tenía 20 elementos; data.dist_vol tenía 20 elementos.

  • {
    • "success": true,
    • "data": {
      • "exchange": "binance",
      • "name": "Binance",
      • "volume_usd": 65939302653.96,
      • "oi_usd": 24379577678.85,
      • "liq_24h_long": 417516080.56,
      • "liq_24h_short": 15925112.83,
      • "liq_24h_total": 433441193.39,
      • "liq_24h_cnt": 45872,
      • "liq_source": true,
      • "contracts": 762,
      • "options_vol_usd": null,
      • "taker_fee": 0.05,
      • "maker_fee": 0.02,
      • "is_dex": false,
      • "score": 96,
      • "has_ls": true,
      • "total_assets_usd": 121135381605.44,
      • "reserve": { … 7 },
      • "dist_oi": [ … 2 ],
      • "dist_vol": [ … 2 ]
      }
    }

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ámetrosHTTPLatenciaResultado
ex=okx200164 msCorrecto
ex=hyperliquid200179 msCorrecto
—4001 msCorrecto devuelve el error esperado

Comprobado 2026-11-13 03:28:10 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
tickers cada 1 min; OI cada 5 min; reservas cada 6 h; caché en memoria 30 s
Ventana
volumen y liquidaciones de 24h móviles
Fuentes de datos
Perfil por exchange agregado a partir de la API pública del exchange (volumen, OI, contratos), de los flujos de liquidaciones y de los datos de reservas de CEX de la fuente externa.
Cobertura de exchanges
Cualquier plataforma de derivados recopilada; reservas solo para las 10 plataformas con seguimiento en una fuente externa
Paginación
ninguno
Unidades
USD; score 1-99
Método
score = clamp(1..99, round(log10(vol + 10) / 11.2 * 70 + log10(oi + 10) / 11 * 30))
Marcas de tiempo
Milisegundos de época Unix (UTC), salvo que la descripción del campo indique otra cosa
Formato de respuesta
json
Estabilidad
Estable

Estado en vivo

DisponibleComprobado 2026-11-13 03:52:50 UTCHTTP 200177 msEl esquema coincideAntigüedad del dato más reciente: 4.7h

Disponibilidad, últimos 30 días

100% de 409 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ódigoHTTPSignificadoQué hacer
INVALID_PARAM400Falta 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.
UNAUTHORIZED401Se 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.
FORBIDDEN403La ruta no forma parte de la API pública (interna o solo para cuentas).No reintente.
NOT_FOUND404Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe.No reintente; compruebe la ruta y los identificadores en el catálogo.
RATE_LIMITED429Má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.
INTERNAL500Error 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_FAILED503La 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.
UNAVAILABLE501 / 503El 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_FAILED200Algunos 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/exchanges/detailDisponible
Parámetros

string — Exchange id (lower-cased, a-z0-9. only); 400 when missing.

URL de la solicitudhttps://www.coinboss.com/api/exchanges/detail?ex=binance
Elija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.