Commissioni di finanziamento cumulate
Finanziamento cumulato: classifica senza coin, totali per exchange a 1d/7d/30d/90d con coin
/api/funding/feesRichiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| coin | string | Facoltativo | — | — | Simbolo della moneta; se presente attiva la modalità per exchange per quella moneta. |
| days | integer | Facoltativo | 30 | ≥ 1 · ≤ 90 | Finestra retrospettiva in giorni. Esempio: 30 |
| limit | integer | Facoltativo | 100 | ≤ 300 | Numero di righe da restituire. |
Richiesta di esempio
curl -s "https://www.coinboss.com/api/funding/fees?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.
| Campo | Tipo | Unità | Descrizione |
|---|---|---|---|
| success | boolean | — | true quando la richiesta è riuscita. In caso di errore il corpo è `{ success: false, code, error, request_id }`. |
| days | number | — | Valori giornalieri o numero di giorni. |
| exchanges | array | — | Exchange. |
| exchanges[] | string | — | Exchange. |
| count | number | — | Numero di elementi. |
| data | array | — | Payload. |
| data[] | object | — | Payload. |
| data[].base | string | — | Simbolo dell'asset di base. |
| data[].fees | object | — | Finanziamento regolato cumulato per exchange negli ultimi `days` giorni, in percentuale (somma dei tassi regolati × 100); le chiavi sono gli ID degli exchange. |
| data[].fees.aster | number | — | Valore per l'exchange `aster` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.binance | number | — | Valore per l'exchange `binance` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.bingx | number | — | Valore per l'exchange `bingx` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.bitget | number | — | Valore per l'exchange `bitget` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.bybit | number | — | Valore per l'exchange `bybit` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.cryptocom | number | — | Valore per l'exchange `cryptocom` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.deribit | number | — | Valore per l'exchange `deribit` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.dydx | number | — | Valore per l'exchange `dydx` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.gate | number | — | Valore per l'exchange `gate` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.htx | number | — | Valore per l'exchange `htx` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.hyperliquid | number | — | Valore per l'exchange `hyperliquid` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.kraken | number | — | Valore per l'exchange `kraken` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.kucoin | number | — | Valore per l'exchange `kucoin` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.mexc | number | — | Valore per l'exchange `mexc` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.okx | number | — | Valore per l'exchange `okx` (la chiave è l'ID dell'exchange). può essere assente |
| data[].fees.whitebit | number | — | Valore per l'exchange `whitebit` (la chiave è l'ID dell'exchange). può essere assente |
| data[].volume_usd | number | USD | Volume in nozionale USD. |
Generata 2026-11-11 23:00 UTC da 1 risposte reali.
Risposta di esempio
/api/funding/fees?days=30 · Risposta reale acquisita 2026-11-13 03:57:45 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: data conteneva 100 elementi; exchanges conteneva 16 elementi.
- "success"true
- "days"30
- "exchanges"
- "binance"
- "okx"
- "bybit"
- "bitget"
- "gate"
- "htx"
- "deribit"
- "aster"
- "count"100
- "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 (collector dei derivati con timer a 60 min; job di regolamento del livello dati proprio al minuto >= 6 di ogni ora)
- Finestra
- modalità moneta (?coin=): finestre 1 d / 7 d / 30 d / 90 d; modalità elenco: parametro days, predefinito 30, 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)
- Paginazione
- modalità elenco: limit (predefinito 100, max 300)
- Ordinamento
- modalità elenco: volume futures decrescente
- Unità
- cumulative settled funding in percent
- Metodo
- cumulative = SUM(settled rate) x 100 per exchange over the window; coin mode adds covered[window] = settlement count >= 90% of (days x 3) AND last settlement within 12 h
- 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/funding/feesDisponibilestring — Coin symbol; when present switches to per-exchange mode for that coin.
integer · predefinito 30 · min 1 · max 90 — Look-back window in days.
integer · predefinito 100 · max 300 — Number of rows to return.
https://www.coinboss.com/api/funding/fees?days=30Altro 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