Volume 24j—Open Interest—Likuidasi 24j$1.36BLong/Short 24j—Dominasi BTC—Dominasi ETH—
Aplikasi
Bahasa ▾
Rp IDR ▾
/api/sd/volume
GETTersedia

Volume futures untuk satu koin

Lapisan data mandiri: volume futures untuk satu koin

GET/api/sd/volume

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
coinstringWajib——Simbol koin; 400 jika tidak ada. Alias: `base`. Contoh: BTC

Contoh permintaan

curl -s "https://www.coinboss.com/api/sd/volume?coin=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 }`.
coinstring—Simbol koin, huruf besar (misalnya BTC).
nownumbermsWaktu server saat respons disusun.
futuresobject—Blok atau nilai pasar futures.
futures.total_usdnumberUSDVolume futures 24h lintas bursa (nosional USD).
futures.n_exchangesnumber—Jumlah bursa yang berkontribusi.
futures.by_exchangearray—Rincian per bursa.
futures.by_exchange[]object—Rincian per bursa.
futures.by_exchange[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
futures.by_exchange[].vol_usdnumberUSDVolume dalam nosional USD.
futures.by_exchange[].legacy_usdnumberUSDBagian volume yang berasal dari himpunan ticker perpetual USDT.
futures.by_exchange[].sd_usdnumberUSDBagian yang berasal dari kontrak tambahan (USDC, bermargin koin, berjangka) yang sudah disertakan.
futures.by_exchange[].share_pctnumber%Pangsa dari total.
futures.change_24hobject—Perubahan 24h.
futures.change_24h.pctnumber%Persentase.
futures.change_24h.curnumber—Nilai saat ini.
futures.change_24h.prevnumber—Nilai sebelumnya (baseline).
futures.change_24h.n_matchednumber—Item yang ada di kedua ujung perbandingan.
futures.change_24h.n_totalnumber—Item yang ada saat ini.
futures.change_24h.prev_tsnumbermsWaktu snapshot baseline.
futures.change_24h.basisstring—Harga futures dikurangi harga spot, atau blok basis.
futures.selfdata_contractsobject—Kontrak tambahan: apa yang sudah disertakan dan apa yang masih tertunda.
futures.selfdata_contracts.included_usdnullUSDVolume 24h kontrak yang dikumpulkan sebagai tambahan (bermargin koin, USDC, berjangka) yang sudah dihitung dalam total futures; null jika belum ada yang dihitung.
futures.selfdata_contracts.n_includednumbercountJumlah kontrak tambahan yang dihitung dalam total futures (yang memiliki snapshot sendiri dari sekitar 24 jam lalu).
futures.selfdata_contracts.pending_usdnumber|nullUSDJumlah item yang tertunda, tidak termasuk dalam total.
futures.selfdata_contracts.n_pendingnumbercountJumlah kontrak tambahan yang belum dihitung karena belum memiliki baseline 24 jam lalu sendiri; yang terbesar dicantumkan di `pending`.
futures.selfdata_contracts.pendingarray—Item yang dikumpulkan tetapi belum disertakan.
futures.selfdata_contracts.pending[]object—Item yang dikumpulkan tetapi belum disertakan.
futures.selfdata_contracts.pending[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
futures.selfdata_contracts.pending[].symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
futures.selfdata_contracts.pending[].marginstring—Kelas mata uang margin.
futures.selfdata_contracts.pending[].contract_typestring—`perpetual` atau `delivery`.
futures.selfdata_contracts.pending[].vol_usdnumberUSDVolume dalam nosional USD.
futures.selfdata_contracts.pending[].reasonstring—Kode alasan.
spotobject—Blok atau nilai pasar spot.
spot.total_usdnumberUSDVolume spot 24h lintas bursa.
spot.n_exchangesnumber—Jumlah bursa yang berkontribusi.
spot.asofnumbermsWaktu data terbaru yang digunakan.
spot.by_exchangearray—Rincian per bursa.
spot.by_exchange[]object—Rincian per bursa.
spot.by_exchange[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
spot.by_exchange[].vol_usdnumberUSDVolume dalam nosional USD.
spot.by_exchange[].quotestring—Mata uang kuotasi yang disertakan untuk bursa ini.
spot.by_exchange[].tsnumbermsStempel waktu.
spot.by_exchange[].pricenumber—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
spot.by_exchange[].age_snumbersJumlah detik sejak baris ini terakhir diperbarui.
spot.by_exchange[].share_pctnumber%Pangsa dari total.
spot.change_24hobject—Perubahan 24h.
spot.change_24h.pctnumber%Persentase.
spot.change_24h.curnumber—Nilai saat ini.
spot.change_24h.prevnumber—Nilai sebelumnya (baseline).
spot.change_24h.n_matchednumber—Item yang ada di kedua ujung perbandingan.
spot.change_24h.n_totalnumber—Item yang ada saat ini.
spot.change_24h.prev_tsnumbermsWaktu snapshot baseline.
spot.change_24h.basisstring—Harga futures dikurangi harga spot, atau blok basis.
ratiosobject—Rasio volume: `futures_to_spot` (volume futures 24h ÷ volume spot 24h) dan `oi_to_futures_volume`; masing-masing null jika salah satu inputnya tidak ada.
ratios.futures_to_spotnumber—Volume futures dibagi volume spot.
ratios.oi_to_futures_volumenumber—Open interest dibagi volume futures 24h.
methodobject—Pernyataan teks biasa tentang rumus yang dipakai untuk respons ini.
method.futuresstring—Blok atau nilai pasar futures.
method.spotstring—Blok atau nilai pasar spot.
method.changestring—Perubahan selama periode yang dinyatakan.
method.oi_to_futures_volumestring—Definisi teks biasa untuk `ratios.oi_to_futures_volume`: total open interest dalam USD ÷ volume futures 24h dalam USD.

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

Contoh respons

/api/sd/volume?coin=BTC · Respons nyata yang direkam 2026-11-13 03:57:37 UTC. Array dan map yang panjang dipersingkat untuk tampilan: spot.by_exchange berisi 14 item; futures.by_exchange berisi 23 item; futures.selfdata_contracts.pending berisi 5 item.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542257033,
    • "futures": {
      • "total_usd": 79049803843.06,
      • "n_exchanges": 23,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 },
      • "selfdata_contracts": { … 5 }
      },
    • "spot": {
      • "total_usd": 7929483908.44,
      • "n_exchanges": 14,
      • "asof": 1794541800000,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 }
      },
    • "ratios": {
      • "futures_to_spot": 9.9691,
      • "oi_to_futures_volume": 0.6197
      },
    • "method": {
      • "futures": "SUM of each exchange 24h quote turnover in USD for this coin's contracts (ticker fresh within 1h); self-collected coin-margined/USDC/delivery contracts are adde…",
      • "spot": "per exchange: 24h quote turnover summed over that exchange's USD/USDT/USDC-quoted spot pairs of the coin (quote = the largest pair); total = SUM over exchanges …",
      • "change": "same-exchange pairing: only exchanges with both a current value and a snapshot ~24h ago enter numerator and denominator",
      • "oi_to_futures_volume": "total open interest (USD) / 24h futures turnover (USD)"
      }
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
coin=ETH20038 msLolos
coin=SOL20046 msLolos
coin=ARKM20043 msLolos
—4001 msLolos mengembalikan error yang diharapkan

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

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
30s
Mikro-cache edge
10s
Frekuensi pembaruan
ticker futures setiap 60 s (kontrak bermargin koin / USDC / berjangka setiap 120 s); snapshot spot setiap 10 min
Jendela
volume 24 h bergulir sebagaimana dilaporkan masing-masing bursa; perubahan 24 h dibandingkan arsip sendiri sekitar 24 h sebelumnya
Sumber data
Volume futures 24h dari kolektor ticker internal (24 bursa derivatif) dan volume spot 24h dari kolektor ticker spot internal (14 bursa spot, mis. binance, okx, bybit, coinbase, kraken, upbit).
Cakupan bursa
futures: hingga 24 bursa; spot: 14 bursa, pasangan dengan kuotasi USD / USDT / USDC
Satuan
volumes in USD; changes in percent; ratios dimensionless
Metode
futures total = SUM(volume_usd) of tickers fresh within 1 h, plus non-USDT-perp contracts once they have their own ~24 h baseline; spot total = SUM of the latest per-exchange snapshot within 30 min; 24 h change by same-exchange pairing; ratios futures_to_spot and oi_to_futures_volume
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil
Tersedia sejak
2026-11-11

Status langsung

TersediaDiperiksa 2026-11-13 03:57:37 UTCHTTP 20042 msSkema sesuaiTitik data terbaru berusia 8m

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/sd/volumeTersedia
Parameter

string — Coin symbol; 400 when missing. Alias: `base`.

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