Veri kalitesi matrisi
FRESH / PARTIAL / STALE / BROKEN / UNAVAILABLE dereceleriyle borsa × veri ailesi matrisi; kaynak ve çekme zaman damgaları, gecikme, kapsam ve her boşluğun nedeni.
/api/meta/qualityİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| exchange | string | İsteğe bağlı | — | — | Yalnızca bu borsayı döndürür (küçük harfli kimlik, örneğin `binance`). |
| family | string | İsteğe bağlı | — | — | Yalnızca bu veri ailesini döndürür (örneğin `oi`, `funding`, `liquidation`). |
Örnek istek
curl -s "https://www.coinboss.com/api/meta/quality"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 (`coinboss.meta.quality/1`). |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| families | array | — | Borsa bazında değerlendirilen veri aileleri (ticker'lar, açık pozisyon, fonlama, likidasyonlar, emir defterleri, opsiyonlar ve diğerleri). |
| families[] | object | — | Tek bir aile: `id`, `scope`, `title`, `what`, `table`, `cadence` ve `fresh_within_s`. |
| families[].id | string | — | Tanımlayıcı. |
| families[].scope | string | — | `matrix` içinde borsa bazında değerlendirilen aileler için `exchange`. |
| families[].title | string | — | Ailenin görüntülenen başlığı. |
| families[].what | string | — | Ailenin kapsadığı verinin kısa açıklaması. |
| families[].table | string | — | Ailenin değerlendirildiği dahili veri kümesinin adı; yalnızca bilgi amaçlıdır. |
| families[].cadence | string | — | Ailenin düz metin toplama takvimi; belirtilmemişse null. |
| families[].fresh_within_s | number | s | Güncellik penceresi: bundan daha yeni veriler güncel sayılır. |
| exchanges | array | — | Borsalar. |
| exchanges[] | string | — | Borsalar. |
| matrix | object | — | Satır ve sütuna göre anahtarlanan matris. dinamik anahtarlar: aster,backpack,binance,bingx,bitfinex,bitget |
| matrix.{*} | object | — | Satır ve sütuna göre anahtarlanan matris. dinamik anahtarlar: ticker,oi,funding,funding_settle,liquidation,ls |
| matrix.{*}.{*} | object | — | Satır ve sütuna göre anahtarlanan matris. |
| matrix.{*}.{*}.status | string | — | Durum. |
| matrix.{*}.{*}.lag_s | number|null | s | Şimdiki zaman eksi o borsanın (ilk anahtar) ve ailenin (ikinci anahtar) saklanan en yeni veri zaman damgası; aile orada kullanılamıyorsa null. |
| matrix.{*}.{*}.source_at | number|null | ms | Zaman damgası. |
| matrix.{*}.{*}.fetched_at | number|null | ms | CoinBoss'un veriyi kaynaktan getirdiği zaman. |
| matrix.{*}.{*}.fresh_within_s | number|null | s | Güncellik penceresi: bundan daha yeni veriler güncel sayılır. |
| matrix.{*}.{*}.coverage | object|null | — | Nelerin dahil olduğu ve nelerin eksik olduğu. |
| matrix.{*}.{*}.coverage.rows | number | — | Sonuç satırları. bulunmayabilir |
| matrix.{*}.{*}.coverage.rows_fresh | number | — | Güncellik penceresi içinde güncellenen satırlar. bulunmayabilir |
| matrix.{*}.{*}.coverage.rows_usable | number | — | Kullanılabilirlik penceresi içindeki satırlar. bulunmayabilir |
| matrix.{*}.{*}.coverage.rows_orphan | number | — | Sözleşmesi artık listelenmeyen satırlar. bulunmayabilir |
| matrix.{*}.{*}.coverage.rows_invalid | number | — | Doğrulamada reddedilen satırlar. bulunmayabilir |
| matrix.{*}.{*}.reason | string|null | — | Neden kodu. |
| matrix.{*}.{*}.coverage.rows_no_liveness | number | count | Canlı işlem kanıtı bulunmayan (listeden kaldırılmış veya hacimsiz) sözleşmelere ait fonlama satırları; güncellik sayımının dışında bırakılır. bulunmayabilir |
| matrix.{*}.{*}.coverage.rows_unknown_interval | number | count | Uzlaşma aralığı bilinmediği için 8 saate normalize edilemeyen, yakın zamanda güncellenmiş fonlama satırları. bulunmayabilir |
| matrix.{*}.{*}.coverage.symbols | number | — | Semboller. bulunmayabilir |
| matrix.{*}.{*}.coverage.events_1h | number | count | Son bir saatte borsadan saklanan likidasyon emirleri; asgari emir büyüklükleri borsadan borsaya değişir. bulunmayabilir |
| matrix.{*}.{*}.coverage.events_24h | number | count | Son 24 saatte borsadan saklanan likidasyon emirleri; asgari emir büyüklükleri borsadan borsaya değişir. bulunmayabilir |
| matrix.{*}.{*}.via | string | — | Toplama yolu. bulunmayabilir |
| matrix.{*}.{*}.coverage.books | number | count | İzlenen emir defteri sayısı. bulunmayabilir |
| matrix.{*}.{*}.coverage.books_fresh | number | count | Güncellik penceresi içinde güncellenen emir defteri sayısı. bulunmayabilir |
| matrix.{*}.{*}.coverage.books_reaching_2pct | number | count | Orta fiyatın ±2 % çevresini kapsayacak kadar derin olan emir defteri sayısı. bulunmayabilir |
| matrix.{*}.{*}.coverage.contracts | number | — | Sözleşme bazında satırlar. bulunmayabilir |
| matrix.{*}.{*}.coverage.contracts_fresh | number | count | Güncellik penceresi içinde güncellenen sözleşme sayısı. bulunmayabilir |
| matrix.{*}.{*}.coverage.with_mark_and_index | number | count | Hem işaret fiyatı hem de endeks fiyatı bulunan sözleşme sayısı. bulunmayabilir |
| matrix.{*}.{*}.coverage.delivery_contracts | number | count | Teslimatlı (vadeli tarihli) sözleşme sayısı. bulunmayabilir |
| matrix.{*}.{*}.note | string | — | Not. bulunmayabilir |
| matrix.{*}.{*}.coverage.coins | number | — | Coinler. bulunmayabilir |
| matrix.{*}.{*}.coverage.rows_without_oi | number | count | USD cinsinden açık pozisyon değeri taşımayan coin teminatlı, USDC teminatlı veya teslimatlı sözleşme satırları. bulunmayabilir |
| matrix.{*}.{*}.coverage.with_mark_iv | number | count | İşaret zımni volatilitesi bulunan opsiyon sözleşmesi sayısı. bulunmayabilir |
| matrix.{*}.{*}.coverage.with_greeks | number | count | Greeks (Yunan harfleri) değerleri bulunan opsiyon sözleşmesi sayısı. bulunmayabilir |
| datasets | array | — | Borsa bazında olmayan veri kümelerinin (örneğin spot ETF ve CME günlük verileri) kalite kontrolleri; her biri durum, gecikme, kapsam ve nedeniyle birlikte. |
| datasets[] | object | — | Tek bir borsaya bağlı olmayan, piyasa geneli tek bir veri kümesi (opsiyonlar, spot ETF'ler, CME, emir defterleri, baz). |
| datasets[].family | string | — | Veri kümesi kimliği; örneğin `etf` veya `cme`. |
| datasets[].id | string | — | Tanımlayıcı. |
| datasets[].title | string | — | Veri kümesinin görüntülenen adı. |
| datasets[].source | string | — | Değerin nereden geldiği. |
| datasets[].endpoint | string | — | Veri kümesini sunan herkese açık uç nokta. |
| datasets[].status | string | — | Durum. |
| datasets[].lag_s | number | s | Yanıt oluşturulduğu anda en yeni veri noktasının yaşı. |
| datasets[].source_at | number | ms | Zaman damgası. |
| datasets[].fetched_at | number | ms | CoinBoss'un veriyi kaynaktan getirdiği zaman. |
| datasets[].fresh_within_s | number | s | Güncellik penceresi: bundan daha yeni veriler güncel sayılır. |
| datasets[].coverage | object | — | Nelerin dahil olduğu ve nelerin eksik olduğu. |
| datasets[].coverage.funds_total | number | count | İzlenen fon sayısı. bulunmayabilir |
| datasets[].coverage.funds_covered | number | count | Kullanılabilir bir açıklaması bulunan fon sayısı. bulunmayabilir |
| datasets[].coverage.funds_unavailable | number | count | İhraççısı makinece okunabilir bir açıklama yayımlamayan fon sayısı. bulunmayabilir |
| datasets[].coverage.funds_failing | number | count | Son toplama turunda açıklaması okunamayan fon sayısı. bulunmayabilir |
| datasets[].coverage.as_of | string | — | Kapsanan fonlar arasındaki en yeni açıklama tarihi (YYYY-MM-DD). bulunmayabilir |
| datasets[].coverage.as_of_min | string | — | Kapsanan fonlar arasındaki en eski açıklama tarihi (YYYY-MM-DD). bulunmayabilir |
| datasets[].reason | string|null | — | Neden kodu. |
| datasets[].coverage.contracts | number | — | Sözleşme bazında satırlar. bulunmayabilir |
| datasets[].coverage.report_date | string | — | En yeni CFTC Commitments of Traders raporunun tarihi (YYYY-MM-DD). bulunmayabilir |
| datasets[].coverage.products | number | count | Kapsanan CME ürünü sayısı. bulunmayabilir |
| datasets[].coverage.trade_date | string | — | En yeni CME günlük raporunun işlem tarihi (YYYY-MM-DD). bulunmayabilir |
| summary | object | — | Özet bloğu. dinamik anahtarlar: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE |
| summary.{*} | number | — | Özet bloğu. |
| by_family | object | — | Aile bazında, her durumdaki borsa sayısı. Dış anahtarlar aile kimlikleridir. dinamik anahtarlar: ticker,oi,funding,funding_settle,liquidation,ls |
| by_family.{*} | object | — | Tek bir ailenin durum sayıları; duruma göre anahtarlanır (`FRESH`, `PARTIAL`, `STALE`, `BROKEN`, `UNAVAILABLE`). dinamik anahtarlar: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE |
| by_family.{*}.{*} | number | count | O aile için o durumdaki borsa sayısı. |
| alerts | array | — | Veri kalitesi devriyesinin açık olan veya son 7 günde çözülen uyarıları, açık olanlar başta; istek parametrelerine göre filtrelenir. |
| alerts[] | object | — | Tek bir uyarı: `level`, `exchange`, `family`, `code`, `detail`, açılış / son görülme / çözülme zamanları, `hits` ve `open`. |
| alerts[].level | string | — | Seviye. |
| alerts[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| alerts[].family | string | — | Uyarının ilgili olduğu veri ailesi. |
| alerts[].code | string | — | Kod. |
| alerts[].detail | string | — | Ayrıntı. |
| alerts[].opened_at | number | ms | Zaman damgası. |
| alerts[].last_seen_at | number | ms | Zaman damgası. |
| alerts[].resolved_at | number|null | ms | Zaman damgası. |
| alerts[].hits | number | count | Uyarı açıldığından bu yana koşulu gözlemleyen devriye çalışması (5 dakikada bir) sayısı. |
| alerts[].open | boolean | — | Dönemin açılış fiyatı. |
| monitor | object | — | İzlemenin kendi sağlığı: son devriye çalışmasının zamanı ve yaşı, `patrol_ok` ve toplayıcı kalp atışının yaşı. |
| monitor.patrol_last_run_at | number | ms | Zaman damgası. |
| monitor.patrol_age_s | number | s | Olaydan bu yana geçen saniye. |
| monitor.patrol_ok | boolean | — | Devriye son 15 dakika içinde çalıştıysa true; false olduğunda `alerts` listesi güncel olmayabilir, matris ise canlı kalır. |
| monitor.collector_heartbeat_age_s | number | s | Olaydan bu yana geçen saniye. |
| errors | null | — | Kalite kontrolünün kendisi başarısız olan aileler için aile kimliğinden hata koduna eşleme; tüm kontroller çalıştıysa null. |
| legend | object | — | Her hücre durumunun düz metin tanımı. dinamik anahtarlar: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE |
| legend.{*} | string | — | Anahtarın belirttiği durumun tanımı (`FRESH`, `PARTIAL`, `STALE`, `BROKEN`, `UNAVAILABLE`). |
| method | object | — | Formül / yöntem notları. |
| method.status | string | — | Durum. |
| method.lag_s | string | — | `lag_s` değerinin nasıl hesaplandığına ilişkin düz metin ifade. |
| method.source_at | string | — | Tarih-saat dizesi. |
| method.fetched_at | string | — | Tarih-saat dizesi. |
| meta | object | — | Bu yanıtın zarfı: şema kimliği, üreten sistem, zaman damgaları, önbellek ömrü ve güncellik. |
| meta.schema | string | — | Bu yanıtın şema kimliği; üst düzeydeki `schema` ile aynı değer. |
| meta.source | array | — | Değerin nereden geldiği. |
| meta.source[] | object | — | Değerin nereden geldiği. |
| meta.source[].system | string | — | Veriyi üreten sistem; geliştirici merkezi uç noktaları için her zaman `coinboss`. |
| meta.source[].component | string | — | Verinin arkasındaki bileşen: uç nokta yoklaması ve veri kalitesi devriyesi. |
| meta.observed_at | null | — | Zaman damgası. |
| meta.received_at | number | ms | Zaman damgası. |
| meta.fetched_at | number | ms | CoinBoss'un veriyi kaynaktan getirdiği zaman. |
| meta.window | string | — | Pencere. |
| meta.cache_ttl_s | number | s | Bu yanıtın sunucu tarafı önbellek ömrü. |
| meta.quality | string | — | Normalde `FRESH`; kalite devriyesi 15 dakika içinde çalışmadıysa `PARTIAL` (yalnızca uyarı listesi etkilenir). |
| meta.is_stale | boolean | — | Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz. |
| meta.fallback | string | — | Girdileri eskimiş veya eksik olduğunda bu uç noktanın ne döndürdüğüne ilişkin düz metin not. |
Üretilme zamanı: 2026-11-11 23:01 UTC; kaynak: 3 gerçek yanıt.
Örnek yanıt
/api/meta/quality · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:53:46 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: alerts: 11 öğe içeriyordu; legend: 5 öğe içeriyordu; matrix: 30 öğe içeriyordu; summary: 5 öğe içeriyordu; datasets: 12 öğe içeriyordu; families: 12 öğe içeriyordu.
- "success"true
- "schema""coinboss.meta.quality/1"
- "now"1794542026126
- "families"
- "exchanges"
- "aster"
- "backpack"
- "binance"
- "bingx"
- "bitfinex"
- "bitget"
- "bitstamp"
- "bitunix"
- "matrix"
- "aster"
- "backpack"
- "datasets"
- "summary"
- "FRESH"161
- "PARTIAL"7
- "by_family"
- "ticker"
- "oi"
- "alerts"
- "monitor"
- "patrol_last_run_at"1794541745827
- "patrol_age_s"281
- "patrol_ok"true
- "collector_heartbeat_age_s"36
- "errors"null
- "legend"
- "FRESH""newest stored data point is inside the fresh window for this family"
- "PARTIAL""some contracts / rows are outside the fresh window or miss a required field"
- "method"
- "status""judged from data timestamps in CoinBoss storage every request (30 s in-process cache); a running collector process is not treated as evidence"
- "lag_s""now − newest stored data timestamp for the exchange / family"
- "source_at""newest stored data timestamp (exchange timestamp when the exchange provides one, otherwise collector receive time)"
- "fetched_at""last successful upstream call recorded by the collector health log; null for WebSocket feeds and collectors that do not log per-call health"
- "meta"
- "schema""coinboss.meta.quality/1"
- "source"
- "observed_at"null
- "received_at"1794542026978
- "fetched_at"1794542026126
- "window""latest"
- "cache_ttl_s"20
- "quality""FRESH"
- "is_stale"false
- "fallback""matrix is always computed from storage; when the 5-minute patrol itself stops (monitor.patrol_ok=false) only the alerts list may be outdated"
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ç |
|---|---|---|---|
| exchange=binance | 200 | 1 ms | Başarılı FRESH |
| family=funding | 200 | 1 ms | Başarılı FRESH |
Kontrol: 2026-11-13 03:29:27 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
- 20s
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- İstek anında her borsa × veri ailesi çiftinin en yeni veri zaman damgasından değerlendirilir.
- Veri kaynakları
- CoinBoss ham tabloları (en son satırın zaman damgaları), toplayıcı sağlık günlüğü. Çalışan bir süreç asla sağlıklı veri sayılmaz.
- 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
Erişilebilirlik, son 30 gün
407 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ı →
| 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
/api/meta/qualityKullanılabilirstring — Return only this exchange (lower-case id, for example `binance`).
string — Return only this data family (for example `oi`, `funding`, `liquidation`).
https://www.coinboss.com/api/meta/qualityBu kategoride daha fazlası
- Veri kalitesi matrisi (toplayıcı görünümü) /api/sd/quality
- API kataloğu /api/meta/catalog
- Değişiklik günlüğü ve sürümleme politikası /api/meta/changelog
- Uç nokta dokümantasyonu /api/meta/endpoint
- OpenAPI belgesi /api/meta/openapi
- Veri kalitesi matrisi /api/meta/quality
- Servis durumu /api/meta/status
- Bir coin sembolünün platformda tanımlı olup olmadığını kontrol eder /api/coin-exists
- Coin sembolünden yerel olarak barındırılan simge yoluna eşleme /api/coin-icons
- Coin sayfası toplu özeti /api/content/coin
- Site geneli bölüm özeti /api/content/summary
- İtibari para döviz kuru tablosu /api/currency/fx
- Borsa kimliğinden yerel olarak barındırılan simge yoluna eşleme /api/exchange-icons
- Canlılık kontrolü /api/health
- Araştırma sayfası istatistikleri /api/research/stats