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.
/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.
| 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.status/1`). |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| overall | string | — | Genel hizmet durumu: `operational`, `degraded`, `partial_outage`, `major_outage` veya `unknown`; bkz. `legend`. |
| api_version | string | — | Herkese açık API'nin sürümü (`v1`). |
| catalog_version | string | — | Uç nokta kataloğunun sürümü; `2026.11.11` gibi bir yayın tarihi. |
| components | array | — | 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[].id | string | — | Tanımlayıcı. |
| components[].title | string | — | Bileşenin görüntülenen adı. |
| components[].status | string | — | Durum. |
| components[].detail | object | — | Ayrıntı. |
| components[].detail.instances_healthy | number | count | Sağlık kontrolüne az önce yanıt veren API sunucu örnekleri. bulunmayabilir |
| components[].detail.instances_total | number | count | Kontrol edilen API sunucu örnekleri. bulunmayabilir |
| components[].detail.health_latency_ms | number | ms | API örnekleri arasındaki en yavaş sağlık kontrolü yanıtı. bulunmayabilir |
| components[].detail.last_check_at | number | ms | Zaman damgası. bulunmayabilir |
| components[].detail.first_frame_ms | number | ms | Son yoklamada WebSocket akışına bağlanmaktan ilk çerçevenin gelmesine kadar geçen süre; yoklanmadıysa null. bulunmayabilir |
| components[].detail.ping_ms | number | ms | Bileş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.note | null | — | Not. bulunmayabilir |
| components[].detail.last_run_at | number | ms | Zaman damgası. bulunmayabilir |
| components[].detail.age_s | number | s | Bu satırın son güncellenmesinden bu yana geçen saniye. bulunmayabilir |
| components[].detail.interval_s | number | s | İki yoklama çalışması arasındaki planlanan aralık (300). bulunmayabilir |
| components[].detail.took_ms | number | ms | Tamamlanan son yoklama çalışmasının süresi; kaydedilmediyse null. bulunmayabilir |
| components[].detail.families_total | number | count | Veri toplama açısından değerlendirilen veri ailesi sayısı. bulunmayabilir |
| components[].detail.families_degraded | number | count | Toplama durumu `degraded` veya `outage` olan veri ailesi sayısı. bulunmayabilir |
| components[].detail.judged_by | string | — | Durumun hangi zaman damgasına göre değerlendirildiği. bulunmayabilir |
| endpoints | object | — | Her canlı durumdaki belgelenen uç nokta sayısı ve hata verenlerin listesi. |
| endpoints.total | number | — | Toplam. |
| endpoints.available | number | — | Verinin mevcut olup olmadığı. |
| endpoints.partial | number | — | Beklenen verinin yalnızca bir kısmı mevcutsa true. |
| endpoints.degraded | number | count | Canlı durumu `degraded` olan uç nokta sayısı. |
| endpoints.down | number | count | Canlı durumu `down` olan uç nokta sayısı. |
| endpoints.unavailable | number | — | Verisi bulunmayan öğeler, nedenleriyle birlikte. Hiçbir zaman 0 olarak bildirilmez. |
| endpoints.unknown | number | count | Canlı durumu `unknown` olan (yakın tarihli yoklama sonucu bulunmayan) uç nokta sayısı. |
| endpoints.failing | array | — | Ş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[].id | string | — | Tanımlayıcı. |
| endpoints.failing[].path | string | — | Uç nokta yolu. |
| endpoints.failing[].status | string | — | Durum. |
| endpoints.failing[].reason | string | — | Neden kodu. |
| endpoints.failing[].http | number | — | Son yoklamanın HTTP durumu; hiç yoklanmadıysa `null`. |
| endpoints.failing[].last_ok_at | number | ms | Zaman damgası. |
| endpoints.failing[].fail_streak | number | count | Art arda başarısız yoklama sayısı. |
| latency_ms | object | — | 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.p50 | number | ms | Uç noktalar genelindeki medyan yanıt süresi; güncel örnek yoksa null. |
| latency_ms.p95 | number | ms | Uç noktalar genelindeki 95. yüzdelik yanıt süresi; güncel örnek yoksa null. |
| latency_ms.max | number | — | Maksimum. |
| latency_ms.sample | number | count | Yanıt süresi rakamlarına dahil edilen uç nokta sayısı. |
| latency_ms.measured | string | — | Yanıt süresinin nerede ölçüldüğüne ilişkin düz metin not: sunucu tarafında, ağ aktarım süresi hariç. |
| uptime | object | — | 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_days | number | days | Erişilebilirlik penceresinin uzunluğu (30). |
| uptime.checks | number | count | Penceredeki yoklama kontrolü sayısı, tüm uç noktalar birlikte. |
| uptime.ok | number | count | Bu kontrollerden başarılı olanların sayısı. |
| uptime.pct | number | % | Yüzde. |
| uptime.tracking_since | string | — | Pencere içinde yoklama verisi bulunan ilk gün, `YYYY-MM-DD`; henüz veri yoksa null. |
| uptime.days | array | — | 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[].day | string | — | Takvim günü (UTC). |
| uptime.days[].checks | number | count | O günkü yoklama isteği sayısı. |
| uptime.days[].ok | number | count | O günkü başarılı yoklama isteği sayısı. |
| uptime.days[].pct | number | % | Yüzde. |
| uptime.days[].schema_pct | number | % | O gün yoklanan yanıtlardan belgelenen alan tablosuyla eşleşenlerin payı. |
| uptime.days[].avg_ms | number | ms | O günkü ortalama yanıt süresi. |
| collectors | object | — | 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.families | array | — | 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[].family | string | — | Aile kimliği; örneğin `ticker`, `oi`, `funding`, `liquidation`, `options`. |
| collectors.families[].title | string | — | Ailenin görüntülenen başlığı. |
| collectors.families[].exchanges_collected | number | count | Ailenin toplandığı borsalar: güncel + kısmi + eskimiş + bozuk. |
| collectors.families[].fresh | number | count | Aileye ait en yeni verisi güncellik penceresinin içinde olan borsalar. |
| collectors.families[].partial | number | — | Beklenen verinin yalnızca bir kısmı mevcutsa true. |
| collectors.families[].stale | number | — | Güncellik penceresinden daha eski veriler için satırlar veya bayrak. |
| collectors.families[].broken | number | count | Aile için veri kaynağı sürekli hata veren veya satırlarının çoğu tutarlılık kontrollerinden geçemeyen borsalar. |
| collectors.families[].unavailable | number | — | Verisi bulunmayan öğeler, nedenleriyle birlikte. Hiçbir zaman 0 olarak bildirilmez. |
| collectors.families[].status | string | — | Durum. |
| collectors.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. |
| 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[].family | string | — | Veri kümesi kimliği; örneğin `etf` veya `cme`. |
| collectors.datasets[].id | string | — | Tanımlayıcı. |
| collectors.datasets[].title | string | — | Veri kümesinin görüntülenen adı. |
| collectors.datasets[].source | string | — | Değerin nereden geldiği. |
| collectors.datasets[].endpoint | string | — | Veri kümesini sunan herkese açık uç nokta. |
| collectors.datasets[].status | string | — | Durum. |
| collectors.datasets[].lag_s | number | s | Yanıt oluşturulduğu anda en yeni veri noktasının yaşı. |
| collectors.datasets[].source_at | number | ms | Zaman damgası. |
| collectors.datasets[].fetched_at | number | ms | CoinBoss'un veriyi kaynaktan getirdiği zaman. |
| collectors.datasets[].fresh_within_s | number | s | Güncellik penceresi: bundan daha yeni veriler güncel sayılır. |
| collectors.datasets[].coverage | object | — | Nelerin dahil olduğu ve nelerin eksik olduğu. |
| collectors.datasets[].coverage.funds_total | number | count | İzlenen fon sayısı. bulunmayabilir |
| collectors.datasets[].coverage.funds_covered | number | count | Kullanılabilir bir açıklaması bulunan fon sayısı. bulunmayabilir |
| collectors.datasets[].coverage.funds_unavailable | number | count | İhraççısı makinece okunabilir bir açıklama yayımlamayan fon sayısı. bulunmayabilir |
| collectors.datasets[].coverage.funds_failing | number | count | Son toplama turunda açıklaması okunamayan fon sayısı. bulunmayabilir |
| collectors.datasets[].coverage.as_of | string | — | Kapsanan fonlar arasındaki en yeni açıklama tarihi (YYYY-MM-DD). bulunmayabilir |
| collectors.datasets[].coverage.as_of_min | string | — | Kapsanan fonlar arasındaki en eski açıklama tarihi (YYYY-MM-DD). bulunmayabilir |
| collectors.datasets[].reason | string|null | — | Neden kodu. |
| collectors.datasets[].coverage.contracts | number | — | Sözleşme bazında satırlar. bulunmayabilir |
| collectors.datasets[].coverage.report_date | string | — | En yeni CFTC Commitments of Traders raporunun tarihi (YYYY-MM-DD). bulunmayabilir |
| collectors.datasets[].coverage.products | number | count | Kapsanan CME ürünü sayısı. bulunmayabilir |
| collectors.datasets[].coverage.trade_date | string | — | En yeni CME günlük raporunun işlem tarihi (YYYY-MM-DD). bulunmayabilir |
| collectors.patrol_ok | boolean | — | Veri kalitesi devriyesi son 15 dakika içinde çalıştıysa true. |
| collectors.patrol_age_s | number | s | Olaydan bu yana geçen saniye. |
| collectors.evaluated_at | number | ms | Zaman damgası. |
| incidents | object | — | Açık olan veya son 7 günde çözülen veri kalitesi uyarıları: `open` sayısı ve `items` (en çok 100). |
| incidents.open | number | — | Dönemin açılış fiyatı. |
| incidents.items | array | — | Sonuç öğeleri. |
| incidents.items[] | object | — | Sonuç öğeleri. |
| incidents.items[].level | string | — | Seviye. |
| incidents.items[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| incidents.items[].family | string | — | Uyarının ilgili olduğu veri ailesi. |
| incidents.items[].code | string | — | Kod. |
| incidents.items[].detail | string | — | Ayrıntı. |
| incidents.items[].opened_at | number | ms | Zaman damgası. |
| incidents.items[].last_seen_at | number | ms | Zaman damgası. |
| incidents.items[].resolved_at | number|null | ms | Zaman damgası. |
| incidents.items[].hits | number | count | Uyarı açıldığından bu yana koşulu gözlemleyen devriye çalışması (5 dakikada bir) sayısı. |
| incidents.items[].open | boolean | — | Dönemin açılış fiyatı. |
| probe | object | — | Canlı durumların dayandığı uç nokta yoklamasının durumu: son çalışma zamanı, yaşı, aralığı ve güncel olup olmadığı. |
| probe.last_run_at | number | ms | Zaman damgası. |
| probe.age_s | number | s | Bu satırın son güncellenmesinden bu yana geçen saniye. |
| probe.interval_s | number | s | İki yoklama çalışması arasındaki planlanan aralık (300). |
| probe.fresh | boolean | — | Son yoklama çalışması 20 dakikadan yeniyse true; false olduğunda uç nokta durumları `unknown` olarak bildirilir. |
| probe.error | null | — | Hata mesajı (yalnızca başarısızlık durumunda bulunur). |
| probe.endpoints_checked | number | count | Son yoklama turunda kontrol edilen uç nokta sayısı. |
| probe.ok | number | count | Son yoklama turunda doğru yanıt veren uç nokta sayısı. |
| probe.failed | number | count | Son yoklama turunda başarısız olan uç nokta sayısı. |
| probe.schema_mismatch | number | count | Yanıtı belgelenen alan tablosuyla eşleşmeyen uç nokta sayısı. |
| probe.alt_samples_failed | null | count | Başarısız olan ek örnek istek sayısı; son turda bunlar çalıştırılmadıysa `null`. |
| legend | object | — | `overall` alanının her değerinin düz metin tanımı. |
| legend.operational | string | — | `operational` tanımı. |
| legend.degraded | string | — | `degraded` tanımı. |
| legend.partial_outage | string | — | `partial_outage` tanımı. |
| legend.major_outage | string | — | `major_outage` tanımı. |
| legend.unknown | string | — | `unknown` tanımı. |
| 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 | — | Uç nokta yoklaması son 20 dakika içinde rapor verdiyse `FRESH`, aksi hâlde `STALE`. |
| 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: 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"
- "endpoints"
- "total"299
- "available"256
- "partial"17
- "degraded"17
- "down"8
- "unavailable"1
- "unknown"0
- "failing"
- "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"
- "collectors"
- "families"
- "datasets"
- "patrol_ok"true
- "patrol_age_s"282
- "evaluated_at"1794542027976
- "incidents"
- "open"2
- "items"
- "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"
- "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
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ı →
| 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/statusKullanılabilirParametre yok.
https://www.coinboss.com/api/meta/statusBu 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