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

Ikhtisar detail koin

Ikhtisar detail koin (harga, kapitalisasi pasar, suplai, ringkasan derivatif)

GET/api/currency/overview

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
coinstringWajib——Simbol koin dasar (huruf besar, mis. BTC). Contoh: BTC

Contoh permintaan

curl -s "https://www.coinboss.com/api/currency/overview?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 }`.
dataobject—Payload.
data.coinstring—Simbol koin, huruf besar (misalnya BTC).
data.supplyobject—Suplai dalam satuan koin.
data.supply.price_usdstring(decimal)USDHarga.
data.supply.market_cap_usdstring(decimal)USDKapitalisasi pasar.
data.supply.mcap_ranknumber—Peringkat menurut kapitalisasi pasar.
data.supply.vol_24h_usdstring(decimal)USDVolume 24h.
data.supply.circulatingstring(decimal)—Suplai beredar dalam satuan koin.
data.supply.total_supplystring(decimal)—Total suplai dalam satuan koin.
data.supply.max_supplystring(decimal)|null—Suplai maksimum dalam satuan koin; null jika tidak terbatas atau tidak diketahui.
data.supply.change_24h_pctstring(decimal)%Perubahan persentase 24h.
data.supply.image_urlstring—Path ikon same-origin yang disajikan CoinBoss; null jika tidak ada ikon terverifikasi.
data.supply.website_urlstring—Situs web resmi proyek, dari metadata koin.
data.supply.reddit_urlstring|null—Subreddit proyek; null jika tidak ada yang tercantum.
data.supply.github_urlstring|null—Repositori kode sumber utama proyek; null jika tidak ada yang tercantum.
data.supply.whitepaper_urlstring—Tautan ke whitepaper proyek.
data.supply.explorer_urlstring—Tautan ke block explorer untuk koin ini.
data.supply.categorystring—Kategori.
data.supply.asofnumbermsWaktu data terbaru yang digunakan.
data.supply.staleboolean—Baris atau flag untuk data yang lebih lama daripada jendela kesegaran.
data.supply.spot_vol_usdnumberUSDJumlah volume spot 24h koin di seluruh bursa spot yang dikumpulkan sendiri oleh CoinBoss (snapshot terbaru); null jika tidak dikumpulkan.
data.supply.futures_vol_usdnumberUSDJumlah volume futures 24h di semua bursa yang ticker-nya lebih baru dari 1 jam, nilainya sama dengan `futures_vol.total_usd`; null jika tidak ada data sendiri.
data.supply.oi_total_usdnumberUSDOpen interest agregat koin di semua bursa dan jenis kontrak, nilainya sama dengan `oi.total_usd`; null jika tidak ada data sendiri.
data.supply.high_24hstring(decimal)—Tertinggi 24h.
data.supply.low_24hstring(decimal)—Terendah 24h.
data.futures_vol_chg_pctnumber%Perubahan 24h volume futures: bursa yang ada saat ini dan di snapshot per jam sekitar 24 jam lalu, (Σ saat ini − Σ sebelumnya) ÷ Σ sebelumnya.
data.oi_chg_pctnumber%Perubahan 24h open interest yang dihitung pada kontrak yang ada baik saat ini maupun di snapshot per jam yang paling dekat dengan 24 jam lalu.
data.oiobject—Open interest.
data.oi.total_usdnumberUSDTotal.
data.oi.local_usdnumberUSDOpen interest yang dijumlahkan dari pengumpulan per bursa milik CoinBoss sendiri; identik dengan `oi.total_usd`.
data.oi.by_exchangearray—Rincian per bursa.
data.oi.by_exchange[]object—Rincian per bursa.
data.oi.by_exchange[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
data.oi.by_exchange[].oi_usdnumberUSDOpen interest dalam nosional USD.
data.oi.n_exchangesnumber—Jumlah bursa yang berkontribusi.
data.oi.asofnumbermsWaktu data terbaru yang digunakan.
data.oi.chg_basisobject—Input `oi_chg_pct`: jumlah saat ini dan sebelumnya yang dipasangkan (`cur`, `prev`), jumlah bursa yang cocok, jam baseline, dan kontrak beku yang dikecualikan.
data.oi.chg_basis.curnumber—Nilai saat ini.
data.oi.chg_basis.prevnumber—Nilai sebelumnya (baseline).
data.oi.chg_basis.n_matchednumber—Item yang ada di kedua ujung perbandingan.
data.oi.chg_basis.prev_hour_tsnumbermsAwal bucket jam sebelumnya.
data.oi.chg_basis.frozen_excludedobject—Baris yang dikecualikan karena nilai sumbernya tidak bergerak.
data.oi.chg_basis.frozen_excluded.n_baselinenumber—Item dalam snapshot baseline.
data.oi.chg_basis.frozen_excluded.n_currentnumber—Item dalam snapshot saat ini.
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSDNilai saat ini.
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSDNilai baseline.
data.futures_volobject—Volume futures.
data.futures_vol.total_usdnumberUSDTotal.
data.futures_vol.n_exchangesnumber—Jumlah bursa yang berkontribusi.
data.futures_vol.chg_basisobject—Input `futures_vol_chg_pct`: jumlah volume saat ini dan sebelumnya yang dipasangkan (`cur`, `prev`), jumlah bursa yang cocok, dan jam baseline.
data.futures_vol.chg_basis.curnumber—Nilai saat ini.
data.futures_vol.chg_basis.prevnumber—Nilai sebelumnya (baseline).
data.futures_vol.chg_basis.n_matchednumber—Item yang ada di kedua ujung perbandingan.
data.futures_vol.chg_basis.prev_hour_tsnumbermsAwal bucket jam sebelumnya.
data.fundingnumber—Blok atau nilai funding rate.
data.funding_detailobject—Rincian di balik `funding`: rate yang dinormalkan 8h versi rata-rata sederhana dan versi berbobot open interest, rate tahunan, jumlah bursa, dan satu entri per bursa.
data.funding_detail.basisstring—Harga futures dikurangi harga spot, atau blok basis.
data.funding_detail.avg_8hnumber—Rata-rata rate yang dinormalkan 8h.
data.funding_detail.oi_weighted_8hnumber—Rata-rata berbobot open interest dari rate yang dinormalkan 8h.
data.funding_detail.apr_pctnumber% per yearPersentase tahunan.
data.funding_detail.n_exchangesnumber—Jumlah bursa yang berkontribusi.
data.funding_detail.n_normalizednumber—Bursa yang dinormalkan ke 8h.
data.funding_detail.n_unknown_intervalnumber—Bursa dengan interval funding tidak diketahui.
data.funding_detail.by_exchangearray—Rincian per bursa.
data.funding_detail.by_exchange[]object—Rincian per bursa.
data.funding_detail.by_exchange[].exchangestring—ID bursa, huruf kecil (misalnya `binance`).
data.funding_detail.by_exchange[].symbolstring—Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT).
data.funding_detail.by_exchange[].ratenumber—Rate.
data.funding_detail.by_exchange[].interval_hnumberhInterval.
data.funding_detail.by_exchange[].rate_8hnumber—Rate yang dinormalkan ke periode 8 jam.
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsStempel waktu.
data.long_shortobject—Blok long/short.
data.long_short.longnumber—Nilai sisi long.
data.long_short.shortnumber—Nilai sisi short.
data.long_short.rationumber—Rasio.
data.long_short.typestring—Tipe.
data.long_short.n_exchangesnumber—Jumlah bursa yang berkontribusi.
data.derivedobject—Indikator koin yang dihitung ulang secara berkala (RSI, basis, open interest agregat, funding rata-rata, pangsa long/short, likuidasi 24h); null jika tidak dihitung.
data.derived.rsi_1hstring(decimal)—RSI(14) pada candlestick 1h.
data.derived.rsi_4hstring(decimal)—RSI(14) pada candlestick 4h.
data.derived.rsi_1dstring(decimal)—RSI(14) pada candlestick harian.
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100.
data.derived.basis_annual_pctnull% per yearBasis yang ditahunkan berdasarkan jumlah hari hingga jatuh tempo.
data.derived.oi_usd_aggstring(decimal)USDOpen interest agregat di semua bursa dan jenis kontrak pada pembaruan indikator terakhir; dapat sedikit tertinggal dari `oi.total_usd`.
data.derived.funding_avgstring(decimal)—Rata-rata funding rate lintas bursa.
data.derived.ls_accountstring(decimal)—Rasio long/short berdasarkan akun.
data.derived.ls_takerstring(decimal)|null—Rasio beli/jual taker.
data.derived.liq_24h_usdstring(decimal)USDLikuidasi 24h.
data.liquidationobject—Blok likuidasi. kunci dinamis: 1h,4h,12h,24h
data.liquidation.{*}object—Blok likuidasi.
data.liquidation.{*}.winstring—Label jendela entri ini, mengulangi kuncinya (`1h`, `4h`, `12h`, atau `24h`).
data.liquidation.{*}.long_usdnumberUSDSisi long.
data.liquidation.{*}.short_usdnumberUSDSisi short.
data.liquidation.{*}.total_usdnumberUSDTotal.
data.liquidation.{*}.cntnumber—Jumlah.

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

Contoh respons

/api/currency/overview?coin=BTC · Respons nyata yang direkam 2026-11-13 03:57:31 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data.liquidation berisi 4 item; data.oi.by_exchange berisi 22 item; data.funding_detail.by_exchange berisi 23 item.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
coin=ETH20086 msLolos
coin=SOL20081 msLolos
coin=ARKM20079 msLolos

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

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
30s
Mikro-cache edge
10s
Frekuensi pembaruan
agregator data pasar pihak ketiga setiap 10 min; ticker setiap 1 min; OI/funding/long-short setiap 5 min (koin inti setiap 1 min); volume spot setiap 10 min; cache in-memory 30 s
Jendela
bergulir 24h untuk volume/likuidasi; snapshot terbaru untuk OI/funding/long-short
Sumber data
Suplai, kapitalisasi pasar, dan peringkat berasal dari agregator data pasar pihak ketiga; harga, open interest, funding, long/short, serta volume futures dan spot diagregasi sendiri dari API publik bursa; likuidasi berasal dari stream likuidasi bursa.
Cakupan bursa
Koin apa pun yang ada di tabel bersumber agregator data pasar pihak ketiga atau yang memiliki kontrak derivatif terdaftar
Paginasi
tidak ada
Satuan
USD; rates as decimals; changes in percent
Metode
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:57:31 UTCHTTP 20095 msSkema sesuaiTitik data terbaru berusia 20s

Ketersediaan, 30 hari terakhir

99.76% 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/currency/overviewTersedia
Parameter

string — Base coin symbol (uppercase, e.g. BTC).

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