Storico del finanziamento ponderato per OI / per volume
Storico del tasso di finanziamento ponderato per OI / per volume di una moneta
/api/currency/funding-weightedRichiesta
Parametri di query
| Nome | Tipo | Obbligatorio | Predefinito | Valori ammessi | Descrizione |
|---|---|---|---|---|---|
| coin | string | Obbligatorio | — | — | Simbolo della moneta di base (in maiuscolo, ad es. BTC). Esempio: BTC |
| days | integer | Facoltativo | 7 | ≤ 365 | Finestra retrospettiva in giorni. Esempio: 7 |
| iv | string | Facoltativo | — | 30m, 1h, 4h, 1d | Intervallo di campionamento; se omesso è scelto automaticamente in base a days (1h fino a 14d, 4h fino a 90d, altrimenti 1d). |
Richiesta di esempio
curl -s "https://www.coinboss.com/api/currency/funding-weighted?coin=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 }`. |
| coin | string | — | Simbolo della moneta, in maiuscolo (per esempio BTC). |
| data | object | — | Payload. |
| data.funding | array | — | Blocco o valore del tasso di finanziamento. |
| data.funding[] | object | — | Blocco o valore del tasso di finanziamento. |
| data.funding[].t | number | ms | Timestamp. |
| data.funding[].w | number | fraction | Tasso di finanziamento medio del bucket ponderato per open interest: Σ(tasso × open interest) ÷ Σ open interest sui contratti che hanno entrambi i valori; i tassi non sono normalizzati per intervallo. |
| data.funding[].avg | number | — | Media. |
| data.price | array | — | Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione). |
| data.price[] | object | — | Ultimo prezzo nella valuta di quotazione (USD o USDT, salvo diversa indicazione). |
| data.price[].t | number | ms | Timestamp. |
| data.price[].c | number | USD | Chiusura della candela a 1h della moneta che inizia in `t`. |
Generata 2026-11-11 23:00 UTC da 4 risposte reali.
Risposta di esempio
/api/currency/funding-weighted?coin=BTC&days=7 · Risposta reale acquisita 2026-11-13 04:02:35 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: data.price conteneva 168 elementi; data.funding conteneva 168 elementi.
- "success"true
- "coin""BTC"
- "data"
- "funding"
- "price"
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 |
|---|---|---|---|
| coin=ETH&days=7 | 200 | 24 ms | Superato |
| coin=SOL&days=7 | 200 | 22 ms | Superato |
| coin=ARKM&days=7 | 200 | 20 ms | Superato |
Verificato 2026-11-13 03:57:42 UTC
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
- archivio orario a ogni cambio d'ora UTC (istantanea della tabella dei valori più recenti); copia su ClickHouse sincronizzata ogni 5 min
- Finestra
- parametro days, predefinito 7, max 365; parametro iv 30m | 1h | 4h | 1d (auto: <= 14 d -> 1h, <= 90 d -> 4h, altrimenti 1d)
- Fonti dei dati
- Istantanee orarie dei tassi di finanziamento e dell'open interest raccolte internamente dalle API REST pubbliche di 24 exchange di perpetui (ad es. binance, okx, bybit, bitget, gate, hyperliquid).
- Copertura degli exchange
- contratti presenti sia nell'archivio orario del finanziamento sia in quello dell'open interest
- Unità
- rates as raw fractions per funding interval; price = 1 h kline close in USD; ts in Unix ms
- Metodo
- per bucket: w = SUM(rate x oi_usd) / SUM(oi_usd) joined on exchange + symbol + hour; avg = AVG(rate)
- 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 411 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/currency/funding-weightedDisponibilestring — Base coin symbol (uppercase, e.g. BTC).
integer · predefinito 7 · max 365 — Look-back window in days.
string — Sampling interval; auto by days when omitted (1h up to 14d, 4h up to 90d, else 1d).
https://www.coinboss.com/api/currency/funding-weighted?coin=BTC&days=7Altro 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