24s Hacim—Açık pozisyon—24s Likidasyon$1.36B24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—
Uygulama
Dil ▾
₺ TRY ▾
/api/sd/cme/cot
GETKullanılabilirFRESH

CFTC pozisyonlanması (CME kripto vadeli işlemleri)

CME kripto vadeli işlemleri için haftalık Commitments of Traders serisi: aracı kurumların (dealer), varlık yöneticilerinin, kaldıraçlı fonların, diğer raporlama yükümlülerinin ve raporlama yükümlüsü olmayanların long, short, spread ve net pozisyonları.

GET/api/sd/cme/cot

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
coinstringZorunlu——Coin sembolü: `BTC`, `ETH`, `SOL` veya `XRP`. Örnek: BTC
rangestringİsteğe bağlı1y3m, 6m, 1y, 3y, allGeriye dönük aralık; haftalık rapor başına bir nokta.
unitstringİsteğe bağlıcoincoin, contracts, usdPozisyon alanlarının birimi. Farklı büyüklükteki sözleşmeler toplanamayacağından `contracts` için `contract` gerekir.
contractstringİsteğe bağlı——Coinin tek bir CME ürünü (örneğin `BTC` veya `MBT`). Varsayılan: coinin tüm ürünleri, coine çevrilip toplanır.

Örnek istek

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

Yanıt alanları

Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.

AlanTürBirimAçıklama
successboolean—İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
schemastring—Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
coinstring—Coin sembolü (büyük harf).
rangestring—Uygulanan geriye dönük aralık.
unitstring—Pozisyon alanlarının birimi: `coin`, `contracts` veya `usd`.
contractnull—Seçilen CME ürünü veya coinin tüm ürünleri için `null`.
report_datestring—CFTC raporunun veri tarihi (normalde bir salı).
contractsarray—Dahil edilen CME ürünleri.
contracts[]string—Dahil edilen CME ürünleri.
multipliersobject—Ürün bazında sözleşme başına coin miktarı (anahtar, ürün kodudur). dinamik anahtarlar: BTC,MBT
multipliers.{*}number—Ürün bazında sözleşme başına coin miktarı (anahtar, ürün kodudur).
pointsnumber—Seri noktaları, en eskiden başlayarak.
latestobject—En son haftalık rapor.
latest.datestring—Haftalık raporun veri tarihi.
latest.contractsarray—Dahil edilen CME ürünleri.
latest.contracts[]string—Dahil edilen CME ürünleri.
latest.oinumber—Raporun seçilen birim cinsinden toplam açık pozisyonu.
latest.dealer_longnumber—Aracı kurumların (dealer) long pozisyonları.
latest.dealer_shortnumber—Aracı kurumların (dealer) short pozisyonları.
latest.dealer_spreadnumber—Aracı kurumların birbirini dengeleyen long ve short pozisyonları; long veya short'a dahil değildir.
latest.dealer_netnumber—Aracı kurumlar: long − short.
latest.asset_mgr_longnumber—Varlık yöneticilerinin / kurumsal yatırımcıların long pozisyonları.
latest.asset_mgr_shortnumber—Varlık yöneticilerinin / kurumsal yatırımcıların short pozisyonları.
latest.asset_mgr_spreadnumber—Varlık yöneticilerinin birbirini dengeleyen pozisyonları; long veya short'a dahil değildir.
latest.asset_mgr_netnumber—Varlık yöneticileri: long − short.
latest.lev_money_longnumber—Kaldıraçlı fonların long pozisyonları.
latest.lev_money_shortnumber—Kaldıraçlı fonların short pozisyonları.
latest.lev_money_spreadnumber—Kaldıraçlı fonların birbirini dengeleyen pozisyonları; long veya short'a dahil değildir.
latest.lev_money_netnumber—Kaldıraçlı fonlar: long − short.
latest.other_rept_longnumber—Diğer raporlama yükümlülerinin long pozisyonları.
latest.other_rept_shortnumber—Diğer raporlama yükümlülerinin short pozisyonları.
latest.other_rept_spreadnumber—Diğer raporlama yükümlülerinin birbirini dengeleyen pozisyonları; long veya short'a dahil değildir.
latest.other_rept_netnumber—Diğer raporlama yükümlüleri: long − short.
latest.nonrept_longnumber—Raporlama yükümlüsü olmayan (küçük) trader'ların long pozisyonları.
latest.nonrept_shortnumber—Raporlama yükümlüsü olmayan (küçük) trader'ların short pozisyonları.
latest.nonrept_netnumber—Raporlama yükümlüsü olmayanlar: long − short.
seriesarray—Haftalık noktalar, en eskiden başlayarak.
series[]object—Haftalık noktalar, en eskiden başlayarak.
series[].datestring—Haftalık raporun veri tarihi.
series[].contractsarray—Dahil edilen CME ürünleri.
series[].contracts[]string—Dahil edilen CME ürünleri.
series[].oinumber—Raporun seçilen birim cinsinden toplam açık pozisyonu.
series[].dealer_longnumber—Aracı kurumların (dealer) long pozisyonları.
series[].dealer_shortnumber—Aracı kurumların (dealer) short pozisyonları.
series[].dealer_spreadnumber—Aracı kurumların birbirini dengeleyen long ve short pozisyonları; long veya short'a dahil değildir.
series[].dealer_netnumber—Aracı kurumlar: long − short.
series[].asset_mgr_longnumber—Varlık yöneticilerinin / kurumsal yatırımcıların long pozisyonları.
series[].asset_mgr_shortnumber—Varlık yöneticilerinin / kurumsal yatırımcıların short pozisyonları.
series[].asset_mgr_spreadnumber—Varlık yöneticilerinin birbirini dengeleyen pozisyonları; long veya short'a dahil değildir.
series[].asset_mgr_netnumber—Varlık yöneticileri: long − short.
series[].lev_money_longnumber—Kaldıraçlı fonların long pozisyonları.
series[].lev_money_shortnumber—Kaldıraçlı fonların short pozisyonları.
series[].lev_money_spreadnumber—Kaldıraçlı fonların birbirini dengeleyen pozisyonları; long veya short'a dahil değildir.
series[].lev_money_netnumber—Kaldıraçlı fonlar: long − short.
series[].other_rept_longnumber—Diğer raporlama yükümlülerinin long pozisyonları.
series[].other_rept_shortnumber—Diğer raporlama yükümlülerinin short pozisyonları.
series[].other_rept_spreadnumber—Diğer raporlama yükümlülerinin birbirini dengeleyen pozisyonları; long veya short'a dahil değildir.
series[].other_rept_netnumber—Diğer raporlama yükümlüleri: long − short.
series[].nonrept_longnumber—Raporlama yükümlüsü olmayan (küçük) trader'ların long pozisyonları.
series[].nonrept_shortnumber—Raporlama yükümlüsü olmayan (küçük) trader'ların short pozisyonları.
series[].nonrept_netnumber—Raporlama yükümlüsü olmayanlar: long − short.
coverageobject—Sayılara nelerin dahil olduğu ve nelerin olmadığı. Toplamları başka bir kaynakla karşılaştırmadan önce bunu karşılaştırın.
coverage.included_exchangesarray—Güncel verisi dahil edilen kaynaklar.
coverage.included_exchanges[]string—Güncel verisi dahil edilen kaynaklar.
coverage.unavailablearray—Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar. bu tabloyu üretmek için kullanılan örneklerde boş
coverage.stale_excludedarray—Son güncellemesi güncellik penceresinin dışında kaldığı için hariç bırakılan satırlar. bu tabloyu üretmek için kullanılan örneklerde boş
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi.
method.valuestring—`value` için formül notu, düz metin.
method.categoriesstring—`categories` için formül notu, düz metin.
method.identitystring—`identity` için formül notu, düz metin.
method.pricestring—`price` için formül notu, düz metin.
method.is_stalestring—`is_stale` için formül notu, düz metin.
metaobject—Bu yanıtın veri kökeni ve güncelliği.
meta.schemastring—Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir.
meta.sourcearray—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[]object—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[].exchangestring—Borsa kimliği (küçük harf).
meta.source[].endpointstring—Toplayıcının okuduğu kaynağın herkese açık uç noktası (veri kökeni için gösterilir; istemciler bunu hiçbir zaman çağırmaz).
meta.observed_atnumbermsKaynağın veri için verdiği zaman damgası.
meta.received_atnumbermsCoinBoss toplayıcısının veriyi aldığı zaman.
meta.fetched_atnumbermsBu yanıtın oluşturulduğu zaman.
meta.windowstring—Sayıların kapsadığı zaman penceresi.
meta.qualitystring—Veri zaman damgalarına ve kapsama göre değerlendirilen FRESH, PARTIAL, STALE, BROKEN veya UNAVAILABLE.
meta.is_staleboolean—Veri güncellik penceresinden eskiyse true.
meta.cache_ttl_snumbersBu yanıtın önbellek ömrü.
meta.fallbackstring—Toplayıcı veya bir kaynak başarısız olduğunda uç noktanın ne döndürdüğü.
latest.pricenumberUSDUSD'ye çevirmede kullanılan fiyat. bulunmayabilir
latest.price_srcstring—`price` değerinin nereden geldiği: toplandığında CME en yakın vadeli sözleşmesinin uzlaşma fiyatı, aksi hâlde etiketlenmiş bir günlük referans fiyat. bulunmayabilir
series[].pricenumberUSDUSD'ye çevirmede kullanılan fiyat. bulunmayabilir
series[].price_srcstring—`price` değerinin nereden geldiği: toplandığında CME en yakın vadeli sözleşmesinin uzlaşma fiyatı, aksi hâlde etiketlenmiş bir günlük referans fiyat. bulunmayabilir

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 3 gerçek yanıt.

Örnek yanıt

/api/sd/cme/cot?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:52:57 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: series: 51 öğe içeriyordu.

  • {
    • "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…"
      }
    }

Doğrulanmış örnekler

Yoklama, yukarıdaki örneğin yanı sıra bu uç noktayı aşağıdaki parametrelerle de çağırır ve her seferinde şemayı kontrol eder.

ParametrelerHTTPYanıt süresiSonuç
coin=ETH&unit=usd2006 msBaşarılı PARTIAL
coin=BTC&range=all20019 msBaşarılı FRESH
coin=BTC&unit=contracts4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:28:22 UTC

Ayrıntılar

Kimlik doğrulama
Yok. Herkese açık uç nokta.
İstek sınırı
IP başına dakikada 1200 istek
Sunucu önbelleği
5m
Edge mikro önbelleği
10s
Güncelleme sıklığı
Haftalık. Rapor tarihi normalde salıdır ve CFTC raporu cuma günü yayımlar; toplayıcı günde üç kez kontrol eder.
Pencere
3m / 6m / 1y / 3y / all, haftalık noktalar.
Veri kaynakları
CFTC Commitments of Traders, Traders in Financial Futures raporu (yalnızca vadeli işlemler); CoinBoss tarafından toplanır ve saklanır (sd_cme_cot_weekly).
Borsa kapsamı
BTC 2018-04-10'dan, ETH 2021-04-06'dan itibaren; SOL ve XRP, CME'de listelenmelerinden itibaren. Coinin bir ürününün raporda eksik olduğu hafta PARTIAL olarak işaretlenir.
Sayfalama
Sayfalama yok; `range` nokta sayısını sınırlar.
Sıralama
Rapor tarihi, artan.
Birimler
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.
Yöntem
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).
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı
Kullanıma sunulma
2026-11-11

Canlı durum

KullanılabilirKontrol: 2026-11-13 03:52:57 UTCHTTP 2005 msŞema eşleşiyorEn yeni veri noktası 10.5h öncesine ait

Erişilebilirlik, son 30 gün

405 kontrolde başarı oranı: %100

Hatalar

Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →

KodHTTPAnlamıNe yapmalı
INVALID_PARAM400Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir.Değiştirmeden yeniden denemeyin; isteği düzeltin.
UNAUTHORIZED401`CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın.Değiştirmeden yeniden denemeyin.
FORBIDDEN403Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).Yeniden denemeyin.
NOT_FOUND404Bilinmeyen rota ya da istenen coin / borsa / fon yok.Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED429Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir.`Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin.
INTERNAL500Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin.Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin.
UPSTREAM_FAILED503Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez.Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin.
UNAVAILABLE501 / 503Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok.Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler.
REQUEST_FAILED200Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin.Mesaja bağlıdır; başarısız bir istek olarak ele alın.

Deneyin

GET/api/sd/cme/cotKullanılabilir
Parametreler

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

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

string · varsayılan 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.

İstek URL'sihttps://www.coinboss.com/api/sd/cme/cot?coin=BTC
Bir uç nokta seçip “İstek gönder” düğmesine basın. Yanıt, başlıklar ve süre bilgisi burada görünür.