Dettaglio di un singolo ETF
Dettaglio di un singolo ETF (profilo e storico dei flussi)
/api/etf/fund/:tickerRichiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| ticker path | string | Obbligatorio | — | — | Ticker del fondo (solo lettere, convertito in maiuscolo); 404 se sconosciuto. Esempio: IBIT |
I parametri contrassegnati con «path» fanno parte dell'URL.
Richiesta di esempio
curl -s "https://www.coinboss.com/api/etf/fund/IBIT"Campi della risposta
La tabella dei campi è generata da risposte reali, quindi elenca esattamente ciò che l'endpoint restituisce. I percorsi usano a[] per gli elementi di un array e {*} per gli oggetti indicizzati da un nome dinamico, come una moneta o un exchange.
| Campo | Tipo | Unità | Descrizione |
|---|---|---|---|
| success | boolean | — | true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`. |
| ticker | string | — | Ticker del fondo. |
| asset | string | — | Simbolo dell'asset. |
| issuer | string | — | Emittente del fondo. |
| price | object | — | Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione). |
| price.currency | string | — | Simbolo della valuta / dell'asset. |
| price.latest | object | — | Record più recente. |
| price.latest.date | string | — | Data di calendario (UTC). |
| price.latest.close | number | — | Prezzo di chiusura del periodo. |
| price.latest.open | number | — | Prezzo di apertura del periodo. |
| price.latest.high | number | — | Massimo del periodo. |
| price.latest.low | number | — | Minimo del periodo. |
| price.latest.volume | number | — | Volume. |
| price.change_abs | number | USD | Ultima chiusura giornaliera della quota del fondo meno la chiusura della giornata di contrattazione precedente. |
| price.change_pct | number | % | Variazione percentuale. |
| price.week52_high | number | USD | Massimo giornaliero più alto della quota del fondo nei 365 giorni di calendario fino all'ultima data di prezzo. |
| price.week52_low | number | USD | Minimo giornaliero più basso della quota del fondo nei 365 giorni di calendario fino all'ultima data di prezzo. |
| price.avg_volume_10d | number | shares | Volume medio giornaliero di scambio del fondo nelle ultime 10 giornate di contrattazione, in quote. |
| price.count | number | — | Numero di elementi. |
| price.data | array | — | Payload. |
| price.data[] | object | — | Payload. |
| price.data[].date | string | — | Data di calendario (UTC). |
| price.data[].open | number | — | Prezzo di apertura del periodo. |
| price.data[].high | number | — | Massimo del periodo. |
| price.data[].low | number | — | Minimo del periodo. |
| price.data[].close | number | — | Prezzo di chiusura del periodo. |
| price.data[].volume | number | — | Volume. |
| fund | object | — | Valori istantanei a livello di fondo; ciascuno è l'ultimo valore noto e possono risalire a giorni diversi (vedere `aum_as_of`). |
| fund.aum_usd_million | number | million USD | Ultimo valore non null del patrimonio in gestione del fondo, valido alla data `aum_as_of`. |
| fund.aum_as_of | string | — | Giornata di contrattazione (YYYY-MM-DD) a cui si riferisce `aum_usd_million`. |
| fund.estimated_holdings | number | coin | Monete detenute dal fondo, stimate: ultimo AUM noto ÷ prezzo spot attuale dell'asset; è una stima, non una consistenza dichiarata dall'emittente. |
| fund.fee_pct | number | % | Commissione di gestione annua del fondo in percentuale (0.25 = 0.25 % all'anno); ultimo valore noto da una fonte di terze parti. |
| fund.mkt_share_pct | number | % | AUM del fondo in percentuale della capitalizzazione di mercato totale della moneta sottostante (non la sua quota tra gli ETF); ultimo valore noto di terze parti. |
| fund.volume_usd_million | number | million USD | Volume di scambio del fondo nell'ultimo giorno in cui una fonte di terze parti lo ha comunicato. |
| fund.cum_inflow_official_million | number | million USD | Afflusso netto cumulato dal lancio come pubblicato da una fonte di terze parti (ultimo valore noto); può differire dalla somma `flows.latest.cum_total`. |
| flows | object | — | Storico giornaliero dei flussi netti del fondo con totale progressivo; gli importi sono in milioni di USD (`unit`). |
| flows.unit | string | — | Unità dei valori di questo oggetto. |
| flows.latest | object | — | Record più recente. |
| flows.latest.date | string | — | Data di calendario (UTC). |
| flows.latest.flow | number | — | Flusso netto di creazione / rimborso del giorno. |
| flows.latest.cum_total | number | — | Totale cumulato. |
| flows.latest.sum_7d | number | — | Somma a 7 giorni. |
| flows.count | number | — | Numero di elementi. |
| flows.data | array | — | Payload. |
| flows.data[] | object | — | Payload. |
| flows.data[].date | string | — | Data di calendario (UTC). |
| flows.data[].flow | number | — | Flusso netto di creazione / rimborso del giorno. |
| flows.data[].cum | number | — | Flusso netto cumulato dalla quotazione. |
| premium | object | — | Premio (+) o sconto (−) del prezzo di mercato rispetto al NAV. |
| premium.unit | string | — | Unità dei valori di questo oggetto. |
| premium.note | string | — | Nota. |
| premium.count | number | — | Numero di elementi. |
| premium.data | array | — | Payload. |
| premium.data[] | object | — | Payload. |
| premium.data[].date | string | — | Data di calendario (UTC). |
| premium.data[].premium | number | — | Premio (+) o sconto (−) del prezzo di mercato rispetto al NAV. |
Generata 2026-11-11 23:00 UTC da 1 risposte reali.
Risposta di esempio
/api/etf/fund/IBIT · Risposta reale acquisita 2026-11-13 03:58:19 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: flows.data conteneva 712 elementi; price.data conteneva 713 elementi; premium.data conteneva 64 elementi.
- "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"
Dettagli
- Autenticazione
- Nessuna. Endpoint pubblico.
- Limite di richieste
- 1200 richieste al minuto per IP
- Cache del server
- 5m
- Micro-cache edge
- 10s
- Frequenza di aggiornamento
- ogni ora (prezzi al minuto 20, flussi al minuto 15); barre giornaliere
- Finestra
- storico giornaliero archiviato di prezzi e flussi; massimo/minimo a 52 settimane e volume medio a 10 giorni
- Fonti dei dati
- Dati della pagina del singolo fondo: prezzi giornalieri del fondo da un sito pubblico di dati di mercato, flussi da un tracker pubblico dei flussi degli ETF.
- Copertura degli exchange
- 36 ticker di ETF spot statunitensi tracciati (404 per i ticker sconosciuti).
- Ordinamento
- data crescente
- Unità
- USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
- Metodo
- estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
- Timestamp
- Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
- Formato della risposta
- json
- Stabilità
- Stabile
Stato in tempo reale
Disponibilità, ultimi 30 giorni
100% di 410 verifiche superate
Errori
Le chiamate non riuscite hanno la stessa struttura su tutti gli endpoint. L'elenco completo è nella pagina degli errori. Errori e limiti di richieste →
| Codice | HTTP | Significato | Che cosa fare |
|---|---|---|---|
| INVALID_PARAM | 400 | Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto. | Non riprovare senza modifiche; correggere la richiesta. |
| UNAUTHORIZED | 401 | L'header `CB-API-KEY` è stato inviato ma la chiave è sconosciuta o revocata. I dati pubblici non richiedono alcuna chiave: rimuovere l'header o usare una chiave valida. | Non riprovare senza modifiche. |
| FORBIDDEN | 403 | La route non fa parte dell'API pubblica (interna o riservata agli account). | Non riprovare. |
| NOT_FOUND | 404 | Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste. | Non riprovare; verificare il percorso e gli identificatori nel catalogo. |
| RATE_LIMITED | 429 | Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere. | Attendere `Retry-After`, poi riprovare con backoff. |
| INTERNAL | 500 | Errore imprevisto del server. Il messaggio è volutamente generico; citare `request_id` quando lo si segnala. | Riprovare una volta dopo qualche secondo; se persiste, segnalarlo con l'ID della richiesta. |
| UPSTREAM_FAILED | 503 | La fonte di dati alla base di questo endpoint non ha risposto in tempo. Al suo posto non vengono restituiti numeri obsoleti o sostitutivi. | Riprovare con backoff; controllare la pagina di stato. |
| UNAVAILABLE | 501 / 503 | Il dataset è temporaneamente non pronto (riscaldamento della cache) oppure l'endpoint non ha ancora una fonte pubblica lecita. | Riprovare più tardi; il catalogo contrassegna gli endpoint non disponibili per scelta progettuale. |
| REQUEST_FAILED | 200 | Alcuni endpoint meno recenti rispondono HTTP 200 con `success: false`. Controllare sempre `success`, non solo lo stato HTTP. | Dipende dal messaggio; trattare come una richiesta non riuscita. |
Prova
/api/etf/fund/:tickerDisponibilestring — Fund ticker (letters only, upper-cased); 404 if unknown.
https://www.coinboss.com/api/etf/fund/IBITAltro in questa categoria
- Fondi ETF spot /api/sd/etf/funds
- Storico degli ETF spot /api/sd/etf/history
- Panoramica degli ETF spot (comunicazioni degli emittenti) /api/sd/etf/overview
- Flussi netti giornalieri degli ETF spot per fondo /api/etf/detail
- Storico dei flussi netti giornalieri degli ETF spot /api/etf/flows
- Dettaglio di un singolo ETF /api/etf/fund/:ticker
- Elenco dei fondi ETF /api/etf/funds
- Monete detenute dagli ETF per fondo /api/etf/holdings
- Prodotti ETF / trust di un emittente /api/etf/issuer
- Panoramica degli ETF /api/etf/overview
- Premio / sconto dei trust Grayscale /api/grayscale/premium
- Volumi degli ETF basati su futures /api/indicators/futures-etf-volumes