Elenco dei fondi ETF
Elenco dei fondi ETF (ticker, emittente, AUM, commissione, ...)
/api/etf/fundsRichiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| asset | string | Facoltativo | BTC | BTC, ETH, SOL, HYPE | Asset sottostante. Qualsiasi altro valore restituisce 400 `INVALID_PARAM`. Esempio: BTC |
Richiesta di esempio
curl -s "https://www.coinboss.com/api/etf/funds?asset=BTC"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 }`. |
| asset | string | — | Simbolo dell'asset. |
| unit | string | — | Unità dei valori di questo oggetto. |
| count | number | — | Numero di elementi. |
| funds | array | — | Tutti i fondi ETF spot dell'asset, ordinati per `latest_aum` decrescente. |
| funds[] | object | — | Un fondo con il suo ultimo flusso, l'AUM e gli attributi istantanei. |
| funds[].ticker | string | — | Ticker del fondo. |
| funds[].issuer | string | — | Emittente del fondo. |
| funds[].latest_date | string | — | Giornata di contrattazione più recente (YYYY-MM-DD) con dati di flusso per il fondo; null quando il fondo non ha righe. |
| funds[].latest_flow | number | million USD | Flusso netto del fondo in `latest_date`; negativo = deflusso netto. |
| funds[].sum_7d | number | — | Somma a 7 giorni. |
| funds[].cum_total | number | — | Totale cumulato. |
| funds[].latest_aum | number | million USD | Patrimonio in gestione del fondo in `latest_date`; null quando non è disponibile per quel giorno. |
| funds[].latest_premium_pct | number|null | % | Premio (+) o sconto (−) del prezzo di mercato del fondo rispetto al suo valore patrimoniale netto in `latest_date`; null quando non è disponibile per quel giorno. |
| funds[].source | string | — | Provenienza del valore. |
| funds[].fee_pct | number | % | Commissione di gestione annua del fondo in percentuale (0.25 = 0.25 % all'anno); ultimo valore noto, vedere `frozen_fields` per la relativa data. |
| funds[].volume_usd | number | USD | Volume in nozionale USD. |
| funds[].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, vedere `frozen_fields`. |
| funds[].cum_inflow_official | number | million USD | Afflusso netto cumulato dal lancio come pubblicato da una fonte di terze parti; ultimo valore noto, vedere `frozen_fields` per la relativa data. |
| funds[].etf_share_pct | number | % | `latest_aum` del fondo in percentuale della somma dei `latest_aum` di tutti i fondi dello stesso asset. |
| frozen_fields | object | — | Campi la cui fonte ha smesso di aggiornarsi; riportano l'ultimo valore noto e non vanno letti come attuali. `null` quando nulla è congelato. |
| frozen_fields.fields | array | — | Nomi dei campi congelati. |
| frozen_fields.fields[] | string | — | Nome del campo. |
| frozen_fields.as_of | string | — | Data dell'ultimo aggiornamento dei campi congelati (YYYY-MM-DD). |
| frozen_fields.latest_date | string | — | Data più recente dei campi che si aggiornano ancora (YYYY-MM-DD). |
| frozen_fields.detail | array | — | Dettaglio. |
| frozen_fields.detail[] | object | — | Dettaglio. |
| frozen_fields.detail[].field | string | — | Nome del campo congelato. |
| frozen_fields.detail[].as_of | string | — | Data dell'ultimo aggiornamento di questo campo (YYYY-MM-DD). |
| frozen_fields.detail[].served | string | — | Che cosa restituisce l'API per il campo: `last_known_value` o `null`. |
| frozen_fields.by_ticker | object | — | Per fondo: data dell'ultimo aggiornamento di ciascun campo congelato. chiavi dinamiche: IBIT,FBTC,GBTC,BTC,BITB,ARKB |
| frozen_fields.by_ticker.{*} | object | — | Campi congelati di un fondo, indicizzati per nome del campo. |
| frozen_fields.by_ticker.{*}.fee_pct | string | % | Data dell'ultimo aggiornamento di `fee_pct` (YYYY-MM-DD). |
| frozen_fields.by_ticker.{*}.volume_usd | string | USD | Volume in nozionale USD. |
| frozen_fields.by_ticker.{*}.mkt_share_pct | string | % | Data dell'ultimo aggiornamento di `mkt_share_pct` (YYYY-MM-DD). |
| frozen_fields.by_ticker.{*}.cum_inflow_official | string | — | Data dell'ultimo aggiornamento di `cum_inflow_official` (YYYY-MM-DD). |
| frozen_fields.by_ticker.{*}.latest_premium_pct | string | % | Data dell'ultimo aggiornamento di `latest_premium_pct` (YYYY-MM-DD). |
| frozen_fields.note | string | — | Nota. |
Generata 2026-11-11 23:00 UTC da 1 risposte reali.
Risposta di esempio
/api/etf/funds?asset=BTC · Risposta reale acquisita 2026-11-13 03:58:19 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: funds conteneva 13 elementi; frozen_fields.detail conteneva 5 elementi; frozen_fields.by_ticker conteneva 13 elementi.
- "success"true
- "asset""BTC"
- "unit""million_usd"
- "count"13
- "funds"
- "frozen_fields"
- "fields"
- "as_of""2026-10-08"
- "latest_date""2026-11-12"
- "detail"
- "by_ticker"
- "note""fields 所列字段的数据源自 as_of 之后未再更新:served=last_known_value 的字段返回的是 as_of 当日的最后已知值(不是 latest_date 的值);served=null 的字段在 latest_date 无数据、返回 null。其余字段(latest_flow/sum_7d…"
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 (minuto 15); la fonte pubblica una volta per giornata di negoziazione statunitense
- Finestra
- ultima istantanea per fondo (flussi sommati su 7 giornate di negoziazione e dalla quotazione)
- Fonti dei dati
- Elenco per fondo degli ETF spot crypto statunitensi: flussi da un tracker pubblico dei flussi degli ETF, AUM da un sito pubblico di dati di mercato.
- Copertura degli exchange
- Tutti i fondi dell'asset selezionato (BTC, ETH, SOL, HYPE).
- Ordinamento
- AUM più recente decrescente
- Unità
- million USD (flows, AUM); percent (premium, fee, shares)
- Metodo
- cum_total = sum of daily flows; etf_share_pct = fund AUM / sum of AUM of all funds of the same asset x 100.
- Timestamp
- Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
- Formato della risposta
- json
- Stabilità
- Stabile
Stato in tempo reale
Flussi e asset detenuti si aggiornano ogni giorno. `fee_pct`, `volume_usd`, `mkt_share_pct` e `cum_inflow_official` provengono da una fonte che ha smesso di pubblicare il 2026-10-08 e conservano l'ultimo valore finché non sarà attiva una fonte sostitutiva; questi quattro campi non vanno considerati attuali. `latest_premium_pct` è `null` per lo stesso motivo. L'oggetto `frozen_fields` nella risposta elenca questi campi con la data a cui si riferisce ciascun valore.
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/fundsParzialestring · predefinito BTC — Underlying asset. Any other value returns 400 `INVALID_PARAM`.
https://www.coinboss.com/api/etf/funds?asset=BTCAltro 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