Volume 24h—Open Interest—Liquidazioni 24h$1.36BLong/Short 24h—Dominanza BTC—Dominanza ETH—
App
Lingua ▾
€ EUR ▾
/api/sd/cme/cot
GETDisponibileFRESH

Posizionamento CFTC (futures crypto del CME)

Serie settimanale Commitments of Traders per i futures crypto del CME: posizioni long, short, spread e nette di dealer, gestori patrimoniali, fondi a leva, altri soggetti segnalanti e soggetti non segnalanti.

GET/api/sd/cme/cot

Richiesta

Parametri di query

NomeTipoObbligatorioPredefinitoValori ammessiDescrizione
coinstringObbligatorio——Simbolo della moneta: `BTC`, `ETH`, `SOL` o `XRP`. Esempio: BTC
rangestringFacoltativo1y3m, 6m, 1y, 3y, allIntervallo retrospettivo; un punto per report settimanale.
unitstringFacoltativocoincoin, contracts, usdUnità dei campi di posizione. `contracts` richiede `contract`, perché contratti di dimensione diversa non possono essere sommati.
contractstringFacoltativo——Un prodotto CME della moneta (per esempio `BTC` o `MBT`). Predefinito: tutti i prodotti della moneta, convertiti in moneta e sommati.

Richiesta di esempio

curl -s "https://www.coinboss.com/api/sd/cme/cot?coin=BTC"

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 }`.
schemastring—ID dello schema di questa risposta. Cambia solo quando un campo esistente cambia significato o tipo.
nownumbermsOra del server al momento della composizione della risposta.
coinstring—Simbolo della moneta (in maiuscolo).
rangestring—Intervallo retrospettivo applicato.
unitstring—Unità dei campi di posizione: `coin`, `contracts` o `usd`.
contractnull—Prodotto CME selezionato, oppure `null` per tutti i prodotti della moneta.
report_datestring—Data di riferimento del report della CFTC (di norma un martedì).
contractsarray—Prodotti CME inclusi.
contracts[]string—Prodotti CME inclusi.
multipliersobject—Monete per contratto, per prodotto (la chiave è il codice del prodotto). chiavi dinamiche: BTC,MBT
multipliers.{*}number—Monete per contratto, per prodotto (la chiave è il codice del prodotto).
pointsnumber—Punti della serie, dal più vecchio.
latestobject—Report settimanale più recente.
latest.datestring—Data di riferimento del report settimanale.
latest.contractsarray—Prodotti CME inclusi.
latest.contracts[]string—Prodotti CME inclusi.
latest.oinumber—Open interest totale del report, nell'unità selezionata.
latest.dealer_longnumber—Posizioni long di dealer / intermediari.
latest.dealer_shortnumber—Posizioni short di dealer / intermediari.
latest.dealer_spreadnumber—Posizioni long e short dei dealer che si compensano; non incluse né in long né in short.
latest.dealer_netnumber—Dealer: long − short.
latest.asset_mgr_longnumber—Posizioni long di gestori patrimoniali / istituzionali.
latest.asset_mgr_shortnumber—Posizioni short di gestori patrimoniali / istituzionali.
latest.asset_mgr_spreadnumber—Posizioni dei gestori patrimoniali che si compensano; non incluse né in long né in short.
latest.asset_mgr_netnumber—Gestori patrimoniali: long − short.
latest.lev_money_longnumber—Posizioni long dei fondi a leva.
latest.lev_money_shortnumber—Posizioni short dei fondi a leva.
latest.lev_money_spreadnumber—Posizioni dei fondi a leva che si compensano; non incluse né in long né in short.
latest.lev_money_netnumber—Fondi a leva: long − short.
latest.other_rept_longnumber—Posizioni long degli altri soggetti segnalanti.
latest.other_rept_shortnumber—Posizioni short degli altri soggetti segnalanti.
latest.other_rept_spreadnumber—Posizioni degli altri soggetti segnalanti che si compensano; non incluse né in long né in short.
latest.other_rept_netnumber—Altri soggetti segnalanti: long − short.
latest.nonrept_longnumber—Posizioni long dei soggetti non segnalanti (piccoli trader).
latest.nonrept_shortnumber—Posizioni short dei soggetti non segnalanti (piccoli trader).
latest.nonrept_netnumber—Soggetti non segnalanti: long − short.
seriesarray—Punti settimanali, dal più vecchio.
series[]object—Punti settimanali, dal più vecchio.
series[].datestring—Data di riferimento del report settimanale.
series[].contractsarray—Prodotti CME inclusi.
series[].contracts[]string—Prodotti CME inclusi.
series[].oinumber—Open interest totale del report, nell'unità selezionata.
series[].dealer_longnumber—Posizioni long di dealer / intermediari.
series[].dealer_shortnumber—Posizioni short di dealer / intermediari.
series[].dealer_spreadnumber—Posizioni long e short dei dealer che si compensano; non incluse né in long né in short.
series[].dealer_netnumber—Dealer: long − short.
series[].asset_mgr_longnumber—Posizioni long di gestori patrimoniali / istituzionali.
series[].asset_mgr_shortnumber—Posizioni short di gestori patrimoniali / istituzionali.
series[].asset_mgr_spreadnumber—Posizioni dei gestori patrimoniali che si compensano; non incluse né in long né in short.
series[].asset_mgr_netnumber—Gestori patrimoniali: long − short.
series[].lev_money_longnumber—Posizioni long dei fondi a leva.
series[].lev_money_shortnumber—Posizioni short dei fondi a leva.
series[].lev_money_spreadnumber—Posizioni dei fondi a leva che si compensano; non incluse né in long né in short.
series[].lev_money_netnumber—Fondi a leva: long − short.
series[].other_rept_longnumber—Posizioni long degli altri soggetti segnalanti.
series[].other_rept_shortnumber—Posizioni short degli altri soggetti segnalanti.
series[].other_rept_spreadnumber—Posizioni degli altri soggetti segnalanti che si compensano; non incluse né in long né in short.
series[].other_rept_netnumber—Altri soggetti segnalanti: long − short.
series[].nonrept_longnumber—Posizioni long dei soggetti non segnalanti (piccoli trader).
series[].nonrept_shortnumber—Posizioni short dei soggetti non segnalanti (piccoli trader).
series[].nonrept_netnumber—Soggetti non segnalanti: long − short.
coverageobject—Che cosa è incluso e che cosa non è incluso nei numeri. Confrontare questo dato prima di confrontare i totali con un'altra fonte.
coverage.included_exchangesarray—Fonti i cui dati aggiornati sono inclusi.
coverage.included_exchanges[]string—Fonti i cui dati aggiornati sono inclusi.
coverage.unavailablearray—Fonti che non è stato possibile includere, ciascuna con il motivo. Non vengono mai conteggiate come 0. vuoto nei campioni usati per generare questa tabella
coverage.stale_excludedarray—Righe escluse perché il loro ultimo aggiornamento è fuori dalla finestra di freschezza. vuoto nei campioni usati per generare questa tabella
methodobject—Enunciato in testo semplice delle formule usate per questa risposta, una voce per campo.
method.valuestring—Nota sulla formula di `value`, in testo semplice.
method.categoriesstring—Nota sulla formula di `categories`, in testo semplice.
method.identitystring—Nota sulla formula di `identity`, in testo semplice.
method.pricestring—Nota sulla formula di `price`, in testo semplice.
method.is_stalestring—Nota sulla formula di `is_stale`, in testo semplice.
metaobject—Provenienza e freschezza di questa risposta.
meta.schemastring—ID dello schema di questa risposta. Cambia solo quando un campo esistente cambia significato o tipo.
meta.sourcearray—Endpoint pubblici a monte da cui sono stati raccolti i dati.
meta.source[]object—Endpoint pubblici a monte da cui sono stati raccolti i dati.
meta.source[].exchangestring—ID dell'exchange (in minuscolo).
meta.source[].endpointstring—Endpoint pubblico della fonte letto dal collector (mostrato a scopo di provenienza; i client non lo chiamano mai).
meta.observed_atnumbermsTimestamp indicato dalla fonte per i dati.
meta.received_atnumbermsOra in cui il collector di CoinBoss ha ricevuto i dati.
meta.fetched_atnumbermsOra in cui questa risposta è stata composta.
meta.windowstring—Finestra temporale coperta dai numeri.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN o UNAVAILABLE, valutato dai timestamp dei dati e dalla copertura.
meta.is_staleboolean—True quando i dati sono più vecchi della loro finestra di freschezza.
meta.cache_ttl_snumbersDurata in cache di questa risposta.
meta.fallbackstring—Che cosa restituisce l'endpoint quando il collector o una fonte non funziona.
latest.pricenumberUSDPrezzo usato per la conversione in USD. può essere assente
latest.price_srcstring—Provenienza di `price`: prezzo di regolamento della scadenza più vicina (front-month) del CME quando viene raccolto, altrimenti un prezzo di riferimento giornaliero etichettato. può essere assente
series[].pricenumberUSDPrezzo usato per la conversione in USD. può essere assente
series[].price_srcstring—Provenienza di `price`: prezzo di regolamento della scadenza più vicina (front-month) del CME quando viene raccolto, altrimenti un prezzo di riferimento giornaliero etichettato. può essere assente

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

Risposta di esempio

/api/sd/cme/cot?coin=BTC · Risposta reale acquisita 2026-11-13 03:52:57 UTC. Array e mappe lunghi sono abbreviati per la visualizzazione: series conteneva 51 elementi.

  • {
    • "success": true,
    • "schema": "coinboss.sd.cme/1",
    • "now": 1794541977237,
    • "coin": "BTC",
    • "range": "1y",
    • "unit": "coin",
    • "contract": null,
    • "report_date": "2026-11-03",
    • "contracts": [
      • "BTC",
      • "MBT"
      ],
    • "multipliers": {
      • "BTC": 5,
      • "MBT": 0.1
      },
    • "points": 51,
    • "latest": {
      • "date": "2026-11-03",
      • "contracts": [ … 2 ],
      • "oi": 89918.8,
      • "dealer_long": 30263.2,
      • "dealer_short": 27953.8,
      • "dealer_spread": 2450,
      • "dealer_net": 2309.4,
      • "asset_mgr_long": 22052.2,
      • "asset_mgr_short": 9925.7,
      • "asset_mgr_spread": 935,
      • "asset_mgr_net": 12126.5,
      • "lev_money_long": 26616.8,
      • "lev_money_short": 40103.2,
      • "lev_money_spread": 2148,
      • "lev_money_net": -13486.4,
      • "other_rept_long": 1111.6,
      • "other_rept_short": 1787.6,
      • "other_rept_spread": 99.6,
      • "other_rept_net": -676,
      • "nonrept_long": 4242.4,
      • "nonrept_short": 4515.9,
      • "nonrept_net": -273.5
      },
    • "series": [
      • { … 22 },
      • { … 22 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 1 ],
      • "unavailable": [],
      • "stale_excluded": []
      },
    • "method": {
      • "value": "CFTC Commitments of Traders, Traders in Financial Futures, futures only. Each series point is one weekly report (as-of Tuesday). unit=coin: contracts x multipli…",
      • "categories": "dealer = Dealer/Intermediary, asset_mgr = Asset Manager/Institutional, lev_money = Leveraged Funds, other_rept = Other Reportables, nonrept = Non-reportable; *_…",
      • "identity": "oi = sum of the four category longs + four category spreads + nonrept_long (and the same on the short side)",
      • "price": "unit=usd only: CME front-month final settlement of the report date when collected, otherwise reference spot price (price_src per point); null price gives null v…",
      • "is_stale": "now is more than 10 days past the scheduled release of the latest stored report (release = report_date + 3 days, 21:30 UTC upper bound for Friday 15:30 ET)"
      },
    • "meta": {
      • "schema": "coinboss.sd.cme/1",
      • "source": [ … 1 ],
      • "observed_at": 1793664000000,
      • "received_at": 1794504008901,
      • "fetched_at": 1794541977237,
      • "window": "1y",
      • "quality": "FRESH",
      • "is_stale": false,
      • "cache_ttl_s": 300,
      • "fallback": "on collector failure the last stored weekly report is served with its real report_date; flagged is_stale=true once 10 days have passed since its scheduled relea…"
      }
    }

Campioni verificati

Oltre all'esempio qui sopra, la sonda chiama questo endpoint con i parametri seguenti e ogni volta ne verifica lo schema.

ParametriHTTPLatenzaRisultato
coin=ETH&unit=usd2006 msSuperato PARTIAL
coin=BTC&range=all20019 msSuperato FRESH
coin=BTC&unit=contracts4001 msSuperato restituisce l'errore previsto

Verificato 2026-11-13 03:28:22 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
Settimanale. La data del report è di norma il martedì e la CFTC lo pubblica il venerdì; il collector controlla tre volte al giorno.
Finestra
3m / 6m / 1y / 3y / all, punti settimanali.
Fonti dei dati
Commitments of Traders della CFTC, report Traders in Financial Futures (solo futures), raccolto e archiviato da CoinBoss (sd_cme_cot_weekly).
Copertura degli exchange
BTC dal 2018-04-10, ETH dal 2021-04-06; SOL e XRP dalla loro quotazione al CME. Una settimana in cui un prodotto della moneta manca dal report è contrassegnata come PARTIAL.
Paginazione
Nessuna paginazione; `range` determina il numero di punti.
Ordinamento
Data del report crescente.
Unità
Positions in coin by default (contracts × multiplier), or in contracts / USD with `unit`. With `unit=usd` each point carries the reference `price` and `price_src` used.
Metodo
net = long − short for every trader class. `*_spread` is the offsetting long-and-short position held by the same trader and is not included in long or short. Identity: Σ long + Σ spread + non-reportable long = open interest (and the same on the short side).
Timestamp
Millisecondi dall'epoca Unix (UTC), salvo diversa indicazione nella descrizione del campo
Formato della risposta
json
Stabilità
Stabile
Disponibile dal
2026-11-11

Stato in tempo reale

DisponibileVerificato 2026-11-13 03:52:57 UTCHTTP 2005 msSchema conformeDato più recente risalente a 10.5h fa

Disponibilità, ultimi 30 giorni

100% di 405 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/sd/cme/cotDisponibile
Parametri

string — Coin symbol: `BTC`, `ETH`, `SOL` or `XRP`.

string · predefinito 1y — Look-back range; one point per weekly report.

string · predefinito coin — Unit of the position fields. `contracts` requires `contract`, because contracts of different size cannot be added.

string — One CME product of the coin (for example `BTC` or `MBT`). Default: all products of the coin, converted to coin and summed.

URL della richiestahttps://www.coinboss.com/api/sd/cme/cot?coin=BTC
Scegliere un endpoint e premere «Invia richiesta». La risposta, gli header e i tempi compariranno qui.