/api/meta/status
GETKullanılabilirFRESH

Servis durumu

Genel durum, API sunucu örnekleri ve veri depoları, hata veren uç noktalar, yanıt süresi yüzdelikleri, 30 günlük erişilebilirlik, veri ailesi bazında toplayıcı sağlığı ve açık olaylar.

GET/api/meta/status

İstek

Bu uç nokta parametre almaz.

Örnek istek

curl -s "https://www.coinboss.com/api/meta/status"

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.status/1`).
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
overallstring—Genel hizmet durumu: `operational`, `degraded`, `partial_outage`, `major_outage` veya `unknown`; bkz. `legend`.
api_versionstring—Herkese açık API'nin sürümü (`v1`).
catalog_versionstring—Uç nokta kataloğunun sürümü; `2026.11.11` gibi bir yayın tarihi.
componentsarray—Durumlarıyla birlikte hizmet bileşenleri: REST API, WebSocket akışı, veritabanı, önbellek, zaman serisi deposu, uç nokta yoklaması ve veri toplama.
components[]object—Tek bir bileşen: `id`, `title`, `status` ve alanları bileşene göre değişen bir `detail` nesnesi.
components[].idstring—Tanımlayıcı.
components[].titlestring—Bileşenin görüntülenen adı.
components[].statusstring—Durum.
components[].detailobject—Ayrıntı.
components[].detail.instances_healthynumbercountSağlık kontrolüne az önce yanıt veren API sunucu örnekleri. bulunmayabilir
components[].detail.instances_totalnumbercountKontrol edilen API sunucu örnekleri. bulunmayabilir
components[].detail.health_latency_msnumbermsAPI örnekleri arasındaki en yavaş sağlık kontrolü yanıtı. bulunmayabilir
components[].detail.last_check_atnumbermsZaman damgası. bulunmayabilir
components[].detail.first_frame_msnumbermsSon yoklamada WebSocket akışına bağlanmaktan ilk çerçevenin gelmesine kadar geçen süre; yoklanmadıysa null. bulunmayabilir
components[].detail.ping_msnumbermsBileşene (veritabanı, önbellek veya zaman serisi deposu) gönderilen basit bir sorgunun gidiş-dönüş süresi; API ana makinesinden ölçülür. bulunmayabilir
components[].detail.notenull—Not. bulunmayabilir
components[].detail.last_run_atnumbermsZaman damgası. bulunmayabilir
components[].detail.age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye. bulunmayabilir
components[].detail.interval_snumbersİki yoklama çalışması arasındaki planlanan aralık (300). bulunmayabilir
components[].detail.took_msnumbermsTamamlanan son yoklama çalışmasının süresi; kaydedilmediyse null. bulunmayabilir
components[].detail.families_totalnumbercountVeri toplama açısından değerlendirilen veri ailesi sayısı. bulunmayabilir
components[].detail.families_degradednumbercountToplama durumu `degraded` veya `outage` olan veri ailesi sayısı. bulunmayabilir
components[].detail.judged_bystring—Durumun hangi zaman damgasına göre değerlendirildiği. bulunmayabilir
endpointsobject—Her canlı durumdaki belgelenen uç nokta sayısı ve hata verenlerin listesi.
endpoints.totalnumber—Toplam.
endpoints.availablenumber—Verinin mevcut olup olmadığı.
endpoints.partialnumber—Beklenen verinin yalnızca bir kısmı mevcutsa true.
endpoints.degradednumbercountCanlı durumu `degraded` olan uç nokta sayısı.
endpoints.downnumbercountCanlı durumu `down` olan uç nokta sayısı.
endpoints.unavailablenumber—Verisi bulunmayan öğeler, nedenleriyle birlikte. Hiçbir zaman 0 olarak bildirilmez.
endpoints.unknownnumbercountCanlı durumu `unknown` olan (yakın tarihli yoklama sonucu bulunmayan) uç nokta sayısı.
endpoints.failingarray—Şu anda `down` veya `degraded` durumundaki uç noktalar; her biri `id`, `path`, `status`, `reason`, son HTTP durumu, son başarı zamanı ve art arda başarısızlık sayısıyla birlikte.
endpoints.failing[]object—Şu anda çalışmayan veya bozulmuş durumdaki tek bir uç nokta.
endpoints.failing[].idstring—Tanımlayıcı.
endpoints.failing[].pathstring—Uç nokta yolu.
endpoints.failing[].statusstring—Durum.
endpoints.failing[].reasonstring—Neden kodu.
endpoints.failing[].httpnumber—Son yoklamanın HTTP durumu; hiç yoklanmadıysa `null`.
endpoints.failing[].last_ok_atnumbermsZaman damgası.
endpoints.failing[].fail_streaknumbercountArt arda başarısız yoklama sayısı.
latency_msobject—Her uç noktanın en son başarılı yoklama çağrısının yanıt süresi dağılımı; API ana makinesinde ölçülür.
latency_ms.p50numbermsUç noktalar genelindeki medyan yanıt süresi; güncel örnek yoksa null.
latency_ms.p95numbermsUç noktalar genelindeki 95. yüzdelik yanıt süresi; güncel örnek yoksa null.
latency_ms.maxnumber—Maksimum.
latency_ms.samplenumbercountYanıt süresi rakamlarına dahil edilen uç nokta sayısı.
latency_ms.measuredstring—Yanıt süresinin nerede ölçüldüğüne ilişkin düz metin not: sunucu tarafında, ağ aktarım süresi hariç.
uptimeobject—Pencere boyunca tüm uç noktaların toplu yoklama kontrolleri: toplamlar, başarı yüzdesi ve gün bazında dağılım.
uptime.window_daysnumberdaysErişilebilirlik penceresinin uzunluğu (30).
uptime.checksnumbercountPenceredeki yoklama kontrolü sayısı, tüm uç noktalar birlikte.
uptime.oknumbercountBu kontrollerden başarılı olanların sayısı.
uptime.pctnumber%Yüzde.
uptime.tracking_sincestring—Pencere içinde yoklama verisi bulunan ilk gün, `YYYY-MM-DD`; henüz veri yoksa null.
uptime.daysarray—Günlük değerler veya gün sayısı.
uptime.days[]object—Günlük değerler veya gün sayısı.
uptime.days[].daystring—Takvim günü (UTC).
uptime.days[].checksnumbercountO günkü yoklama isteği sayısı.
uptime.days[].oknumbercountO günkü başarılı yoklama isteği sayısı.
uptime.days[].pctnumber%Yüzde.
uptime.days[].schema_pctnumber%O gün yoklanan yanıtlardan belgelenen alan tablosuyla eşleşenlerin payı.
uptime.days[].avg_msnumbermsO günkü ortalama yanıt süresi.
collectorsobject—Borsa verisi toplamanın durumu; depodaki veri zaman damgalarından değerlendirilir: aile bazında sayılar, veri kümesi kontrolleri ve devriye sağlığı. Değerlendirilemiyorsa null.
collectors.familiesarray—Veri ailesi bazında toplama durumu.
collectors.families[]object—Tek bir aile: `family`, `title`, her durumdaki borsa sayısı ve bunlardan çıkan `status`.
collectors.families[].familystring—Aile kimliği; örneğin `ticker`, `oi`, `funding`, `liquidation`, `options`.
collectors.families[].titlestring—Ailenin görüntülenen başlığı.
collectors.families[].exchanges_collectednumbercountAilenin toplandığı borsalar: güncel + kısmi + eskimiş + bozuk.
collectors.families[].freshnumbercountAileye ait en yeni verisi güncellik penceresinin içinde olan borsalar.
collectors.families[].partialnumber—Beklenen verinin yalnızca bir kısmı mevcutsa true.
collectors.families[].stalenumber—Güncellik penceresinden daha eski veriler için satırlar veya bayrak.
collectors.families[].brokennumbercountAile için veri kaynağı sürekli hata veren veya satırlarının çoğu tutarlılık kontrollerinden geçemeyen borsalar.
collectors.families[].unavailablenumber—Verisi bulunmayan öğeler, nedenleriyle birlikte. Hiçbir zaman 0 olarak bildirilmez.
collectors.families[].statusstring—Durum.
collectors.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.
collectors.datasets[]object—Tek bir borsaya bağlı olmayan, piyasa geneli tek bir veri kümesi (opsiyonlar, spot ETF'ler, CME, emir defterleri, baz).
collectors.datasets[].familystring—Veri kümesi kimliği; örneğin `etf` veya `cme`.
collectors.datasets[].idstring—Tanımlayıcı.
collectors.datasets[].titlestring—Veri kümesinin görüntülenen adı.
collectors.datasets[].sourcestring—Değerin nereden geldiği.
collectors.datasets[].endpointstring—Veri kümesini sunan herkese açık uç nokta.
collectors.datasets[].statusstring—Durum.
collectors.datasets[].lag_snumbersYanıt oluşturulduğu anda en yeni veri noktasının yaşı.
collectors.datasets[].source_atnumbermsZaman damgası.
collectors.datasets[].fetched_atnumbermsCoinBoss'un veriyi kaynaktan getirdiği zaman.
collectors.datasets[].fresh_within_snumbersGüncellik penceresi: bundan daha yeni veriler güncel sayılır.
collectors.datasets[].coverageobject—Nelerin dahil olduğu ve nelerin eksik olduğu.
collectors.datasets[].coverage.funds_totalnumbercountİzlenen fon sayısı. bulunmayabilir
collectors.datasets[].coverage.funds_coverednumbercountKullanılabilir bir açıklaması bulunan fon sayısı. bulunmayabilir
collectors.datasets[].coverage.funds_unavailablenumbercountİhraççısı makinece okunabilir bir açıklama yayımlamayan fon sayısı. bulunmayabilir
collectors.datasets[].coverage.funds_failingnumbercountSon toplama turunda açıklaması okunamayan fon sayısı. bulunmayabilir
collectors.datasets[].coverage.as_ofstring—Kapsanan fonlar arasındaki en yeni açıklama tarihi (YYYY-MM-DD). bulunmayabilir
collectors.datasets[].coverage.as_of_minstring—Kapsanan fonlar arasındaki en eski açıklama tarihi (YYYY-MM-DD). bulunmayabilir
collectors.datasets[].reasonstring|null—Neden kodu.
collectors.datasets[].coverage.contractsnumber—Sözleşme bazında satırlar. bulunmayabilir
collectors.datasets[].coverage.report_datestring—En yeni CFTC Commitments of Traders raporunun tarihi (YYYY-MM-DD). bulunmayabilir
collectors.datasets[].coverage.productsnumbercountKapsanan CME ürünü sayısı. bulunmayabilir
collectors.datasets[].coverage.trade_datestring—En yeni CME günlük raporunun işlem tarihi (YYYY-MM-DD). bulunmayabilir
collectors.patrol_okboolean—Veri kalitesi devriyesi son 15 dakika içinde çalıştıysa true.
collectors.patrol_age_snumbersOlaydan bu yana geçen saniye.
collectors.evaluated_atnumbermsZaman damgası.
incidentsobject—Açık olan veya son 7 günde çözülen veri kalitesi uyarıları: `open` sayısı ve `items` (en çok 100).
incidents.opennumber—Dönemin açılış fiyatı.
incidents.itemsarray—Sonuç öğeleri.
incidents.items[]object—Sonuç öğeleri.
incidents.items[].levelstring—Seviye.
incidents.items[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
incidents.items[].familystring—Uyarının ilgili olduğu veri ailesi.
incidents.items[].codestring—Kod.
incidents.items[].detailstring—Ayrıntı.
incidents.items[].opened_atnumbermsZaman damgası.
incidents.items[].last_seen_atnumbermsZaman damgası.
incidents.items[].resolved_atnumber|nullmsZaman damgası.
incidents.items[].hitsnumbercountUyarı açıldığından bu yana koşulu gözlemleyen devriye çalışması (5 dakikada bir) sayısı.
incidents.items[].openboolean—Dönemin açılış fiyatı.
probeobject—Canlı durumların dayandığı uç nokta yoklamasının durumu: son çalışma zamanı, yaşı, aralığı ve güncel olup olmadığı.
probe.last_run_atnumbermsZaman damgası.
probe.age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye.
probe.interval_snumbersİki yoklama çalışması arasındaki planlanan aralık (300).
probe.freshboolean—Son yoklama çalışması 20 dakikadan yeniyse true; false olduğunda uç nokta durumları `unknown` olarak bildirilir.
probe.errornull—Hata mesajı (yalnızca başarısızlık durumunda bulunur).
probe.endpoints_checkednumbercountSon yoklama turunda kontrol edilen uç nokta sayısı.
probe.oknumbercountSon yoklama turunda doğru yanıt veren uç nokta sayısı.
probe.failednumbercountSon yoklama turunda başarısız olan uç nokta sayısı.
probe.schema_mismatchnumbercountYanıtı belgelenen alan tablosuyla eşleşmeyen uç nokta sayısı.
probe.alt_samples_failednullcountBaşarısız olan ek örnek istek sayısı; son turda bunlar çalıştırılmadıysa `null`.
legendobject—`overall` alanının her değerinin düz metin tanımı.
legend.operationalstring—`operational` tanımı.
legend.degradedstring—`degraded` tanımı.
legend.partial_outagestring—`partial_outage` tanımı.
legend.major_outagestring—`major_outage` tanımı.
legend.unknownstring—`unknown` tanımı.
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—Uç nokta yoklaması son 20 dakika içinde rapor verdiyse `FRESH`, aksi hâlde `STALE`.
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: 1 gerçek yanıt.

Örnek yanıt

/api/meta/status · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:53:47 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: components: 7 öğe içeriyordu; uptime.days: 3 öğe içeriyordu; incidents.items: 11 öğe içeriyordu; endpoints.failing: 25 öğe içeriyordu; collectors.datasets: 12 öğe içeriyordu; collectors.families: 12 öğe içeriyordu.

  • {
    • "success": true,
    • "schema": "coinboss.meta.status/1",
    • "now": 1794542027137,
    • "overall": "partial_outage",
    • "api_version": "v1",
    • "catalog_version": "2026.11.12",
    • "components": [
      • { … 4 },
      • { … 4 }
      ],
    • "endpoints": {
      • "total": 299,
      • "available": 256,
      • "partial": 17,
      • "degraded": 17,
      • "down": 8,
      • "unavailable": 1,
      • "unknown": 0,
      • "failing": [ … 2 ]
      },
    • "latency_ms": {
      • "p50": 7,
      • "p95": 839,
      • "max": 10047,
      • "sample": 289,
      • "measured": "server-side, from the probe on the API host (excludes network transit)"
      },
    • "uptime": {
      • "window_days": 30,
      • "checks": 119504,
      • "ok": 118277,
      • "pct": 98.97,
      • "tracking_since": "2026-11-11",
      • "days": [ … 2 ]
      },
    • "collectors": {
      • "families": [ … 2 ],
      • "datasets": [ … 2 ],
      • "patrol_ok": true,
      • "patrol_age_s": 282,
      • "evaluated_at": 1794542027976
      },
    • "incidents": {
      • "open": 2,
      • "items": [ … 2 ]
      },
    • "probe": {
      • "last_run_at": 1794541726312,
      • "age_s": 301,
      • "interval_s": 300,
      • "fresh": true,
      • "error": null,
      • "endpoints_checked": 290,
      • "ok": 289,
      • "failed": 1,
      • "schema_mismatch": 0,
      • "alt_samples_failed": null
      },
    • "legend": {
      • "operational": "all checks pass",
      • "degraded": "serving, with stale data, schema drift or reduced redundancy",
      • "partial_outage": "at least one endpoint or API instance is failing",
      • "major_outage": "database down, no API instance healthy, or 20%+ of endpoints failing",
      • "unknown": "the probe has not reported within 20 minutes — status cannot be asserted"
      },
    • "meta": {
      • "schema": "coinboss.meta.status/1",
      • "source": [ … 1 ],
      • "observed_at": null,
      • "received_at": 1794541726312,
      • "fetched_at": 1794542027137,
      • "window": "latest",
      • "cache_ttl_s": 15,
      • "quality": "FRESH",
      • "is_stale": false,
      • "fallback": "status is \"unknown\" whenever the probe is stale; process liveness is never used as evidence"
      }
    }

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
15s
Edge mikro önbelleği
10s
Güncelleme sıklığı
İstek anında değerlendirilir; uç nokta sonuçları 5 dakikalık API yoklamasından, toplayıcı sağlığı ise veri zaman damgalarından gelir.
Veri kaynakları
API yoklama sonuçları, sunucu örneği başına sağlık kontrolleri, veri kalitesi matrisi, uyarı günlüğü.
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:47 UTCHTTP 200872 msŞema eşleşiyorEn yeni veri noktası 5m öncesine ait

Erişilebilirlik, son 30 gün

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

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

Parametre yok.

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