/api/options/overview
GETTersedia

Ikhtisar opsi

Ikhtisar opsi (OI, volume, put/call, jatuh tempo terdekat)

GET/api/options/overview
Satu bursa: dihitung hanya dari data opsi publik Deribit. Kolom bertipe `volume_usd` berbasis premi jika bursa melaporkan nilai transaksi premi. Untuk enam bursa dengan cakupan per bursa, gunakan `/api/sd/options/overview`.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
currencystringOpsionalBTCBTC, ETHAset dasar: `BTC` atau `ETH`. Nilai lain mengembalikan 400 `INVALID_PARAM`. Alias: `coin`. Contoh: BTC

Contoh permintaan

curl -s "https://www.coinboss.com/api/options/overview?currency=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 }`.
currencystring—Simbol mata uang / aset.
snap_tsnumbermsWaktu snapshot.
index_pricenumber—Harga indeks aset dasar.
dataobject—Payload.
data.total_oi_usdnumberUSDTotal open interest.
data.total_oi_coinsnumbercoinTotal open interest semua opsi Deribit untuk mata uang tersebut, dalam satuan koin dasar.
data.volume_24h_usdnumberUSDVolume opsi 24 jam dalam USD sebagaimana dilaporkan Deribit; ini adalah nilai transaksi premi, bukan nosional, sehingga jauh di bawah `volume_24h_coins` × harga.
data.volume_24h_coinsnumbercoinVolume perdagangan 24 jam semua opsi Deribit untuk mata uang tersebut, dalam satuan koin dasar.
data.pcr_oinumberratioRasio put/call berdasarkan open interest: open interest put ÷ open interest call, keduanya dalam satuan koin; null jika tidak ada open interest call.
data.pcr_volumenumberratioRasio put/call berdasarkan volume: volume put 24 jam ÷ volume call 24 jam, keduanya dalam satuan koin; null jika tidak ada volume call.
data.max_painobject—Strike tempat pemegang opsi merugi paling besar saat jatuh tempo.
data.max_pain.expirystring—Tanggal jatuh tempo seri opsi.
data.max_pain.pricenumber—Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain).
data.contractsnumber—Baris per kontrak.
data.expiriesnumber—Jatuh tempo opsi / futures.

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

Contoh respons

/api/options/overview?currency=BTC · Respons nyata yang direkam 2026-11-13 03:52:56 UTC.

  • {
    • "success": true,
    • "currency": "BTC",
    • "snap_ts": 1794541801732,
    • "index_price": 69009.96,
    • "data": {
      • "total_oi_usd": 24978601771.99,
      • "total_oi_coins": 358629.9,
      • "volume_24h_usd": 46910595.32,
      • "volume_24h_coins": 36010,
      • "pcr_oi": 0.7462,
      • "pcr_volume": 1.6655,
      • "max_pain": { … 2 },
      • "contracts": 960,
      • "expiries": 12
      }
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
currency=ETH2001 msLolos
currency=SOL4001 msLolos mengembalikan error yang diharapkan

Diperiksa 2026-11-13 03:28:22 UTC

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
2m
Mikro-cache edge
10s
Frekuensi pembaruan
setiap 10 min (snapshot diganti seluruhnya)
Jendela
snapshot terbaru (volume 24h sebagaimana dilaporkan bursa)
Sumber data
Total pasar opsi yang diagregasi dari API publik satu bursa (Deribit).
Cakupan bursa
Hanya Deribit, opsi BTC dan ETH; bursa lain (opsi Binance/OKX/Bybit, CME) tidak disertakan.
Satuan
USD notional and coins (open interest, volume); ratios; USD strike (max pain)
Metode
Sums over all contracts; pcr_oi = put OI / call OI (in coins); max pain = strike minimizing total option-holder payoff for the main expiry (nearest expiry holding >=5% of total OI, else the largest).
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:52:56 UTCHTTP 20075 msSkema sesuaiTitik data terbaru berusia 3m

Ketersediaan, 30 hari terakhir

99.75% dari 408 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/options/overviewTersedia
Parameter

string · default BTC — Underlying: `BTC` or `ETH`. Any other value returns 400 `INVALID_PARAM`. Alias: `coin`.

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