/api/rich-list/:chain/stat
GETTerdegradasi

Statistik daftar alamat terkaya multi-chain

Statistik daftar alamat terkaya multi-chain

GET/api/rich-list/:chain/stat
Cakupan sebagian. Sumber peringkat alamat berhenti diperbarui; snapshot terakhir dikembalikan dengan stempel waktu aslinya. Perlakukan data ini sebagai data historis sampai stempel waktunya berubah lagi.
Terdegradasi. Titik data terbaru berumur 6144813 s (seharusnya dalam 259200 s)

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
chain pathstringWajib—eth, tron, bsc, polygon, arbitrum, doge, ltc, dash, aptos, bch, avalanche, optimism, base, tonID chain; 400 jika tidak didukung. Contoh: eth

Parameter bertanda “path” merupakan bagian dari URL.

Contoh permintaan

curl -s "https://www.coinboss.com/api/rich-list/eth/stat"

Kolom respons

Tabel kolom dihasilkan dari respons nyata, sehingga memuat persis apa yang dikembalikan endpoint. Path memakai a[] untuk item array dan {*} untuk objek yang kuncinya berupa nama dinamis seperti koin atau bursa.

KolomTipeSatuanDeskripsi
successboolean—true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`.
chainstring—ID chain.
availableboolean—Apakah data tersedia.
unitstring—Satuan nilai dalam objek ini.
snapshot_atnumbermsWaktu snapshot.
pricenumber—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
dataarray—Payload.
data[]object—Payload.
data[].range_fromnumber—Peringkat pertama bucket (alamat diperingkat menurut saldo, 1 = terbesar).
data[].range_tonumber—Peringkat terakhir bucket; −1 menandai bucket terbuka yang berisi semua alamat sisanya.
data[].address_countnumbercountJumlah alamat dalam bucket; −1 jika sumber tidak memberikan jumlahnya (bucket terbuka).
data[].holders_valuenumbercoinJumlah koin native chain yang dipegang bucket; 0 pada bucket terbuka berarti tidak dipublikasikan.
data[].holders_usdnumberUSD`holders_value` × harga koin; null jika tidak ada harga yang tersedia.
data[].percent_ratenumberfractionPangsa suplai koin yang dipegang bucket tersebut, berupa pecahan (0.13 = 13 %).

Dihasilkan 2026-11-11 23:01 UTC dari 1 respons nyata.

Contoh respons

/api/rich-list/eth/stat · Respons nyata yang direkam 2026-11-13 03:53:41 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data berisi 5 item.

  • {
    • "success": true,
    • "chain": "eth",
    • "available": true,
    • "unit": "ETH",
    • "snapshot_at": 1788397209000,
    • "price": 1941.76,
    • "data": [
      • { … 6 },
      • { … 6 }
      ]
    }

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
5m
Mikro-cache edge
10s
Frekuensi pembaruan
dijadwalkan setiap 20 min, tetapi setiap proses gagal sejak sekitar 2026-09-03
Jendela
snapshot terbaru yang tersimpan (membeku sekitar 2026-09-03)
Sumber data
Distribusi alamat menurut rentang saldo per chain dari sumber scraping yang sudah dihentikan; tidak lagi diperbarui.
Cakupan bursa
Chain: eth, tron, bsc, polygon, arbitrum, doge, ltc, dash, aptos, bch, avalanche, optimism, base, ton; `available: false` jika suatu chain tidak memiliki snapshot. Usang untuk semua chain.
Pengurutan
rentang saldo, menaik
Satuan
address count, coin amount and percent per balance band
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TerdegradasiDiperiksa 2026-11-13 03:53:41 UTCHTTP 2002 msSkema sesuaiTitik data terbaru berusia 71.1d

Titik data terbaru berumur 6144813 s (seharusnya dalam 259200 s)

Ketersediaan, 30 hari terakhir

100% dari 407 pemeriksaan lolos

Error

Panggilan yang gagal memiliki satu bentuk yang sama di semua endpoint. Daftar lengkapnya ada di halaman error. Error dan batas permintaan →

KodeHTTPArtiTindakan
INVALID_PARAM400Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui.Jangan mengulang tanpa perubahan; perbaiki permintaannya.
UNAUTHORIZED401Header `CB-API-KEY` dikirim tetapi kuncinya tidak dikenal atau sudah dicabut. Data publik tidak memerlukan kunci — hapus header tersebut atau gunakan kunci yang valid.Jangan mengulang tanpa perubahan.
FORBIDDEN403Rute ini bukan bagian dari API publik (internal atau khusus akun).Jangan mengulang.
NOT_FOUND404Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada.Jangan mengulang; periksa path dan pengenal terhadap katalog.
RATE_LIMITED429Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu.Tunggu selama `Retry-After`, lalu ulangi dengan backoff.
INTERNAL500Error server yang tidak terduga. Pesannya sengaja dibuat generik; sertakan `request_id` saat melaporkannya.Ulangi sekali setelah beberapa detik; laporkan beserta ID permintaan jika masih terjadi.
UPSTREAM_FAILED503Sumber data di balik endpoint ini tidak menjawab tepat waktu. Tidak ada angka usang atau angka pengganti yang dikembalikan sebagai gantinya.Ulangi dengan backoff; periksa halaman status.
UNAVAILABLE501 / 503Dataset untuk sementara belum siap (cache sedang diisi) atau endpoint belum memiliki sumber publik yang sah.Ulangi nanti; katalog menandai endpoint yang memang tidak tersedia secara desain.
REQUEST_FAILED200Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP.Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal.

Coba

GET/api/rich-list/:chain/statTerdegradasi
Parameter

string — Chain id; 400 if unsupported.

URL permintaanhttps://www.coinboss.com/api/rich-list/eth/stat
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.