/api/volume/coin
GETTersedia

Data halaman volume koin

Data halaman volume koin (pembagian per bursa dan deret harian 30 hari)

GET/api/volume/coin
`daily_30d` memuat satu nilai per hari UTC: snapshot 24h bergulir terakhir yang tercatat pada hari itu, bukan jumlah per hari kalender. Deret ini saat ini mencakup sekitar 8 hari karena tabel sumbernya menyimpan 7 hari.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
symbolstringWajib——Simbol koin (diubah ke huruf besar, maks 30); 404 jika tidak ada data. Contoh: BTC

Contoh permintaan

curl -s "https://www.coinboss.com/api/volume/coin?symbol=BTC"

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 }`.
dataobject—Payload.
data.symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
data.total_24h_usdnumberUSDJumlah volume futures 24h koin di bursa yang tercantum (15 terbesar menurut volume).
data.exchangesarray—Bursa.
data.exchanges[]object—Bursa.
data.exchanges[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
data.exchanges[].volume_usdnumberUSDVolume dalam nosional USD.
data.exchanges[].share_pctnumber%Pangsa dari total.
data.daily_30darray—Riwayat volume harian selama 30 hari terakhir, dari yang terlama; satu entri per hari UTC.
data.daily_30d[]object—Satu hari UTC: `volume_usd` adalah snapshot volume 24h bergulir yang diambil pada `as_of`, yaitu snapshot per jam terakhir hari itu.
data.daily_30d[].datestring—Tanggal kalender (UTC).
data.daily_30d[].volume_usdnumberUSDVolume dalam nosional USD.
data.daily_30d[].as_ofnumbermsWaktu sampel terakhir yang masuk ke hari ini.
data.daily_30d_basisstring—Cara deret harian disusun (sampel mana yang dipakai dan dari mana riwayatnya dimulai).

Dihasilkan 2026-11-11 23:00 UTC dari 4 respons nyata.

Contoh respons

/api/volume/coin?symbol=BTC · Respons nyata yang direkam 2026-11-13 03:57:35 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data.daily_30d berisi 8 item; data.exchanges berisi 15 item.

  • {
    • "success": true,
    • "data": {
      • "symbol": "BTC",
      • "total_24h_usd": 66180849481.29,
      • "exchanges": [ … 2 ],
      • "daily_30d": [ … 2 ],
      • "daily_30d_basis": "rolling_24h_volume_snapshot_last_of_utc_day"
      }
    }

Sampel terverifikasi

Selain contoh di atas, probe memanggil endpoint ini dengan parameter berikut dan memeriksa skemanya setiap kali.

ParameterHTTPLatensiHasil
symbol=ETH20018 msLolos
symbol=SOL20017 msLolos
symbol=ARKM20017 msLolos

Diperiksa 2026-11-13 03:57:35 UTC

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
2m
Mikro-cache edge
10s
Frekuensi pembaruan
ticker setiap 1 min; snapshot setiap jam; cache in-memory 120 s
Jendela
24h per bursa; 30 titik harian
Sumber data
Volume futures 24h satu koin yang dibagi per bursa dari ticker publik bursa, ditambah deret harian 30 hari dari snapshot volume per jam milik kami.
Cakupan bursa
15 bursa teratas menurut volume untuk koin tersebut
Paginasi
tidak ada
Pengurutan
volume, menurun
Satuan
USD; share in percent
Metode
share_pct = exchange volume / SUM(top 15 exchanges) * 100
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:57:35 UTCHTTP 20015 msSkema sesuaiTitik data terbaru berusia 4h

Ketersediaan, 30 hari terakhir

100% dari 411 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/volume/coinTersedia
Parameter

string — Coin symbol (upper-cased, max 30); 404 when no data.

URL permintaanhttps://www.coinboss.com/api/volume/coin?symbol=BTC
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.