Detail aset dasar saham
Detail aset dasar saham (kuotasi kontrak per bursa)
/api/stock-detail/:underlyingPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| underlying path | string | Wajib | — | — | Ticker aset dasar (diubah ke huruf besar); 404 jika tidak ada data. Contoh: SOXL |
Parameter bertanda “path” merupakan bagian dari URL.
Contoh permintaan
curl -s "https://www.coinboss.com/api/stock-detail/SOXL"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. |
| source | string | — | Asal nilai tersebut. |
| data | object | — | Payload. |
| data.underlying | string | — | Simbol saham / indeks / komoditas dasar. |
| data.name | string | — | Nama. |
| data.type | string | — | Tipe. |
| data.price_avg | number | — | Harga rata-rata lintas bursa. |
| data.change_24h | number | — | Perubahan 24h. |
| data.high_24h | number | — | Tertinggi 24h. |
| data.low_24h | number | — | Terendah 24h. |
| data.volume_24h | number | — | Volume 24h. |
| data.oi_usd | number | USD | Open interest dalam nosional USD. |
| data.funding_weighted | number | fraction | Rata-rata berbobot open interest dari funding rate saat ini di bursa-bursa, masing-masing per interval funding-nya sendiri; null jika tidak ada bursa yang melaporkan open interest. |
| data.exchanges | number | — | Bursa. |
| data.markets | array | — | Pasar. |
| data.markets[] | object | — | Pasar. |
| data.markets[].exchange | string | — | ID bursa, huruf kecil (misalnya `binance`). |
| data.markets[].symbol | string | — | Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT). |
| data.markets[].price | number | — | Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain). |
| data.markets[].change_pct | number|null | % | Perubahan persentase. |
| data.markets[].volume_24h | number | — | Volume 24h. |
| data.markets[].funding | number | — | Blok atau nilai funding rate. |
| data.markets[].funding_interval_h | number | h | Interval funding. |
| data.markets[].oi_usd | number|null | USD | Open interest dalam nosional USD. |
| data.long_short | array | — | Blok long/short. |
| data.long_short[] | object | — | Blok long/short. |
| data.long_short[].exchange | string | — | ID bursa, huruf kecil (misalnya `binance`). |
| data.long_short[].symbol | string | — | Simbol instrumen yang dinormalkan oleh CoinBoss (misalnya BTCUSDT). |
| data.long_short[].ratio_type | string | — | Yang dihitung rasio ini: `account` (semua akun), `topacc` (akun trader teratas), `position` (ukuran posisi), atau `taker` (volume beli vs jual taker). |
| data.long_short[].long_ratio | number | % | Pangsa long terbaru (pangsa beli taker untuk `taker`) untuk bursa dan kontrak ini; `long_ratio` + `short_ratio` = 100. |
| data.long_short[].short_ratio | number | % | Pangsa short terbaru (pangsa jual taker untuk `taker`) untuk bursa dan kontrak ini; `long_ratio` + `short_ratio` = 100. |
| data.liquidations | object | — | Likuidasi aset dasar ini (termasuk alias) lintas bursa, menurut jendela `h1`, `h4`, `h12`, `h24`, ditambah `count_24h`. |
| data.liquidations.h1 | object | — | Nilai nosional yang dilikuidasi selama 1 jam terakhir, dalam USD, dipecah menjadi `long`, `short`, dan `total`. |
| data.liquidations.h1.long | number | — | Nilai sisi long. |
| data.liquidations.h1.short | number | — | Nilai sisi short. |
| data.liquidations.h1.total | number | — | Total. |
| data.liquidations.h4 | object | — | Nilai nosional yang dilikuidasi selama 4 jam terakhir, dalam USD, dipecah menjadi `long`, `short`, dan `total`. |
| data.liquidations.h4.long | number | — | Nilai sisi long. |
| data.liquidations.h4.short | number | — | Nilai sisi short. |
| data.liquidations.h4.total | number | — | Total. |
| data.liquidations.h12 | object | — | Nilai nosional yang dilikuidasi selama 12 jam terakhir, dalam USD, dipecah menjadi `long`, `short`, dan `total`. |
| data.liquidations.h12.long | number | — | Nilai sisi long. |
| data.liquidations.h12.short | number | — | Nilai sisi short. |
| data.liquidations.h12.total | number | — | Total. |
| data.liquidations.h24 | object | — | Nilai 24 jam. |
| data.liquidations.h24.long | number | — | Nilai sisi long. |
| data.liquidations.h24.short | number | — | Nilai sisi short. |
| data.liquidations.h24.total | number | — | Total. |
| data.liquidations.count_24h | number | — | Jumlah selama 24 jam. |
| data.klines | array | — | Candlestick. |
| data.klines[] | object | — | Candlestick. |
| data.klines[].t | number | ms | Stempel waktu. |
| data.klines[].o | number | USD | Harga pembukaan candlestick harian yang dimulai pada `t` (UTC). |
| data.klines[].h | number | USD | Harga tertinggi candlestick harian yang dimulai pada `t` (UTC). |
| data.klines[].l | number | USD | Harga terendah candlestick harian yang dimulai pada `t` (UTC). |
| data.klines[].c | number | USD | Harga penutupan candlestick harian yang dimulai pada `t` (UTC); harga terbaru selama hari berjalan masih terbuka. |
| data.klines[].v | number | — | Nilai. |
Dihasilkan 2026-11-11 23:00 UTC dari 1 respons nyata.
Contoh respons
/api/stock-detail/SOXL · Respons nyata yang direkam 2026-11-13 04:03:14 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data.klines berisi 180 item; data.markets berisi 17 item; data.long_short berisi 16 item.
- "success"true
- "now"1794542594660
- "source""in-house collection"
- "data"
- "underlying""SOXL"
- "name""Direxion Semiconductor Bull 3x"
- "type""etf"
- "price_avg"63.41251867448196
- "change_24h"1.2395980314621862
- "high_24h"69.02
- "low_24h"58.4
- "volume_24h"10951946654.019999
- "oi_usd"515358908.96
- "funding_weighted"0.000009575856229677082
- "exchanges"17
- "markets"
- "long_short"
- "liquidations"
- "klines"
Detail
- Autentikasi
- Tidak ada. Endpoint publik.
- Batas permintaan
- 1200 permintaan per menit per IP
- Cache server
- 60s
- Mikro-cache edge
- 10s
- Frekuensi pembaruan
- ticker setiap 1 min; OI/funding setiap 5 min; cache API 60 s
- Jendela
- likuidasi 1h / 4h / 12h / 24h; hingga 180 candlestick harian
- Sumber data
- Detail satu aset dasar saham tertokenisasi/TradFi: kontrak per bursa, funding, OI, long/short, likuidasi, dan candlestick harian, semuanya dari data bursa yang dikumpulkan sendiri.
- Cakupan bursa
- Aset dasar dalam registri saham tertokenisasi internal; 404 jika tidak ada
- Paginasi
- tidak ada
- Satuan
- USD; funding as decimal rate per interval
- Metode
- funding_weighted = OI-weighted mean of raw rates (not normalized to 8h); quotes deviating more than 10% from the median with zero volume are dropped
- Stempel waktu
- Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
- Format respons
- json
- Stabilitas
- Stabil
Status langsung
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
/api/stock-detail/:underlyingTersediastring — Underlying ticker (upper-cased); 404 when no data.
https://www.coinboss.com/api/stock-detail/SOXLLainnya di kategori ini
- Ikhtisar likuidasi kontrak perpetual TradFi /api/liquidations/tradfi
- Daftar simbol TradFi yang mengalami likuidasi dalam jendela /api/liquidations/tradfi-asset-list
- Peringkat likuidasi per simbol untuk kontrak perpetual TradFi /api/liquidations/tradfi-assets
- Pembagian likuidasi per bursa untuk kontrak perpetual TradFi /api/liquidations/tradfi-exchanges
- Feed likuidasi kontrak perpetual TradFi /api/liquidations/tradfi-feed
- Order likuidasi terbesar pada kontrak perpetual TradFi /api/liquidations/tradfi-largest
- Total likuidasi multi-jendela untuk kontrak perpetual TradFi /api/liquidations/tradfi-overview
- Ikhtisar likuidasi untuk satu simbol TradFi /api/liquidations/tradfi-symbol
- Deret waktu likuidasi untuk satu simbol TradFi /api/liquidations/tradfi-symbol-chart
- Pembagian likuidasi per bursa untuk satu simbol TradFi /api/liquidations/tradfi-symbol-exchanges
- Likuidasi terbesar untuk satu simbol TradFi /api/liquidations/tradfi-symbol-largest
- Simbol TradFi yang memiliki riwayat likuidasi /api/liquidations/tradfi-symbols
- Tabel likuidasi TradFi /api/liquidations/tradfi-table
- Deret waktu total likuidasi kontrak perpetual TradFi /api/liquidations/tradfi-total-chart
- Kuotasi kontrak pre-IPO /api/preipo/list
- Daftar aset dasar saham /api/stock-detail-list
- Detail aset dasar saham /api/stock-detail/:underlying
- Daftar instrumen saham /api/stocks/list
- Kontrak perpetual saham / saham tertokenisasi yang terdaftar di bursa /api/tabs17/exchange-stocks
- Kuotasi saham terkait kripto /api/tabs17/stocks