API'de neler değişti, güncel sürüm ve uyumluluk kuralları.
v1Güncel sürüm
2026.11.12Katalog revizyonu
Sürümleme ve uyumluluk
Sürümleme
Herkese açık API'nin sürümü v1'dir. Yol öneki `/api` olup sürüm numarası taşımaz.
Kataloğun tarihe dayalı kendi sürümü vardır (`catalog_version`, örneğin 2026.11.11). Uç noktalar, parametreler veya dokümantasyon her değiştiğinde bu sürüm de değişir.
CoinBoss'un kendi topladığı veri katmanının uç noktalarından gelen her yanıt bir `schema` kimliği taşır (örneğin `sd.oi.v1`). Yeni bir kimlik yalnızca mevcut bir alanın anlamı veya türü değiştiğinde verilir.
Uyumluluk
Uç nokta, isteğe bağlı parametre, yanıt alanı, enum değeri veya borsa eklenmesi uyumluluğu bozmayan bir değişikliktir ve her an yapılabilir. İstemciler tanımadıkları alanları yok saymalıdır.
Bir alanın kaldırılması veya yeniden adlandırılması, türünün ya da biriminin değiştirilmesi veya isteğe bağlı bir parametrenin zorunlu hâle getirilmesi uyumluluğu bozan bir değişikliktir. Böyle bir değişiklik yayına alınmadan önce burada duyurulur.
Düzeltmeler istisnadır: yanlış bir sayıya veya eskiden sessizce kabul edilen geçersiz bir girdiye yönelik düzeltme hemen yayımlanır ve yayına girdiği gün burada listelenir; istemci kodunun değişmesi gerekebilecekse uyumluluğu bozan değişiklik olarak işaretlenir.
Kapsam iyileştiği için (yeni bir borsa veya sözleşme türü eklendiğinde) rakamlar değişebilir. Kapsam her zaman yanıtta bildirilir; bu yüzden toplamları karşılaştırmadan önce `coverage` bloğunu karşılaştırın.
Eksik veri `null` olarak döndürülür ve `coverage.unavailable` altında listelenir; asla 0 ya da bir tahminle değiştirilmez. `null` değerini 0 sayan kod yanlış sonuç verir.
Kullanım dışı bırakma
`legacy` olarak işaretlenen uç noktalar çalışmaya devam eder, ancak yeni geliştirmelerde listede belirtilen yerine geçen uç nokta kullanılmalıdır.
Eski bir uç nokta, kullanım dışı bırakıldığına dair kayıt bu değişiklik günlüğünde yayımlandıktan en az 90 gün sonra kaldırılır.
`beta` olarak işaretlenen uç noktalar site sayfalarına hizmet eder; alan kümeleri 90 günlük ön bildirim olmadan değişebilir, yine de her değişiklik burada listelenir.
Değişiklikler
Eklendi2026.11.12Geriye dönük uyumlu
`/api/currency/ex-table`: `market=perpetual`, `delivery` and `all`, plus one status vocabulary
New values of `market`: `perpetual` (perpetual contracts), `delivery` (dated futures) and `all` (spot, perpetual and delivery markets of the coin in one list). They return one row per market and number `rank` inside the requested view.
Every per-market row carries `market_status` (`ACTIVE`, `EXPIRING`, `EXPIRED`, `NO_QUOTE`, `STALE`), `reason_code` (`NO_QUOTE`, `EXPIRED`, `STALE`, `UNAVAILABLE` or null), `source_at`, `quality`, `is_stale`, `expires_in_s`, `symbol` and `base`. The state is derived from the contract specification of the exchange (expiry) and from the time the ticker was received. `status` and `status_reason` are unchanged.
`EXPIRING` marks a contract that still trades and expires within 24 hours (`meta.expiring_window_s`). Rows that are not `ACTIVE` or `EXPIRING` return `price: null`; no price is carried over from an earlier quote or from another contract.
`meta` adds `market_status_counts`, `type_counts` and `type_rankable`. The row order is the same for every caller: rankable rows by `volume_usd` descending, then rows without a quote, expired contracts last.
Eklendi2026.11.12Geriye dönük uyumlu
`/api/liquidation-events` adds event / account counts and BTC high, low and range
New fields on every row: `btc_high`, `btc_low`, `btc_range` (USD, high − low) and `btc_range_pct` ((high − low) / low × 100), with `btc_range_meta`. Prices are the median of the UTC daily high / low on Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD) spot. The fields are null unless all three venues have a final daily candle.
New fields on `coinboss` rows: `liquidation_count` (de-duplicated liquidation events; not people) and `account_count` (distinct liquidated accounts on exchanges that expose an account identifier, currently Hyperliquid only; `quality` is `PARTIAL`), each with a `_meta` object giving source, window, quality and coverage. Both are null on baseline rows.
CoinBoss does not publish a liquidated-trader (people) count; `coverage.metrics.people_count.quality` is `UNAVAILABLE`. `liquidated_traders` and `btc_amplitude` are unchanged: they stay the text recorded in the third-party source and are not copied into the new fields.
Değiştirildi2026.11.12Geriye dönük uyumlu
`/api/currency/ex-table`: per-contract rows carry their own quote and a `status`
With `group=pair`, every contract row now uses the ticker of that contract. Before, only the main contract of each exchange had a price and the other rows returned `price: null`.
New row fields with `group=pair` and `market=spot`: `status` (`active`, `no_quote`, `not_provided`, `expired`), `status_reason`, `market_type`, `expiry_ts`, `expiry_date`, `native_symbol`, `quote`, `margin_type`, `price_source`, `price_at` and `rank`; the response adds `meta` (freshness window, volume window and unit, sort rule, row counts per status).
Rows that are not `active` return `price: null` and are never filled from another contract. `volume_usd` on such rows is `0` only when the exchange reports zero 24h turnover, otherwise `null`.
Order with `group=pair`: `active` rows first by `volume_usd` descending (these carry `rank`), then rows without a live quote by `oi_usd` descending, expired contracts last. `contract_type` now follows the exchange contract specification, so dated contracts on Deribit, Bybit, Gate and KuCoin are reported as `delivery`; `expiry` is set for all of them.
Requests without `group` return the same rows and fields as before.
Değiştirildi2026.11.12Geriye dönük uyumlu
`/api/liquidation-events` returns the Top 10 with a `source` field
This corrects the 2026-11-11 entry below. The historical baseline rows (third-party public historical records) are served again, as recorded and without recalculation.
Rows recorded by CoinBoss are UTC daily totals from its own collectors. A day is added only when its total is greater than the 10th place of the list at that time. Every row carries `source` (`historical_baseline` or `coinboss`) and `basis`.
The list is sorted by `total_usd` and returns 10 rows. New fields: `data[].total_usd` (same value as `amount_usd`), `data[].source`, `data[].basis` and `threshold_usd`. `coverage` is split into `coverage.baseline` and `coverage.coinboss`; the `coverage.source`, `coverage.from` and `coverage.note` fields introduced on 2026-11-11 moved under them.
Değiştirildi2026.11.12Geriye dönük uyumlu
Kaynak hatalarında HTTP 503 döner ve JSON hata gövdesi korunur
Eskiden HTTP 502 veya 504 yanıtı veren başarısız istekler artık `Retry-After` başlığıyla birlikte 503 yanıtı verir. API'nin önündeki CDN, 502 ve 504 yanıtlarının gövdesini kendi metniyle değiştiriyordu; bu da `code` ve `request_id` alanlarının kaybolmasına yol açıyordu. 503 yanıtı ise değişmeden iletilir. `code` değerleri öncekiyle aynıdır.
Bir uç noktanın arkasındaki kaynağın arızalanması artık diğer uç noktaları etkilemez: ağ geçidi yalnızca bağlantı hatalarında ve zaman aşımlarında başka bir sunucu örneğini dener.
`/api/sd/options/*` ve `/api/sd/cme/overview`, Çince karakterlerle yazılmış coin adlarını kabul eder. Böyle bir piyasası olmayan coin için 400 yerine, toplu değerleri `null` olan HTTP 200 döner.
Fonlama uzlaşma geçmişi: 30 günlük pencere içindeki boşluklar, Bybit, OKX, Gate ve Bitget'te en çok işlem gören 150 coin (HTX'te 40) için tespit edilip yeniden doldurulur; böylece `cum_7d` ve `cum_30d` daha fazla coin için eksiksizdir.
Düzeltildi2026.11.11Geriye dönük uyumlu
Likidasyon değişkenliği endeksi onarıldı; kaynağı kullanılamayan uç nokta 503 döndürür
`/api/indicators/cdri`: gün bazındaki gruplama milisaniye cinsinden zaman damgasını saniye olarak okuduğu için günlük seri boştu. Artık likidasyon toplamlarının en fazla 90 tam UTC gününü döndürür; `current.days` (yeni alan) kullanılan gün sayısıdır ve ikiden az gün olduğunda `current.cdri` / `current.liqCV` değerleri `null` olur.
`/api/indicators/reddit-subs`: kaynağı istekleri reddettiği sürece HTTP 500 yerine `UNAVAILABLE` koduyla HTTP 503 yanıtı verir. Abone sayısı yalnızca kaynak pozitif bir sayı döndürdüğünde saklanır.
HTTP 5xx yanıtlarının hata gövdeleri artık eski `msg` alanında kaynaktan gelen hata metnini taşımaz; bu alan artık `error` ile aynı genel mesajı içerir.
Düzeltildi2026.11.11Uyumluluğu bozar
Güncellenmesi duran kayıtlar işaretlenir ve toplamların dışında bırakılır
`/api/coins/all` ve `/api/coins/search`: 48 saatten uzun süredir güncellenmeyen bir coin kaydı, `market_cap` ve `mcap_rank` alanlarını `is_stale: true` ile birlikte `null` olarak döndürür ve tüm güncel satırlardan sonra sıralanır. Yürürlükteki kural `stale_rule` olarak yinelenir.
`/api/derivatives/coins-full`: coin başına tam olarak bir satır. Birden fazla coin kaydının paylaştığı bir sembol eskiden kayıt başına bir satır üretiyordu; satır artık son 48 saat içinde güncellenen en büyük kaydın adını, piyasa değerini ve sırasını taşır, böyle bir kayıt yoksa `null` olur. `mcap_rank` yeni bir alandır.
`/api/reserves/overview`: her satırda `updated_at` ve `is_stale` bulunur. `total` artık yalnızca son 36 saat içinde güncellenen borsaları toplar; önceki tanım `total_including_stale` olarak korunur ve dışarıda bırakılan borsalar `stale_exchanges` içinde listelenir.
`/api/margin/rates` ve `/api/margin-fee/matrix`: oranının güncellenmesi duran varlıklar ve hücreler `is_stale: true` taşır; eşikler ve sayılar üst düzeyde döndürülür.
2026-10-28 ile 2026-11-11 arasındaki günlük küresel piyasa değeri anlık görüntüleri, toplamda imkânsız bir piyasa değerine (Bitcoin'inkinden büyük) sahip iki kayıt bulunmasının ardından yeniden hesaplandı. Toplayıcılar artık bu tür değerler için `null` saklıyor.
Değiştirildi2026.11.11Geriye dönük uyumlu
Kaynak kesintileri, hata vermek veya güncel görünmek yerine yanıtta bildirilir
`/api/indicators/mempool/pools`: madencilik havuzu kaynağı yanıt vermediğinde HTTP 500 yerine saklanan son sonuç `stale: true`, `cached_at` ve `stale_reason` ile birlikte döndürülür.
`/api/etf/funds`: kaynağı 2026-10-08'de yayımlamayı durduran fon düzeyindeki alanları, her değerin ait olduğu tarihle birlikte belirten yeni `frozen_fields` nesnesi.
`/api/indicators/halving`: yeni `current_difficulty` nesnesi (`value`, `as_of`, `source`). `difficulty` (yeniden ayarlama ilerlemesi), kaynağı kullanılamadığı sürece `null` kalır.
`/api/browser/detect`: başarısız olan bir zincir sorgusu artık etkinliği olmayan bir adres olarak bildirilmez. Hiçbir zincir sorgulanamadıysa `kind` değeri `lookup_failed` olur.
`/api/currency/flows`: dokümantasyon artık uç noktanın gerçekten sunduğu 22 pencereyi listeler (5 dakikadan 1 yıla kadar).
Değiştirildi2026.11.11Uyumluluğu bozar
Desteklenmeyen parametre değerleri varsayılan veri yerine 400 döndürür
`/api/derivatives/kline`: `interval=4h`, UTC sınırlarında 1h mumlardan oluşturulan gerçek 4 saatlik mumları döndürür (eskiden 1h mumlar döndürüyordu). `1h`, `4h` veya `1d` dışındaki her aralık 400 döndürür.
`/api/options/` altındaki opsiyon uç noktaları: desteklenmeyen bir `currency`, BTC verisi yerine 400 döndürür ve `coin` yedi uç noktanın hepsinde takma ad olarak kabul edilir.
`/api/etf/flows`, `/api/etf/detail`, `/api/etf/funds` ve `/api/etf/holdings`: desteklenmeyen bir `asset`, BTC verisi yerine 400 döndürür.
`/api/liquidations/coins`: desteklenmeyen bir `range`, 24h verisi yerine 400 döndürür ve yürürlükteki pencere `range` olarak yinelenir.
`limit`; `/api/liquidations`, `/api/liquidations/largest` ve `/api/derivatives/coins-full` üzerinde 1000 üst sınırına indirilir. Sayısal olmayan bir `limit`, hata vermek yerine varsayılanı kullanır.
Düzeltildi2026.11.11Uyumluluğu bozar
Günlük hacim ve araştırma istatistikleri düzeltildi
`/api/volume/coin`: `daily_30d`, bir günün tüm kayan 24h anlık görüntülerini topluyor ve günlük hacmi yaklaşık 24 kat fazla gösteriyordu. Artık her UTC gününün son anlık görüntüsünü alır.
`topic=derivatives` ile `/api/research/stats`: `volume_24h_usd` de aynı şekilde fazla gösteriliyordu; düzeltildi.
Aynı yanıttaki `avg_funding_rate_pct` artık bir yüzdedir; daha önce döndürdüğü ham kesrin yaklaşık 100 katıdır. Bu değeri 100 ile çarpan kodlarınızı düzeltin.
Düzeltildi2026.11.11Geriye dönük uyumlu
Eski piyasa uç noktaları güncellenmesi duran satırları yok sayar
Satırlar yalnızca güncel oldukları sürece sayılır: ticker'lar 1 saat, açık pozisyon 3 saat (CME: 120 saat), fonlama 4 saat, long/short oranları 24 saat içinde.
Toplamlar biraz daha düşük, bazı listeler ise daha kısadır. İşlem görmesi duran sözleşmeler son değerleri yerine `null` fiyat gösterir.
Düzeltildi2026.11.11Geriye dönük uyumlu
Çarpanlı sözleşmeler baz coinleriyle eşleştirildi
`/api/funding/coin`, `/api/funding/history`, `/api/funding/chart` ve `/api/ls/coin` artık bir coinin katları cinsinden kote edilen sözleşmeleri (örneğin `1000PEPE`) baz coinle eşleştirir; böylece bu coinler için daha fazla borsa listelenir.
Eklendi2026.11.11Geriye dönük uyumlu
Altı borsadan opsiyon verileri
Yeni: `/api/sd/options/overview`, `/api/sd/options/expiries`, `/api/sd/options/strikes`, `/api/sd/options/chain` ve `/api/sd/options/history`.
Açık pozisyon, 24h nominal hacim, put/call oranları, maksimum acı, ATM IV, 25 delta skew ve IV vade yapısı; Deribit, Binance, Bybit, OKX, Gate ve Coincall sözleşme listelerinden CoinBoss tarafından hesaplanır.
Nominal hacim ile prim işlem hacmi ayrı alanlardır ve hiçbir zaman birbirine eklenmez. Bir borsanın yayımlamadığı sütunlar `null` olur ve `coverage.field_gaps` altında listelenir.
Geçmiş saatliktir ve 2026-11-11'de başlar; daha önceki saatler geriye dönük doldurulmaz.
Eklendi2026.11.11Geriye dönük uyumlu
Birincil yayınlardan spot ETF, CME ve CFTC verileri
Yeni: `/api/sd/etf/overview`, `/api/sd/etf/funds` ve `/api/sd/etf/history`; ihraççı açıklamalarından oluşturulur. Toplamlar CoinBoss'un toplayabildiği fonları kapsar; diğer tüm fonlar nedeniyle birlikte listelenir ve `totals_scope` her zaman `covered_funds_only` olur.
Fon akışı, CoinBoss tarafından dolaşımdaki pay sayısı ve NAV'dan (ya da net varlıklar ve NAV'dan) hesaplanır. Kullanılan formül her fon için `flow_method` alanında döndürülür.
Yeni: `/api/sd/cme/overview` (sekiz CME ürününün günlük hacmi ve açık pozisyonu) ve `/api/sd/cme/cot` (trader kategorisi bazında haftalık CFTC pozisyonlanması).
CME uzlaşma fiyatları henüz toplanmıyor. USD rakamları etiketlenmiş bir referans fiyat (`price_src`) kullanır; özet de bu nedenle PARTIAL olarak işaretlenir.
Eklendi2026.11.11Geriye dönük uyumlu
Emir defteri derinliği ve kayma
Yeni: `/api/sd/liquidity`, `/api/sd/liquidity/history` ve `/api/sd/liquidity/rank`.
Orta fiyatın ±0.5 %, ±1 % ve ±2 % çevresindeki derinlik ile 10k / 100k / 1M USD'lik piyasa emirlerinin kayması, 24 borsanın gerçek emir defteri anlık görüntülerinden, sürekli vadeli ve spot piyasalar için ayrı ayrı hesaplanır.
Bir banda ulaşmayan anlık görüntü `complete: false` olarak işaretlenir, alt sınır olarak bildirilir ve toplu değere dahil edilmez. `n_included`, bir toplamın kaç emir defteri içerdiğini belirtir.
`/api/indicators/large-orderbook` bir emir defteri değil, model çıktısıdır; bekleyen likidite için yeni uç noktaları kullanın.
Eklendi2026.11.11Geriye dönük uyumlu
Borsaların işaret ve endeks fiyatlarından baz
Yeni: `/api/sd/basis`, `/api/sd/basis/history` ve `/api/sd/basis/rank`.
Sürekli vadeli bazı = aynı borsada (mark − index) ÷ index × 100; spot–sürekli vadeli bazı, sürekli vadeli sözleşmeyi aynı borsanın spot piyasasıyla karşılaştırır; teslimatlı sözleşmelerde ayrıca yıllıklandırılmış bir değer verilir.
Toplu değerler OI ağırlıklı, hacim ağırlıklı ve medyan olarak verilir. Dahil etme kurallarını geçemeyen satırlar yine de `excluded_reason` ile birlikte döndürülür.
Saatlik geçmiş 2026-11-11'de başlar.
Değiştirildi2026.11.11Geriye dönük uyumlu
Simge eşlemeleri herkese açık site kökenini kullanır
`/api/coin-icons` ve `/api/exchange-icons`, simge URL'lerini diğer tüm herkese açık uç noktalarla aynı köken olan `https://www.coinboss.com` üzerinde döndürür. Yollar (`/api/coin-icon/{coin}`, `/api/exchange-icon/{exchange}`) değişmemiştir.
Kullanım dışı2026.11.11Geriye dönük uyumlu
`/api/basis/list` ve `/api/cftc/cot` eski olarak işaretlendi
`/api/basis/list` yerine `/api/sd/basis/rank`, `/api/cftc/cot` yerine `/api/sd/cme/cot` uç noktasını kullanın. Eski uç noktalar çalışmaya devam eder.
Değiştirildi2026.11.11Geriye dönük uyumlu
`/api/liquidation-events` artık yalnızca CoinBoss kayıtlarını sunuyor
Liste, CoinBoss'un borsa akışlarından aldığı likidasyon emirlerinden oluşturulur. Geçmişi 2026-08-19'da başlar; daha önceki tarihler için satır dönmez.
Alan adları ve türleri değişmedi.
Kaldırıldı2026.11.11Geriye dönük uyumlu
Operasyonel uç noktalara artık internetten erişilemiyor
`/api/health/alerts`, `/api/health/server`, `/api/health/history` ve `/api/health/ch-read` herkese açık isteklere 404 yanıtı verir. Bunlar hiçbir zaman herkese açık API'nin parçası olmadı.
Servis durumu için `/api/meta/status`, veri güncelliği için `/api/meta/quality` uç noktasını kullanın.
Eklendi2026.11.11Geriye dönük uyumlu
Geliştirici merkezi ve makinece okunabilir API meta verileri
Yeni: `/api/meta/catalog`, `/api/meta/endpoint`, `/api/meta/status`, `/api/meta/quality`, `/api/meta/changelog` ve `/api/meta/openapi`.
Dokümantasyondaki alan tabloları ve örnek yanıtlar, herkese açık her uç noktayı 5 dakikada bir çağıran bir API yoklamasının aldığı gerçek yanıtlardan üretilir.
Uç nokta durumu (available / partial / degraded / down / unavailable) artık süreç durumundan değil, bu gerçek çağrılardan gelir.
Değiştirildi2026.11.11Geriye dönük uyumlu
Tek tip hata gövdesi ve istek kimlikleri
Her yanıt bir `X-Request-Id` başlığı taşır; hata gövdeleri bunu `request_id` olarak yineler.
Hata gövdeleri artık tüm uç noktalarda `{ success: false, code, error, request_id }` biçimindedir. `error` dize olarak kalır; dolayısıyla mevcut istemciler çalışmaya devam eder.
Bilinmeyen `/api/*` rotaları HTML sayfası yerine JSON 404 (`NOT_FOUND`) yanıtı verir.
HTTP 429 yanıtları `Retry-After` başlığını içerir.
5xx hatalarının mesajları geneldir; dahilî ayrıntılar artık yanıta yansıtılmaz.
Eklendi2026.11.11Geriye dönük uyumlu
CoinBoss'un kendi topladığı veri katmanının uç noktaları: her yanıtta kapsam ve kalite
Yeni: `/api/sd/oi`, `/api/sd/funding`, `/api/sd/liquidations`, `/api/sd/volume`, `/api/sd/ls`, `/api/sd/coin` ve `/api/sd/quality`.
Açık pozisyon; USDT / USDC / coin teminatlı / teslimatlı sözleşmeler için ayrı ayrı bildirilir ve hangi borsaların çift taraflı rakam bildirdiği belirtilir.
Fonlama; ham hâliyle, aralığıyla birlikte, 8h'ye normalize edilmiş ve yıllıklandırılmış olarak döndürülür; sözleşmesi canlı olmayan borsalar hariç tutulur ve listelenir.
Kullanım dışı2026.11.11Geriye dönük uyumlu
`/api/market/long-short` eski olarak işaretlendi
Liste görünümü için `/api/market/long-short-v2`, borsa bazında hesap / pozisyon / taker oranları için `/api/sd/ls` uç noktasını kullanın.
Değiştirildi2026.10.31Geriye dönük uyumlu
Simge alanları aynı kaynaklı (same-origin) yollar döndürüyor
`image_url` / `icon` gibi alanlar artık üçüncü taraf bir URL yerine bir CoinBoss yolu (`/api/coin-icon/...`) içerir.
Doğrulanmış simgesi olmayan bir coin `null` döndürür; istemciler kendi yer tutucularını göstermelidir.
Düzeltildi2026.10.24Geriye dönük uyumlu
Eskimiş satırlar artık toplu değerlere girmiyor
Açık pozisyon, fonlama ve long/short toplamları yalnızca güncellik penceresi içinde güncellenen satırları kullanır (günlük yayın yapan CME için pencere daha uzundur).
Listeden kaldırılan sözleşmeler, son güncellemeleri pencerenin dışına çıktığı anda toplamlara katkı yapmayı bırakır.
Eski uç noktalar
Uyumluluk için korunmaktadır. Çalışmaya devam ederler; yeni entegrasyonlar yerine geçen uç noktayı kullanmalıdır.
`apr_pct`, `basis_pct × 3 × 365` olarak hesaplanır; güncel sürekli vadeli bazının her 8 saatte bir ödeniyormuş gibi basitçe genellenmesidir, bir fonlama ya da teslimat getirisi değildir. `/api/sd/basis` işaret-endeks, spot-sürekli vadeli ve teslimatlı bazını ayrı ayrı bildirir.