Detalle de un ETF
Detalle de un ETF (perfil e historial de flujos)
/api/etf/fund/:tickerSolicitud
Parámetros de consulta
| Nombre | Tipo | Obligatorio | Valor por defecto | Valores admitidos | Descripción |
|---|---|---|---|---|---|
| ticker path | string | Obligatorio | — | — | Ticker del fondo (solo letras, se convierte a mayúsculas); 404 si es desconocido. Ejemplo: IBIT |
Los parámetros marcados como «path» forman parte de la URL.
Solicitud de ejemplo
curl -s "https://www.coinboss.com/api/etf/fund/IBIT"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 }`. |
| ticker | string | — | Ticker del fondo. |
| asset | string | — | Símbolo del activo. |
| issuer | string | — | Emisor del fondo. |
| price | object | — | Último precio en la moneda de cotización (USD o USDT salvo que se indique otra cosa). |
| price.currency | string | — | Símbolo de la divisa / del activo. |
| price.latest | object | — | Registro más reciente. |
| price.latest.date | string | — | Fecha de calendario (UTC). |
| price.latest.close | number | — | Precio de cierre del periodo. |
| price.latest.open | number | — | Precio de apertura del periodo. |
| price.latest.high | number | — | Máximo del periodo. |
| price.latest.low | number | — | Mínimo del periodo. |
| price.latest.volume | number | — | Volumen. |
| price.change_abs | number | USD | Último cierre diario de la participación del fondo menos el cierre del día de negociación anterior. |
| price.change_pct | number | % | Variación porcentual. |
| price.week52_high | number | USD | Máximo diario más alto de la participación del fondo en los 365 días naturales hasta la última fecha de precio. |
| price.week52_low | number | USD | Mínimo diario más bajo de la participación del fondo en los 365 días naturales hasta la última fecha de precio. |
| price.avg_volume_10d | number | shares | Volumen medio diario de negociación del fondo en los últimos 10 días de negociación, en participaciones. |
| price.count | number | — | Número de elementos. |
| price.data | array | — | Carga útil. |
| price.data[] | object | — | Carga útil. |
| price.data[].date | string | — | Fecha de calendario (UTC). |
| price.data[].open | number | — | Precio de apertura del periodo. |
| price.data[].high | number | — | Máximo del periodo. |
| price.data[].low | number | — | Mínimo del periodo. |
| price.data[].close | number | — | Precio de cierre del periodo. |
| price.data[].volume | number | — | Volumen. |
| fund | object | — | Valores de instantánea a nivel de fondo; cada uno es el último valor conocido y pueden corresponder a días distintos (véase `aum_as_of`). |
| fund.aum_usd_million | number | million USD | Activos bajo gestión no nulos más recientes del fondo, válidos a fecha de `aum_as_of`. |
| fund.aum_as_of | string | — | Día de negociación (YYYY-MM-DD) al que se refiere `aum_usd_million`. |
| fund.estimated_holdings | number | coin | Monedas estimadas en poder del fondo: último AUM conocido ÷ precio spot actual del activo; es una estimación, no una tenencia informada por el emisor. |
| fund.fee_pct | number | % | Comisión de gestión anual del fondo en porcentaje (0.25 = 0.25 % anual); último valor conocido de una fuente externa. |
| fund.mkt_share_pct | number | % | AUM del fondo como porcentaje de la capitalización de mercado total de la moneda subyacente (no su cuota entre los ETF); último valor externo conocido. |
| fund.volume_usd_million | number | million USD | Volumen de negociación del fondo en el último día en que lo informó una fuente externa. |
| fund.cum_inflow_official_million | number | million USD | Entrada neta acumulada desde el lanzamiento según la publica una fuente externa (último valor conocido); puede diferir de la suma `flows.latest.cum_total`. |
| flows | object | — | Historial diario de flujos netos del fondo con total acumulado; los importes están en millones de USD (`unit`). |
| flows.unit | string | — | Unidad de los valores de este objeto. |
| flows.latest | object | — | Registro más reciente. |
| flows.latest.date | string | — | Fecha de calendario (UTC). |
| flows.latest.flow | number | — | Flujo neto de creación / reembolso del día. |
| flows.latest.cum_total | number | — | Total acumulado. |
| flows.latest.sum_7d | number | — | Suma de 7 días. |
| flows.count | number | — | Número de elementos. |
| flows.data | array | — | Carga útil. |
| flows.data[] | object | — | Carga útil. |
| flows.data[].date | string | — | Fecha de calendario (UTC). |
| flows.data[].flow | number | — | Flujo neto de creación / reembolso del día. |
| flows.data[].cum | number | — | Flujo neto acumulado desde el inicio de cotización. |
| premium | object | — | Prima (+) o descuento (−) del precio de mercado respecto al NAV. |
| premium.unit | string | — | Unidad de los valores de este objeto. |
| premium.note | string | — | Nota. |
| premium.count | number | — | Número de elementos. |
| premium.data | array | — | Carga útil. |
| premium.data[] | object | — | Carga útil. |
| premium.data[].date | string | — | Fecha de calendario (UTC). |
| premium.data[].premium | number | — | Prima (+) o descuento (−) del precio de mercado respecto al NAV. |
Generada 2026-11-11 23:00 UTC a partir de 1 respuestas reales.
Respuesta de ejemplo
/api/etf/fund/IBIT · Respuesta real capturada 2026-11-13 04:02:51 UTC. Los arrays y mapas largos se abrevian para su visualización: flows.data tenía 712 elementos; price.data tenía 713 elementos; premium.data tenía 64 elementos.
- "success"true
- "ticker""IBIT"
- "asset""BTC"
- "issuer""BlackRock"
- "price"
- "currency""USD"
- "latest"
- "change_abs"-1.88
- "change_pct"-4.4508
- "week52_high"59.56
- "week52_low"32.84
- "avg_volume_10d"52099530
- "count"713
- "data"
- "fund"
- "aum_usd_million"62297.756
- "aum_as_of""2026-11-11"
- "estimated_holdings"905689.4173
- "fee_pct"0.25
- "mkt_share_pct"3.995
- "volume_usd_million"2604.817
- "cum_inflow_official_million"65711.051
- "flows"
- "unit""million_usd"
- "latest"
- "count"712
- "data"
- "premium"
- "unit""pct"
- "note""sparse_snapshot"
- "count"64
- "data"
Detalles
- Autenticación
- Ninguna. Endpoint público.
- Límite de solicitudes
- 1200 solicitudes por minuto por IP
- Caché del servidor
- 5m
- Microcaché de borde
- 10s
- Frecuencia de actualización
- cada hora (precios en el minuto 20, flujos en el minuto 15); barras diarias
- Ventana
- historial diario almacenado de precios y flujos; máximo/mínimo de 52 semanas y volumen medio de 10 días
- Fuentes de datos
- Datos de la página de un solo fondo: precios diarios del fondo de un sitio público de datos de mercado, flujos de un rastreador público de flujos de ETF.
- Cobertura de exchanges
- 36 tickers de ETF spot de EE. UU. con seguimiento (404 para tickers desconocidos).
- Ordenación
- fecha ascendente
- Unidades
- USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
- Método
- estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
- 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
Disponibilidad, últimos 30 días
100% de 411 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
/api/etf/fund/:tickerDisponiblestring — Fund ticker (letters only, upper-cased); 404 if unknown.
https://www.coinboss.com/api/etf/fund/IBITMás en esta categoría
- Fondos ETF spot /api/sd/etf/funds
- Historial de ETF spot /api/sd/etf/history
- Resumen de ETF spot (información de los emisores) /api/sd/etf/overview
- Flujos netos diarios de ETF spot por fondo /api/etf/detail
- Historial de flujos netos diarios de ETF spot /api/etf/flows
- Detalle de un ETF /api/etf/fund/:ticker
- Lista de fondos ETF /api/etf/funds
- Tenencias de monedas de los ETF por fondo /api/etf/holdings
- Productos ETF / fideicomiso de un emisor /api/etf/issuer
- Resumen de ETF /api/etf/overview
- Prima / descuento de los fideicomisos de Grayscale /api/grayscale/premium
- Volúmenes de los ETF basados en futuros /api/indicators/futures-etf-volumes