/api/exchanges/detail
GETTersedia

Ikhtisar derivatif untuk satu bursa

Ikhtisar derivatif untuk satu bursa (OI, volume, jumlah koin, ...)

GET/api/exchanges/detail

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
exstringWajib——ID bursa (diubah ke huruf kecil, hanya a-z0-9.); 400 jika tidak ada. Contoh: binance

Contoh permintaan

curl -s "https://www.coinboss.com/api/exchanges/detail?ex=binance"

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.exchangestring—ID bursa, huruf kecil (misalnya `binance`).
data.namestring—Nama.
data.volume_usdnumberUSDVolume dalam nosional USD.
data.oi_usdnumberUSDOpen interest dalam nosional USD.
data.liq_24h_longnumber—Posisi long yang dilikuidasi dalam 24h.
data.liq_24h_shortnumber—Posisi short yang dilikuidasi dalam 24h.
data.liq_24h_totalnumber—Total likuidasi 24h.
data.liq_24h_cntnumbercountJumlah order likuidasi yang tercatat di bursa dalam 24 jam terakhir; null jika bursa tidak memiliki feed likuidasi.
data.liq_sourceboolean—True jika ada catatan likuidasi untuk bursa ini dalam 7 hari terakhir; jika false, kolom `liq_24h_*` bernilai null, bukan nol.
data.contractsnumber—Baris per kontrak.
data.options_vol_usdnullUSDDicadangkan untuk volume opsi bursa; saat ini belum diisi, sehingga nilainya selalu null.
data.taker_feenumber%Biaya taker tingkatan dasar untuk perpetual USDT dari daftar biaya publik bursa (0.05 = 0.05 %); nilai acuan statis, null jika tidak diketahui.
data.maker_feenumber%Biaya maker tingkatan dasar untuk perpetual USDT dari daftar biaya publik bursa (0.02 = 0.02 %); nilai acuan statis, null jika tidak diketahui.
data.is_dexboolean—True untuk bursa perpetual terdesentralisasi (misalnya Hyperliquid, dYdX, Aster), false untuk bursa terpusat.
data.scorenumber—Skor.
data.has_lsboolean—True jika data rasio long/short tersedia untuk bursa ini.
data.total_assets_usdnumber|nullUSDTotal aset yang disimpan di dompet bursa yang diungkapkan (nilainya sama dengan `reserve.tvl_usd`), dari sumber pihak ketiga; null jika tidak tercakup.
data.reserveobject|null—Snapshot cadangan dompet bursa yang diungkapkan, dari sumber pihak ketiga, diperbarui sekitar setiap 6 jam; null jika bursa tidak tercakup.
data.reserve.tvl_usdnumberUSDTotal nilai terkunci.
data.reserve.clean_tvl_usdnumberUSDAset dompet tidak termasuk token platform milik bursa sendiri, sebagaimana didefinisikan sumber pihak ketiga; null jika tidak dipublikasikan.
data.reserve.inflow_24hnumberUSDArus masuk bersih ke dompet bursa selama 24 jam terakhir (negatif = arus keluar bersih), sebagaimana dilaporkan sumber pihak ketiga.
data.reserve.inflow_1wnumberUSDArus masuk bersih ke dompet bursa selama 7 hari terakhir (negatif = arus keluar bersih), sebagaimana dilaporkan sumber pihak ketiga.
data.reserve.inflow_1mnumberUSDArus masuk bersih ke dompet bursa selama sebulan terakhir (negatif = arus keluar bersih), sebagaimana dilaporkan sumber pihak ketiga.
data.reserve.wallets_linkstring—URL pengungkapan dompet atau proof-of-reserves milik bursa sendiri; null jika tidak ada yang diketahui.
data.reserve.updated_atnumbermsWaktu baris ini terakhir diperbarui.
data.dist_oiarray—20 koin teratas menurut open interest di bursa ini, dari yang terbesar; kontrak yang tidak diperbarui baru-baru ini dikecualikan.
data.dist_oi[]object—Satu koin: `coin` adalah aset dasar dan `v` adalah open interest-nya di bursa ini dalam USD.
data.dist_oi[].coinstring—Simbol koin, huruf besar (misalnya BTC).
data.dist_oi[].vnumber—Nilai.
data.dist_volarray—20 koin teratas menurut volume futures 24 jam di bursa ini, dari yang terbesar; ticker yang tidak diperbarui dalam 1 jam terakhir dikecualikan.
data.dist_vol[]object—Satu koin: `coin` adalah aset dasar dan `v` adalah volume 24 jamnya di bursa ini dalam USD.
data.dist_vol[].coinstring—Simbol koin, huruf besar (misalnya BTC).
data.dist_vol[].vnumber—Nilai.

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

Contoh respons

/api/exchanges/detail?ex=binance · Respons nyata yang direkam 2026-11-13 03:58:11 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data.dist_oi berisi 20 item; data.dist_vol berisi 20 item.

  • {
    • "success": true,
    • "data": {
      • "exchange": "binance",
      • "name": "Binance",
      • "volume_usd": 66757355043.21,
      • "oi_usd": 24415618131.95,
      • "liq_24h_long": 435450375.63,
      • "liq_24h_short": 17633087.23,
      • "liq_24h_total": 453083462.86,
      • "liq_24h_cnt": 47283,
      • "liq_source": true,
      • "contracts": 762,
      • "options_vol_usd": null,
      • "taker_fee": 0.05,
      • "maker_fee": 0.02,
      • "is_dex": false,
      • "score": 96,
      • "has_ls": true,
      • "total_assets_usd": 121135381605.44,
      • "reserve": { … 7 },
      • "dist_oi": [ … 2 ],
      • "dist_vol": [ … 2 ]
      }
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
ex=okx200171 msLolos
ex=hyperliquid200176 msLolos
—4001 msLolos mengembalikan error yang diharapkan

Diperiksa 2026-11-13 03:58:11 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 setiap 1 min; OI setiap 5 min; cadangan setiap 6 h; cache in-memory 30 s
Jendela
volume dan likuidasi 24h bergulir
Sumber data
Profil per bursa yang diagregasi dari API publik bursa (volume, OI, kontrak), stream likuidasi, dan data cadangan CEX dari sumber pihak ketiga.
Cakupan bursa
Semua bursa derivatif yang dikumpulkan; cadangan hanya untuk 10 bursa yang dilacak dari sumber pihak ketiga
Paginasi
tidak ada
Satuan
USD; score 1-99
Metode
score = clamp(1..99, round(log10(vol + 10) / 11.2 * 70 + log10(oi + 10) / 11 * 30))
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:58:11 UTCHTTP 200964 msSkema sesuaiTitik data terbaru berusia 4.8h

Ketersediaan, 30 hari terakhir

100% dari 410 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/exchanges/detailTersedia
Parameter

string — Exchange id (lower-cased, a-z0-9. only); 400 when missing.

URL permintaanhttps://www.coinboss.com/api/exchanges/detail?ex=binance
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.