GETTersedia
Matriks open interest
Matriks open interest (koin × bursa)
GET
/api/oi/matrixPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| limit | integer | Opsional | 100 | ≤ 500 | Jumlah baris yang dikembalikan. Contoh: 100 |
Contoh permintaan
curl -s "https://www.coinboss.com/api/oi/matrix?limit=100"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.
| Kolom | Tipe | Satuan | Deskripsi |
|---|---|---|---|
| success | boolean | — | true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`. |
| now | number | ms | Waktu server saat respons disusun. |
| scope | string | — | Lingkup kontrak matriks; selalu `all_contracts` (perpetual bermargin USDT, USDC, dan koin, kontrak berjangka dengan jatuh tempo, dan CME). |
| exchanges | array | — | Bursa. |
| exchanges[] | string | — | Bursa. |
| count | number | — | Jumlah item. |
| data | array | — | Payload. |
| data[] | object | — | Payload. |
| data[].base | string | — | Simbol aset dasar. |
| data[].oi | object | — | Open interest. |
| data[].oi.aster | number | — | Nilai untuk bursa `aster` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.backpack | number | — | Nilai untuk bursa `backpack` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.binance | number | — | Nilai untuk bursa `binance` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.bingx | number | — | Nilai untuk bursa `bingx` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.bitfinex | number | — | Nilai untuk bursa `bitfinex` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.bitget | number | — | Nilai untuk bursa `bitget` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.bybit | number | — | Nilai untuk bursa `bybit` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.cme | number | — | Nilai untuk bursa `cme` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.cryptocom | number | — | Nilai untuk bursa `cryptocom` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.deribit | number | — | Nilai untuk bursa `deribit` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.dydx | number | — | Nilai untuk bursa `dydx` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.edgex | number | — | Nilai untuk bursa `edgex` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.gate | number | — | Nilai untuk bursa `gate` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.htx | number | — | Nilai untuk bursa `htx` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.hyperliquid | number | — | Nilai untuk bursa `hyperliquid` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.kraken | number | — | Nilai untuk bursa `kraken` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.kucoin | number | — | Nilai untuk bursa `kucoin` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.lighter | number | — | Nilai untuk bursa `lighter` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.mexc | number | — | Nilai untuk bursa `mexc` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.okx | number | — | Nilai untuk bursa `okx` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.paradex | number | — | Nilai untuk bursa `paradex` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].oi.whitebit | number | — | Nilai untuk bursa `whitebit` (kuncinya adalah ID bursa). bisa tidak ada |
| data[].total_usd | number | USD | Total. |
| data[].change_24h_pct | number | % | Perubahan persentase 24h. |
| data[].price | number|null | — | Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain). |
| data[].exchange_count | number | — | Jumlah bursa. |
| data[].oi.tradexyz | number | USD | Open interest koin di bursa dengan ID `tradexyz`; kunci di bawah `oi` adalah ID bursa, dan kunci yang tidak ada berarti tidak ada data segar. bisa tidak ada |
Dihasilkan 2026-11-11 23:00 UTC dari 1 respons nyata.
Contoh respons
/api/oi/matrix?limit=100 · Respons nyata yang direkam 2026-11-13 03:57:41 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data berisi 100 item; exchanges berisi 23 item.
- "success"true
- "now"1794542261527
- "scope""all_contracts"
- "exchanges"
- "binance"
- "cme"
- "okx"
- "bybit"
- "bitget"
- "gate"
- "htx"
- "bitfinex"
- "count"2257
- "data"
Detail
- Autentikasi
- Tidak ada. Endpoint publik.
- Batas permintaan
- 1200 permintaan per menit per IP
- Cache server
- 30s
- Mikro-cache edge
- 10s
- Frekuensi pembaruan
- setiap 60 s untuk sebagian besar bursa (ditulis bersama ticker; 50 teratas binance dan okx memiliki job khusus 60 s); penyapuan penuh binance / bingx / aster / gate / htx setiap 5 min; kontrak bermargin koin / USDC / berjangka setiap 120 s (dipromosikan ke tabel bersama setiap 5 min); cme sekali per hari perdagangan (04:10 UTC); baseline 24 h dari arsip per jam
- Jendela
- snapshot terbaru; perubahan 24 h dibandingkan bucket per jam yang terdekat dengan now - 24 h
- Sumber data
- Open interest yang di-polling oleh kolektor internal dari API REST publik 22 bursa derivatif (mis. binance, okx, bybit, gate, bitget, hyperliquid) ditambah laporan harian resmi volume/open interest CME.
- Cakupan bursa
- 23 sumber dengan baris segar (22 bursa + cme); semua jenis kontrak (linear USDT / USDC / USD, inverse bermargin koin, perpetual dan berjangka); bybit dan gate melaporkan open interest dua sisi sebagaimana diungkapkan bursa; baris yang lebih lama dari 3 h (cme: 120 h) dikecualikan
- Paginasi
- limit (default 100, maks 500)
- Pengurutan
- total_usd, menurun
- Satuan
- open interest in USD notional per exchange; change_24h_pct in percent; price in USD
- Metode
- total_usd = SUM(oi_usd) over all fresh contracts of the coin (multiplier contracts such as 1000PEPE folded); change_24h_pct = (cur - prev) / prev x 100 using only exchanges present in both snapshots; contracts whose archived value is frozen for 3 consecutive hours are excluded from both sides
- Stempel waktu
- Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
- Format respons
- json
- Stabilitas
- Stabil
Status langsung
TersediaDiperiksa 2026-11-13 03:57:41 UTCHTTP 200137 msSkema sesuai
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 →
| Kode | HTTP | Arti | Tindakan |
|---|---|---|---|
| INVALID_PARAM | 400 | Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui. | Jangan mengulang tanpa perubahan; perbaiki permintaannya. |
| UNAUTHORIZED | 401 | Header `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. |
| FORBIDDEN | 403 | Rute ini bukan bagian dari API publik (internal atau khusus akun). | Jangan mengulang. |
| NOT_FOUND | 404 | Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada. | Jangan mengulang; periksa path dan pengenal terhadap katalog. |
| RATE_LIMITED | 429 | Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu. | Tunggu selama `Retry-After`, lalu ulangi dengan backoff. |
| INTERNAL | 500 | Error 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_FAILED | 503 | Sumber 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. |
| UNAVAILABLE | 501 / 503 | Dataset 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_FAILED | 200 | Beberapa 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/oi/matrixTersediaParameter
integer · default 100 · maks 500 — Number of rows to return.
URL permintaan
https://www.coinboss.com/api/oi/matrix?limit=100Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.
Lainnya di kategori ini
- Open interest untuk satu koin /api/sd/oi
- Peringkat open interest per koin lintas bursa /api/market/open-interest
- Deret grafik OI bertumpuk untuk satu koin /api/oi/chart
- Riwayat open interest agregat untuk satu koin /api/oi/history
- Matriks open interest /api/oi/matrix
- Ringkasan open interest untuk satu koin /api/oi/summary