GETKısmiPARTIAL
CME vadeli işlemler özeti
Tek coin için ürün bazında (standart ve mikro sözleşmeler) CME açık pozisyonu ve günlük hacmi; coin ve USD nominal değerine çevrilmiş olarak, ayrıca en güncel CFTC pozisyonlanma özeti.
GET
/api/sd/cme/overviewKısmi kapsam. Sözleşme ve coin cinsinden açık pozisyon ve hacim borsa rakamlarıdır. Resmî CME uzlaşma fiyatı henüz toplanmadığından USD nominal değeri şu anda etiketlenmiş bir günlük referans fiyat (`price_src`) kullanır; bu eksiklik `coverage.unavailable` altında listelenir ve yanıt bu nedenle PARTIAL olarak işaretlenir.
İstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| coin | string | Zorunlu | — | — | Coin sembolü. `BTC`, `ETH`, `SOL` ve `XRP` için CME ürünleri vardır; diğer geçerli semboller `meta.quality = "UNAVAILABLE"` ile 200 döndürür. Örnek: BTC |
Örnek istek
curl -s "https://www.coinboss.com/api/sd/cme/overview?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.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| schema | string | — | Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir. |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| coin | string | — | Coin sembolü (büyük harf). |
| trade_date | string|null | — | Rakamların CME işlem tarihi. |
| oi_contracts | object|null | — | Sözleşme cinsinden açık pozisyon, tek taraflı. dinamik anahtarlar: BTC,MBT |
| oi_contracts.{*} | number | contracts | Sözleşme cinsinden açık pozisyon, tek taraflı. |
| oi_coin | number|null | coin | Coin cinsinden açık pozisyon: sözleşme sayısı × sözleşme çarpanı. |
| oi_usd | number|null | USD | USD nominal değeri olarak açık pozisyon: coin × `price`. |
| volume_contracts | object|null | — | İşlem tarihinin sözleşme cinsinden toplam hacmi (elektronik, salon ve borsa dışı). dinamik anahtarlar: BTC,MBT |
| volume_contracts.{*} | number | contracts | İşlem tarihinin sözleşme cinsinden toplam hacmi (elektronik, salon ve borsa dışı). |
| volume_coin | number|null | coin | Coin cinsinden hacim: sözleşme sayısı × sözleşme çarpanı. |
| volume_usd | number|null | USD | USD nominal değeri olarak hacim: coin × `price`. |
| price | number|null | USD | USD'ye çevirmede kullanılan fiyat. |
| price_src | string|null | — | `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. |
| products | array|null | — | Coinin her CME ürünü için bir satır. |
| products[] | object | — | Coinin her CME ürünü için bir satır. |
| products[].product | string | — | CME ürün kodu. |
| products[].name | string | — | CME ürün adı. |
| products[].multiplier | number | coin | Sözleşme başına coin miktarı. |
| products[].oi_contracts | number | contracts | Sözleşme cinsinden açık pozisyon, tek taraflı. |
| products[].oi_coin | number | coin | Coin cinsinden açık pozisyon: sözleşme sayısı × sözleşme çarpanı. |
| products[].oi_usd | number | USD | USD nominal değeri olarak açık pozisyon: coin × `price`. |
| products[].volume_contracts | number | contracts | İşlem tarihinin sözleşme cinsinden toplam hacmi (elektronik, salon ve borsa dışı). |
| products[].globex_volume_contracts | number | contracts | Hacmin elektronik (Globex) bölümü. |
| products[].volume_coin | number | coin | Coin cinsinden hacim: sözleşme sayısı × sözleşme çarpanı. |
| products[].volume_usd | number | USD | USD nominal değeri olarak hacim: coin × `price`. |
| products[].settle | null | USD | En yakın vadeli sözleşmenin uzlaşma fiyatı; toplanmadığı sürece `null`. |
| products[].settle_month | null | — | Uzlaşma fiyatının sözleşme ayı. |
| products[].settle_src | null | — | Uzlaşma fiyatının kaynağı. |
| cot | object|null | — | Coin için en son CFTC Commitments of Traders raporunun özeti. |
| cot.report_date | string | — | CFTC raporunun veri tarihi (normalde bir salı). |
| cot.is_stale | boolean | — | Veri güncellik penceresinden eskiyse true. |
| cot.contracts | array | — | Dahil edilen CME ürünleri. |
| cot.contracts[] | string | — | Dahil edilen CME ürünleri. |
| cot.unit | string | — | Pozisyon alanlarının birimi: `coin`, `contracts` veya `usd`. |
| cot.oi_contracts | object | — | Sözleşme cinsinden açık pozisyon, tek taraflı. dinamik anahtarlar: BTC,MBT |
| cot.oi_contracts.{*} | number | contracts | Sözleşme cinsinden açık pozisyon, tek taraflı. |
| cot.oi_coin | number | coin | Coin cinsinden açık pozisyon: sözleşme sayısı × sözleşme çarpanı. |
| cot.dealer_net | number | — | Aracı kurumlar: long − short. |
| cot.asset_mgr_net | number | — | Varlık yöneticileri: long − short. |
| cot.lev_money_net | number | — | Kaldıraçlı fonlar: long − short. |
| cot.other_rept_net | number | — | Diğer raporlama yükümlüleri: long − short. |
| cot.nonrept_net | number | — | Raporlama yükümlüsü olmayanlar: long − short. |
| coverage | object | — | 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_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. |
| coverage.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. |
| coverage.unavailable | array | — | Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar. |
| coverage.unavailable[] | object | — | Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar. |
| coverage.unavailable[].exchange | string | — | Borsa kimliği (küçük harf). |
| coverage.unavailable[].field | string | — | Eksik olan alan. bulunmayabilir |
| coverage.unavailable[].reason | string | — | Makine tarafından okunabilir neden kodu. |
| coverage.unavailable[].detail | string | — | Nedenin insan tarafından okunabilir açıklaması. |
| coverage.stale_excluded | array | — | 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ş |
| method | object | — | Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi. |
| method.oi_contracts | string | — | `oi_contracts` için formül notu, düz metin. |
| method.oi_coin | string | — | `oi_coin` için formül notu, düz metin. |
| method.oi_usd | string | — | `oi_usd` için formül notu, düz metin. |
| method.volume_contracts | string | — | `volume_contracts` için formül notu, düz metin. |
| method.volume_usd | string | — | `volume_usd` için formül notu, düz metin. |
| method.is_stale | string | — | `is_stale` için formül notu, düz metin. |
| method.cot | string | — | `cot` için formül notu, düz metin. |
| meta | object | — | Bu yanıtın veri kökeni ve güncelliği. |
| meta.schema | string | — | 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.source | array | — | Verinin toplandığı herkese açık kaynak uç noktaları. |
| meta.source[] | object | — | Verinin toplandığı herkese açık kaynak uç noktaları. |
| meta.source[].exchange | string | — | Borsa kimliği (küçük harf). |
| meta.source[].endpoint | string | — | 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_at | number|null | ms | Kaynağın veri için verdiği zaman damgası. |
| meta.received_at | number|null | ms | CoinBoss toplayıcısının veriyi aldığı zaman. |
| meta.fetched_at | number | ms | Bu yanıtın oluşturulduğu zaman. |
| meta.window | string | — | Sayıların kapsadığı zaman penceresi. |
| meta.quality | string | — | Veri zaman damgalarına ve kapsama göre değerlendirilen FRESH, PARTIAL, STALE, BROKEN veya UNAVAILABLE. |
| meta.is_stale | boolean | — | Veri güncellik penceresinden eskiyse true. |
| meta.cache_ttl_s | number | s | Bu yanıtın önbellek ömrü. |
| meta.fallback | string | — | Toplayıcı veya bir kaynak başarısız olduğunda uç noktanın ne döndürdüğü. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 4 gerçek yanıt.
Örnek yanıt
/api/sd/cme/overview?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:26 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: meta.source: 3 öğe içeriyordu.
- "success"true
- "schema""coinboss.sd.cme/1"
- "now"1794542306145
- "coin""BTC"
- "trade_date""2026-11-11"
- "oi_contracts"
- "BTC"19533
- "MBT"24382
- "oi_coin"100103.2
- "oi_usd"7409157367.61
- "volume_contracts"
- "BTC"8985
- "MBT"35304
- "volume_coin"48455.4
- "volume_usd"3586435637.53
- "price"74015.19
- "price_src""ref_binance_1d_close"
- "products"
- "cot"
- "report_date""2026-11-03"
- "is_stale"false
- "contracts"
- "unit""coin"
- "oi_contracts"
- "oi_coin"89918.8
- "dealer_net"2309.4
- "asset_mgr_net"12126.5
- "lev_money_net"-13486.4
- "other_rept_net"-676
- "nonrept_net"-273.5
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "method"
- "oi_contracts""open interest in contracts (one-sided) per CME product, from the CME daily volume & open interest report"
- "oi_coin""sum over products of oi_contracts x contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50000, MXP 2500 coins per contract)"
- "oi_usd""oi_coin x price; price = CME front-month final settlement price when collected (price_src=cme_settle_front_month), otherwise a reference spot price for the same…"
- "volume_contracts""CME total volume for the trade date in contracts (Globex + pit + ex-pit + OTC/cleared); globex_volume_contracts is the Globex part"
- "volume_usd""volume in coins (contracts x multiplier) x the same price as oi_usd"
- "is_stale""trade_date 22:00 UTC is more than 120h old"
- "cot""latest CFTC Commitments of Traders (TFF, futures only) row(s) for the coin: positions converted to coins with the contract multiplier; net = long - short"
- "meta"
- "schema""coinboss.sd.cme/1"
- "source"
- "observed_at"1794434400000
- "received_at"1794504014502
- "fetched_at"1794542306145
- "window""latest"
- "quality""PARTIAL"
- "is_stale"false
- "cache_ttl_s"300
- "fallback""on collector failure the last stored CME trade date is served with its real trade_date; it is flagged is_stale=true once older than 120h; nothing is interpolate…"
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.
| Parametreler | HTTP | Yanıt süresi | Sonuç |
|---|---|---|---|
| coin=ETH | 200 | 5 ms | Başarılı PARTIAL |
| coin=XRP | 200 | 5 ms | Başarılı PARTIAL |
| coin=PEPE | 200 | 2 ms | Başarılı UNAVAILABLE |
| — | 400 | 1 ms | Başarılı beklenen hatayı döndürür |
Kontrol: 2026-11-13 03:58:26 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ığı
- CME işlem günü başına bir kez yayım yapar; toplayıcı günde üç kez çalışır (04:20, 11:20, 17:20 UTC).
- Pencere
- En son CME işlem tarihi (`trade_date`).
- Veri kaynakları
- CME Group günlük hacim ve açık pozisyon bülteni dosyaları; CFTC Commitments of Traders (Traders in Financial Futures, yalnızca vadeli işlemler). CoinBoss tarafından toplanır ve saklanır (sd_cme_daily, sd_cme_cot_weekly).
- Borsa kapsamı
- Sekiz CME ürünü: BTC, MBT, ETH, MET, SOL, MSL, XRP, MXP. Açık pozisyon tek taraflıdır ve sözleşme cinsindendir.
- Birimler
- Contracts are single-sided. Coin = contracts × contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50,000, MXP 2,500). USD notional = coin × `price`.
- Yöntem
- oi_coin = Σ over products (open interest in contracts × multiplier); oi_usd = oi_coin × price. Volume is total daily volume (electronic, floor and off-exchange).
- 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
KısmiKontrol: 2026-11-13 03:58:26 UTCHTTP 2005 msŞema eşleşiyorEn yeni veri noktası 10.6h öncesine ait
Uç nokta veri kalitesini PARTIAL olarak bildiriyor — Sözleşme ve coin cinsinden açık pozisyon ve hacim borsa rakamlarıdır. Resmî CME uzlaşma fiyatı henüz toplanmadığından USD nominal değeri şu anda etiketlenmiş bir günlük referans fiyat (`price_src`) kullanır; bu eksiklik `coverage.unavailable` altında listelenir ve yanıt bu nedenle PARTIAL olarak işaretlenir.
Erişilebilirlik, son 30 gün
406 kontrolde başarı oranı: %99.75
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ı →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu 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. |
| UNAUTHORIZED | 401 | `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. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika 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. |
| INTERNAL | 500 | Beklenmeyen 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_FAILED | 503 | Bu 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. |
| UNAVAILABLE | 501 / 503 | Veri 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_FAILED | 200 | Bazı 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/overviewKısmiParametreler
string — Coin symbol. `BTC`, `ETH`, `SOL` and `XRP` have CME products; other valid symbols return 200 with `meta.quality = "UNAVAILABLE"`.
İstek URL'si
https://www.coinboss.com/api/sd/cme/overview?coin=BTCBir 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.
Bu kategoride daha fazlası
- CFTC pozisyonlanması (CME kripto vadeli işlemleri) /api/sd/cme/cot
- CME vadeli işlemler özeti /api/sd/cme/overview
- CFTC Commitments of Traders /api/cftc/cot