/api/etf/flows
GETDisponibile

Storico dei flussi netti giornalieri degli ETF spot

Storico dei flussi netti giornalieri degli ETF spot (totali)

GET/api/etf/flows
Tabelle dei flussi giornalieri così come pubblicate da una fonte di terze parti, archiviate da CoinBoss. I flussi calcolati da CoinBoss a partire dalle informative degli emittenti si trovano in `/api/sd/etf/history`.

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
assetstringFacoltativoBTCBTC, ETH, SOL, HYPEAsset sottostante. Qualsiasi altro valore restituisce 400 `INVALID_PARAM`. Esempio: BTC
daysstringFacoltativo0—Giorni di retrospettiva; 0 o all = storico completo. Esempio: 30

Richiesta di esempio

curl -s "https://www.coinboss.com/api/etf/flows?asset=BTC&days=30"

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.

CampoTipoUnitàDescrizione
successboolean—true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`.
assetstring—Simbolo dell'asset.
daysnumber—Valori giornalieri o numero di giorni.
unitstring—Unità dei valori di questo oggetto.
countnumber—Numero di elementi.
latestobject—Record più recente.
latest.datestring—Data di calendario (UTC).
latest.flownumber—Flusso netto di creazione / rimborso del giorno.
latest.aumnumber—Asset in gestione.
latest.aum_lastnumbermillion USDUltimo valore non null del patrimonio in gestione complessivo degli ETF spot dell'asset; valido alla data `aum_as_of`, che può essere anteriore a `date`.
latest.aum_as_ofstring—Giornata di contrattazione (YYYY-MM-DD) a cui si riferisce `aum_last`.
latest.cum_totalnumber—Totale cumulato.
latest.sum_7dnumber—Somma a 7 giorni.
dataarray—Payload.
data[]object—Payload.
data[].datestring—Data di calendario (UTC).
data[].flownumber—Flusso netto di creazione / rimborso del giorno.
data[].cumnumber—Flusso netto cumulato dalla quotazione.
data[].aumnumber|null—Asset in gestione.

Generata 2026-11-11 23:00 UTC da 1 risposte reali.

Risposta di esempio

/api/etf/flows?asset=BTC&days=30 · Risposta reale acquisita 2026-11-13 03:58:18 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: data conteneva 30 elementi.

  • {
    • "success": true,
    • "asset": "BTC",
    • "days": 30,
    • "unit": "million_usd",
    • "count": 30,
    • "latest": {
      • "date": "2026-11-12",
      • "flow": -47.7,
      • "aum": 98821.466,
      • "aum_last": 98821.466,
      • "aum_as_of": "2026-11-12",
      • "cum_total": 55106.874,
      • "sum_7d": -1411
      },
    • "data": [
      • { … 4 },
      • { … 4 }
      ]
    }

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
intero storico dalla quotazione per impostazione predefinita; `days=N` restituisce le ultime N giornate di negoziazione (i totali cumulati partono sempre dalla quotazione)
Fonti dei dati
Flussi netti giornalieri degli ETF spot crypto statunitensi da un tracker pubblico dei flussi degli ETF; AUM da un sito pubblico di dati di mercato.
Copertura degli exchange
ETF spot statunitensi su BTC, ETH, SOL e HYPE (un asset sconosciuto ripiega su BTC); XRP non viene raccolto. I giorni finali non ancora pubblicati vengono scartati.
Ordinamento
data crescente
Unità
million USD (flow, cum, aum)
Metodo
Uses the source's daily TOTAL row; cum is the running sum since the first record; sum_7d is the sum of the last 7 trading days.
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Stabile

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:58:18 UTCHTTP 2004 msSchema conformeDato più recente risalente a 28h fa

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 →

CodiceHTTPSignificatoChe cosa fare
INVALID_PARAM400Manca un parametro obbligatorio oppure un valore non è accettato. `param` indica il nome del parametro quando è noto.Non riprovare senza modifiche; correggere la richiesta.
UNAUTHORIZED401L'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.
FORBIDDEN403La route non fa parte dell'API pubblica (interna o riservata agli account).Non riprovare.
NOT_FOUND404Route sconosciuta, oppure la moneta / l'exchange / il fondo richiesto non esiste.Non riprovare; verificare il percorso e gli identificatori nel catalogo.
RATE_LIMITED429Più richieste del limite al minuto. `Retry-After` indica i secondi da attendere.Attendere `Retry-After`, poi riprovare con backoff.
INTERNAL500Errore 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_FAILED503La 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.
UNAVAILABLE501 / 503Il 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_FAILED200Alcuni 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

GET/api/etf/flowsDisponibile
Parametri

string · predefinito BTC — Underlying asset. Any other value returns 400 `INVALID_PARAM`.

string · predefinito 0 — Look-back days; 0 or all = full history.

URL della richiestahttps://www.coinboss.com/api/etf/flows?asset=BTC&days=30
Scegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.