Finanziamento cumulato per exchange di una moneta
Finanziamento cumulato per exchange di una moneta
/api/funding/accumulatedRichiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| days | integer | Facoltativo | 7 | ≥ 1 · ≤ 90 | Finestra retrospettiva in giorni. Esempio: 7 |
| base | string | Facoltativo | BTC | — | Simbolo della moneta di base (in maiuscolo, ad es. BTC). Esempio: BTC |
Richiesta di esempio
curl -s "https://www.coinboss.com/api/funding/accumulated?base=BTC&days=7"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 }`. |
| base | string | — | Simbolo dell'asset di base. |
| days | number | — | Valori giornalieri o numero di giorni. |
| unit | string | — | Unità dei valori di questo oggetto. |
| now | number | ms | Ora del server al momento della composizione della risposta. |
| series | array | — | Serie temporale. |
| series[] | object | — | Serie temporale. |
| series[].exchange | string | — | ID dell'exchange, in minuscolo (per esempio `binance`). |
| series[].symbol | string | — | Simbolo dello strumento normalizzato da CoinBoss (per esempio BTCUSDT). |
| series[].points | array | — | Punti dati. |
| series[].points[] | array | — | Punti dati. |
| series[].points[][] | number | — | Punti dati. |
| series[].total_pct | number | % | Quota sul totale. |
| series[].n | number | — | Numero di elementi conteggiati. |
| series[].n_expected | number | count | Regolamenti che una finestra completa dovrebbe contenere: `days` × 24 ÷ `interval_h`; null quando l'intervallo di regolamento non può essere determinato. |
| series[].interval_h | number | h | Intervallo di finanziamento. |
| series[].last_time | number | ms | Ora del regolamento più recente. |
| series[].history_from | number | ms | Record di regolamento più vecchio conservato per questo contratto. |
| series[].complete | boolean | — | True quando lo storico dell'exchange copre l'inizio della finestra e contiene almeno il 90 % dei regolamenti previsti; false significa che `total_pct` è parziale. |
| unavailable | array | — | Elementi per i quali non sono disponibili dati, con i motivi. Mai riportati come 0. |
| unavailable[] | string | — | Elementi per i quali non sono disponibili dati, con i motivi. Mai riportati come 0. |
| method | string | — | Note su formula / metodo. |
Generata 2026-11-11 23:00 UTC da 4 risposte reali.
Risposta di esempio
/api/funding/accumulated?base=BTC&days=7 · Risposta reale acquisita 2026-11-13 03:57:43 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: series conteneva 16 elementi; series[].points conteneva 21 elementi.
- "success"true
- "base""BTC"
- "days"7
- "unit""pct"
- "now"1794542263852
- "series"
- "unavailable"
- "backpack"
- "bitfinex"
- "bitunix"
- "edgex"
- "lbank"
- "lighter"
- "paradex"
- "method""settled_records: cum = Σ 交易所实际结算费率(funding_settle,逐笔);1h/4h 结算的交易所每笔都计入;complete=false 为历史起点晚于窗口起点或窗内结算笔数不足(断档)"
Campioni verificati
Oltre all'esempio qui sopra, la sonda chiama questo endpoint con i parametri seguenti e ogni volta ne verifica lo schema.
| Parametri | HTTP | Latenza | Risultato |
|---|---|---|---|
| base=ETH&days=7 | 200 | 42 ms | Superato |
| base=SOL&days=7 | 200 | 41 ms | Superato |
| base=ARKM&days=7 | 200 | 37 ms | Superato |
Verificato 2026-11-13 03:57:43 UTC
Dettagli
- Autenticazione
- Nessuna. Endpoint pubblico.
- Limite di richieste
- 1200 richieste al minuto per IP
- Cache del server
- 10m
- Micro-cache edge
- 10s
- Frequenza di aggiornamento
- ogni ora (collector dei derivati con timer a 60 min; job di regolamento del livello dati proprio al minuto >= 6 di ogni ora)
- Finestra
- parametro days, predefinito 7, intervallo 1..90
- Fonti dei dati
- Record dei tassi di finanziamento regolati, interrogati ogni ora dai collector interni sugli endpoint pubblici dello storico del finanziamento di 16 exchange (ad es. binance, bybit, okx, gate, bitget, hyperliquid).
- Copertura degli exchange
- 16 exchange; binance copre tutti i perpetui USDT; bybit / okx / gate / bitget coprono le prime 60 monete per volume futures, htx le prime 20; aster, hyperliquid, kucoin, mexc, bingx, kraken, dydx, deribit, whitebit, cryptocom mantengono un solo contratto principale per moneta; bitfinex non ha uno storico pubblico dei regolamenti; la profondità dello storico varia a seconda dell'exchange (binance / bybit / okx / bitget dal 2026-04-04, gli altri da date successive); gli exchange con un tasso di finanziamento attivo ma senza storico dei regolamenti sono elencati in `unavailable`
- Ordinamento
- total_pct decrescente
- Unità
- unit = 'pct': cumulative settled funding in percent (points = [funding_time ms, cumulative %]); total_pct in percent; interval_h in hours
- Metodo
- per exchange: cum = running SUM(settled rate) x 100 over the window for the contract with the most settlements; complete = history starts before the window AND settlement count >= 90% of floor(days x 24 / interval_h)
- Timestamp
- Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
- Formato della risposta
- json
- Stabilità
- Stabile
Stato in tempo reale
Gli exchange privi di uno storico dei regolamenti (elencati in `unavailable`) non sono inclusi; vengono riportati per nome anziché essere riempiti con zero.
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/funding/accumulatedParzialeinteger · predefinito 7 · min 1 · max 90 — Look-back window in days.
string · predefinito BTC — Base coin symbol (uppercase, e.g. BTC).
https://www.coinboss.com/api/funding/accumulated?days=7&base=BTCAltro in questa categoria
- Finanziamento di una moneta /api/sd/funding
- Storico del finanziamento ponderato per OI / per volume /api/currency/funding-weighted
- Dettaglio del tasso di finanziamento per exchange di una moneta /api/derivatives/funding-detail
- Finanziamento cumulato per exchange di una moneta /api/funding/accumulated
- Opportunità di arbitraggio sul finanziamento /api/funding/arbitrage
- Serie per il grafico del tasso di finanziamento di una moneta /api/funding/chart
- Tassi di finanziamento attuali di una moneta sui diversi exchange /api/funding/coin
- Commissioni di finanziamento cumulate /api/funding/fees
- Heatmap del tasso di finanziamento /api/funding/heatmap
- Storico del tasso di finanziamento di una moneta su un exchange /api/funding/history
- Matrice del tasso di finanziamento /api/funding/matrix
- Elenco dei tassi di finanziamento per moneta /api/market/funding
- Classifica dello spread del tasso di finanziamento tra exchange /api/market/funding-spread