/api/meta/quality
GETKullanılabilirFRESH

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.

GET/api/meta/quality

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
exchangestringİsteğe bağlı——Yalnızca bu borsayı döndürür (küçük harfli kimlik, örneğin `binance`).
familystringİ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.

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 (`coinboss.meta.quality/1`).
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
familiesarray—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[].idstring—Tanımlayıcı.
families[].scopestring—`matrix` içinde borsa bazında değerlendirilen aileler için `exchange`.
families[].titlestring—Ailenin görüntülenen başlığı.
families[].whatstring—Ailenin kapsadığı verinin kısa açıklaması.
families[].tablestring—Ailenin değerlendirildiği dahili veri kümesinin adı; yalnızca bilgi amaçlıdır.
families[].cadencestring—Ailenin düz metin toplama takvimi; belirtilmemişse null.
families[].fresh_within_snumbersGüncellik penceresi: bundan daha yeni veriler güncel sayılır.
exchangesarray—Borsalar.
exchanges[]string—Borsalar.
matrixobject—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.{*}.{*}.statusstring—Durum.
matrix.{*}.{*}.lag_snumber|nullsŞ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_atnumber|nullmsZaman damgası.
matrix.{*}.{*}.fetched_atnumber|nullmsCoinBoss'un veriyi kaynaktan getirdiği zaman.
matrix.{*}.{*}.fresh_within_snumber|nullsGüncellik penceresi: bundan daha yeni veriler güncel sayılır.
matrix.{*}.{*}.coverageobject|null—Nelerin dahil olduğu ve nelerin eksik olduğu.
matrix.{*}.{*}.coverage.rowsnumber—Sonuç satırları. bulunmayabilir
matrix.{*}.{*}.coverage.rows_freshnumber—Güncellik penceresi içinde güncellenen satırlar. bulunmayabilir
matrix.{*}.{*}.coverage.rows_usablenumber—Kullanılabilirlik penceresi içindeki satırlar. bulunmayabilir
matrix.{*}.{*}.coverage.rows_orphannumber—Sözleşmesi artık listelenmeyen satırlar. bulunmayabilir
matrix.{*}.{*}.coverage.rows_invalidnumber—Doğrulamada reddedilen satırlar. bulunmayabilir
matrix.{*}.{*}.reasonstring|null—Neden kodu.
matrix.{*}.{*}.coverage.rows_no_livenessnumbercountCanlı 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_intervalnumbercountUzlaşma aralığı bilinmediği için 8 saate normalize edilemeyen, yakın zamanda güncellenmiş fonlama satırları. bulunmayabilir
matrix.{*}.{*}.coverage.symbolsnumber—Semboller. bulunmayabilir
matrix.{*}.{*}.coverage.events_1hnumbercountSon bir saatte borsadan saklanan likidasyon emirleri; asgari emir büyüklükleri borsadan borsaya değişir. bulunmayabilir
matrix.{*}.{*}.coverage.events_24hnumbercountSon 24 saatte borsadan saklanan likidasyon emirleri; asgari emir büyüklükleri borsadan borsaya değişir. bulunmayabilir
matrix.{*}.{*}.viastring—Toplama yolu. bulunmayabilir
matrix.{*}.{*}.coverage.booksnumbercountİzlenen emir defteri sayısı. bulunmayabilir
matrix.{*}.{*}.coverage.books_freshnumbercountGüncellik penceresi içinde güncellenen emir defteri sayısı. bulunmayabilir
matrix.{*}.{*}.coverage.books_reaching_2pctnumbercountOrta fiyatın ±2 % çevresini kapsayacak kadar derin olan emir defteri sayısı. bulunmayabilir
matrix.{*}.{*}.coverage.contractsnumber—Sözleşme bazında satırlar. bulunmayabilir
matrix.{*}.{*}.coverage.contracts_freshnumbercountGüncellik penceresi içinde güncellenen sözleşme sayısı. bulunmayabilir
matrix.{*}.{*}.coverage.with_mark_and_indexnumbercountHem işaret fiyatı hem de endeks fiyatı bulunan sözleşme sayısı. bulunmayabilir
matrix.{*}.{*}.coverage.delivery_contractsnumbercountTeslimatlı (vadeli tarihli) sözleşme sayısı. bulunmayabilir
matrix.{*}.{*}.notestring—Not. bulunmayabilir
matrix.{*}.{*}.coverage.coinsnumber—Coinler. bulunmayabilir
matrix.{*}.{*}.coverage.rows_without_oinumbercountUSD cinsinden açık pozisyon değeri taşımayan coin teminatlı, USDC teminatlı veya teslimatlı sözleşme satırları. bulunmayabilir
matrix.{*}.{*}.coverage.with_mark_ivnumbercountİşaret zımni volatilitesi bulunan opsiyon sözleşmesi sayısı. bulunmayabilir
matrix.{*}.{*}.coverage.with_greeksnumbercountGreeks (Yunan harfleri) değerleri bulunan opsiyon sözleşmesi sayısı. bulunmayabilir
datasetsarray—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[].familystring—Veri kümesi kimliği; örneğin `etf` veya `cme`.
datasets[].idstring—Tanımlayıcı.
datasets[].titlestring—Veri kümesinin görüntülenen adı.
datasets[].sourcestring—Değerin nereden geldiği.
datasets[].endpointstring—Veri kümesini sunan herkese açık uç nokta.
datasets[].statusstring—Durum.
datasets[].lag_snumbersYanıt oluşturulduğu anda en yeni veri noktasının yaşı.
datasets[].source_atnumbermsZaman damgası.
datasets[].fetched_atnumbermsCoinBoss'un veriyi kaynaktan getirdiği zaman.
datasets[].fresh_within_snumbersGüncellik penceresi: bundan daha yeni veriler güncel sayılır.
datasets[].coverageobject—Nelerin dahil olduğu ve nelerin eksik olduğu.
datasets[].coverage.funds_totalnumbercountİzlenen fon sayısı. bulunmayabilir
datasets[].coverage.funds_coverednumbercountKullanılabilir bir açıklaması bulunan fon sayısı. bulunmayabilir
datasets[].coverage.funds_unavailablenumbercountİhraççısı makinece okunabilir bir açıklama yayımlamayan fon sayısı. bulunmayabilir
datasets[].coverage.funds_failingnumbercountSon toplama turunda açıklaması okunamayan fon sayısı. bulunmayabilir
datasets[].coverage.as_ofstring—Kapsanan fonlar arasındaki en yeni açıklama tarihi (YYYY-MM-DD). bulunmayabilir
datasets[].coverage.as_of_minstring—Kapsanan fonlar arasındaki en eski açıklama tarihi (YYYY-MM-DD). bulunmayabilir
datasets[].reasonstring|null—Neden kodu.
datasets[].coverage.contractsnumber—Sözleşme bazında satırlar. bulunmayabilir
datasets[].coverage.report_datestring—En yeni CFTC Commitments of Traders raporunun tarihi (YYYY-MM-DD). bulunmayabilir
datasets[].coverage.productsnumbercountKapsanan CME ürünü sayısı. bulunmayabilir
datasets[].coverage.trade_datestring—En yeni CME günlük raporunun işlem tarihi (YYYY-MM-DD). bulunmayabilir
summaryobject—Özet bloğu. dinamik anahtarlar: FRESH,PARTIAL,STALE,BROKEN,UNAVAILABLE
summary.{*}number—Özet bloğu.
by_familyobject—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.{*}.{*}numbercountO aile için o durumdaki borsa sayısı.
alertsarray—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[].levelstring—Seviye.
alerts[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
alerts[].familystring—Uyarının ilgili olduğu veri ailesi.
alerts[].codestring—Kod.
alerts[].detailstring—Ayrıntı.
alerts[].opened_atnumbermsZaman damgası.
alerts[].last_seen_atnumbermsZaman damgası.
alerts[].resolved_atnumber|nullmsZaman damgası.
alerts[].hitsnumbercountUyarı açıldığından bu yana koşulu gözlemleyen devriye çalışması (5 dakikada bir) sayısı.
alerts[].openboolean—Dönemin açılış fiyatı.
monitorobject—İ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_atnumbermsZaman damgası.
monitor.patrol_age_snumbersOlaydan bu yana geçen saniye.
monitor.patrol_okboolean—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_snumbersOlaydan bu yana geçen saniye.
errorsnull—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.
legendobject—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`).
methodobject—Formül / yöntem notları.
method.statusstring—Durum.
method.lag_sstring—`lag_s` değerinin nasıl hesaplandığına ilişkin düz metin ifade.
method.source_atstring—Tarih-saat dizesi.
method.fetched_atstring—Tarih-saat dizesi.
metaobject—Bu yanıtın zarfı: şema kimliği, üreten sistem, zaman damgaları, önbellek ömrü ve güncellik.
meta.schemastring—Bu yanıtın şema kimliği; üst düzeydeki `schema` ile aynı değer.
meta.sourcearray—Değerin nereden geldiği.
meta.source[]object—Değerin nereden geldiği.
meta.source[].systemstring—Veriyi üreten sistem; geliştirici merkezi uç noktaları için her zaman `coinboss`.
meta.source[].componentstring—Verinin arkasındaki bileşen: uç nokta yoklaması ve veri kalitesi devriyesi.
meta.observed_atnull—Zaman damgası.
meta.received_atnumbermsZaman damgası.
meta.fetched_atnumbermsCoinBoss'un veriyi kaynaktan getirdiği zaman.
meta.windowstring—Pencere.
meta.cache_ttl_snumbersBu yanıtın sunucu tarafı önbellek ömrü.
meta.qualitystring—Normalde `FRESH`; kalite devriyesi 15 dakika içinde çalışmadıysa `PARTIAL` (yalnızca uyarı listesi etkilenir).
meta.is_staleboolean—Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz.
meta.fallbackstring—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": [
      • { … 7 },
      • { … 7 }
      ],
    • "exchanges": [
      • "aster",
      • "backpack",
      • "binance",
      • "bingx",
      • "bitfinex",
      • "bitget",
      • "bitstamp",
      • "bitunix"
      ],
    • "matrix": {
      • "aster": { … 2 },
      • "backpack": { … 2 }
      },
    • "datasets": [
      • { … 12 },
      • { … 12 }
      ],
    • "summary": {
      • "FRESH": 161,
      • "PARTIAL": 7
      },
    • "by_family": {
      • "ticker": { … 2 },
      • "oi": { … 2 }
      },
    • "alerts": [
      • { … 10 },
      • { … 10 }
      ],
    • "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": [ … 1 ],
      • "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.

ParametrelerHTTPYanıt süresiSonuç
exchange=binance2001 msBaşarılı FRESH
family=funding2001 msBaş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

KullanılabilirKontrol: 2026-11-13 03:53:46 UTCHTTP 200887 msŞema eşleşiyorEn yeni veri noktası 0s öncesine ait

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ı →

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/meta/qualityKullanılabilir
Parametreler

string — Return only this exchange (lower-case id, for example `binance`).

string — Return only this data family (for example `oi`, `funding`, `liquidation`).

İstek URL'sihttps://www.coinboss.com/api/meta/quality
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.