/api/btc/rich-list
GETAksamalı

BTC zenginler listesi

BTC zenginler listesi (en büyük adres bakiyeleri)

GET/api/btc/rich-list
Kısmi kapsam. Adres sıralaması kaynağı güncellenmeyi bıraktı; son anlık görüntü özgün zaman damgasıyla döndürülür. Zaman damgası yeniden ilerleyene kadar veriyi geçmiş veri olarak değerlendirin. `balance_usd`, bilinen son bakiyeyi güncel fiyatla çarpar.
Aksamalı. En yeni veri noktası 6144816 s öncesine ait (beklenen: 259200 s içinde)

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
limitintegerİsteğe bağlı100≥ 1 · ≤ 300Döndürülecek satır sayısı. Örnek: 100

Örnek istek

curl -s "https://www.coinboss.com/api/btc/rich-list?limit=100"

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.
pricenumber—Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT).
updated_atnumbermsBu satırın en son güncellendiği zaman.
totalnumber—Toplam.
dataarray—Veri yükü.
data[]object—Veri yükü.
data[].ranknumber—Bu listedeki sıra (1 = ilk).
data[].addressstring—Zincir üstü adres.
data[].balance_btcnumberBTCAnlık görüntü anında adresin BTC bakiyesi.
data[].balance_usdnumberUSDBakiye değeri.
data[].hold_ratenumberfractionAdresin elindeki BTC arzı payı, kesir olarak (0.012 = %1,2).
data[].tx_countnumber|nullcountAdresin işlem sayısı; kaynak yayımlamadıysa null.
data[].labelstring|null—Etiket.

Üretilme zamanı: 2026-11-11 23:01 UTC; kaynak: 1 gerçek yanıt.

Örnek yanıt

/api/btc/rich-list?limit=100 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:53:37 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data: 100 öğe içeriyordu.

  • {
    • "success": true,
    • "price": 69106.6,
    • "updated_at": 1788397202000,
    • "total": 300,
    • "data": [
      • { … 7 },
      • { … 7 }
      ]
    }

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
2m
Edge mikro önbelleği
10s
Güncelleme sıklığı
15 dakikada bir çalışacak şekilde zamanlanmıştır, ancak yaklaşık 2026-09-03'ten beri her çalıştırma başarısız olmuştur
Pencere
depolanan en son anlık görüntü (yaklaşık 2026-09-03'te donmuş)
Veri kaynakları
Üçüncü taraf bir blok gezgininin dahili web API'sinden kazıma yoluyla alınır (resmî bir herkese açık API değildir); artık güncellenmiyor.
Borsa kapsamı
İlk 300 Bitcoin adresi. Eskimiş.
Sayfalama
`limit` varsayılan 100, aralık 1-300; offset yok.
Sıralama
sıra, artan
Birimler
BTC and USD; percent of supply
Yöntem
balance_usd = balance in BTC x latest stored BTC price.
Zaman damgaları
Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi
json
Kararlılık
Kararlı

Canlı durum

AksamalıKontrol: 2026-11-13 03:53:37 UTCHTTP 2002 msŞema eşleşiyorEn yeni veri noktası 71.1d öncesine ait

En yeni veri noktası 6144816 s öncesine ait (beklenen: 259200 s içinde)

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/btc/rich-listAksamalı
Parametreler

integer · varsayılan 100 · en az 1 · en çok 300 — Number of rows to return.

İstek URL'sihttps://www.coinboss.com/api/btc/rich-list?limit=100
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.