/api/indicators/macro-series
GETDisponibile

Serie macro

Serie macro (tasso sui Fed funds / M2 USA / M2 globale)

GET/api/indicators/macro-series

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
kindstringObbligatorio—fedfunds, us-m2, global-m2Tipo di serie; gli altri valori restituiscono 400. Esempio: fedfunds

Richiesta di esempio

curl -s "https://www.coinboss.com/api/indicators/macro-series?kind=fedfunds"

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 }`.
kindstring—Tipo.
fetched_atnumbermsMomento in cui CoinBoss ha recuperato i dati dalla fonte.
seriesarray—Serie temporale.
series[]object—Serie temporale.
series[].namestring—Nome.
series[].dataarray—Payload.
series[].data[]array—Payload.
series[].data[][]number—Payload.

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

Risposta di esempio

/api/indicators/macro-series?kind=fedfunds · Risposta reale acquisita 2026-11-13 03:53:33 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: series[].data conteneva 868 elementi.

  • {
    • "success": true,
    • "kind": "fedfunds",
    • "fetched_at": 1794519213931,
    • "series": [
      • { … 2 }
      ]
    }

Dettagli

Autenticazione
Nessuna. Endpoint pubblico.
Limite di richieste
1200 richieste al minuto per IP
Cache del server
60m
Micro-cache edge
10s
Frequenza di aggiornamento
su richiesta, in cache per 24 ore (dati mensili)
Finestra
intero storico
Fonti dei dati
Serie macro: tasso sui federal funds e M2 degli USA dal servizio dati pubblico della Federal Reserve; crescita dell'M2 globale da un'API pubblica di terze parti.
Copertura degli exchange
`kind` = fedfunds | us-m2 | global-m2 (obbligatorio; altrimenti 400).
Ordinamento
data crescente
Unità
percent (fedfunds: rate; us-m2 and global-m2: year-over-year change)
Metodo
us-m2 YoY = M2 level / level 12 months earlier - 1; the other series are passed through.
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:53:33 UTCHTTP 2002 msSchema conformeDato più recente risalente a 43.2d fa

Disponibilità, ultimi 30 giorni

100% di 407 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/indicators/macro-seriesDisponibile
Parametri

string — Series kind; other values return 400.

URL della richiestahttps://www.coinboss.com/api/indicators/macro-series?kind=fedfunds
Scegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.