Detail satu ETF
Detail satu ETF (profil dan riwayat arus)
/api/etf/fund/:tickerPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| ticker path | string | Wajib | — | — | Ticker dana (hanya huruf, diubah ke huruf besar); 404 jika tidak dikenal. Contoh: IBIT |
Parameter bertanda “path” merupakan bagian dari URL.
Contoh permintaan
curl -s "https://www.coinboss.com/api/etf/fund/IBIT"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 }`. |
| ticker | string | — | Ticker dana. |
| asset | string | — | Simbol aset. |
| issuer | string | — | Penerbit dana. |
| price | object | — | Harga terakhir dalam mata uang kuotasi (USD atau USDT kecuali dinyatakan lain). |
| price.currency | string | — | Simbol mata uang / aset. |
| price.latest | object | — | Catatan terbaru. |
| price.latest.date | string | — | Tanggal kalender (UTC). |
| price.latest.close | number | — | Harga penutupan periode tersebut. |
| price.latest.open | number | — | Harga pembukaan periode tersebut. |
| price.latest.high | number | — | Harga tertinggi periode tersebut. |
| price.latest.low | number | — | Harga terendah periode tersebut. |
| price.latest.volume | number | — | Volume. |
| price.change_abs | number | USD | Penutupan harian terbaru saham dana dikurangi penutupan hari perdagangan sebelumnya. |
| price.change_pct | number | % | Perubahan persentase. |
| price.week52_high | number | USD | Harga tertinggi harian paling tinggi saham dana selama 365 hari kalender hingga tanggal harga terbaru. |
| price.week52_low | number | USD | Harga terendah harian paling rendah saham dana selama 365 hari kalender hingga tanggal harga terbaru. |
| price.avg_volume_10d | number | shares | Rata-rata volume perdagangan harian dana selama 10 hari perdagangan terakhir, dalam jumlah saham. |
| price.count | number | — | Jumlah item. |
| price.data | array | — | Payload. |
| price.data[] | object | — | Payload. |
| price.data[].date | string | — | Tanggal kalender (UTC). |
| price.data[].open | number | — | Harga pembukaan periode tersebut. |
| price.data[].high | number | — | Harga tertinggi periode tersebut. |
| price.data[].low | number | — | Harga terendah periode tersebut. |
| price.data[].close | number | — | Harga penutupan periode tersebut. |
| price.data[].volume | number | — | Volume. |
| fund | object | — | Nilai snapshot tingkat dana; masing-masing adalah nilai terakhir yang diketahui dan bisa berasal dari hari yang berbeda (lihat `aum_as_of`). |
| fund.aum_usd_million | number | million USD | Aset kelolaan dana terbaru yang tidak null, berlaku per `aum_as_of`. |
| fund.aum_as_of | string | — | Hari perdagangan (YYYY-MM-DD) yang dirujuk `aum_usd_million`. |
| fund.estimated_holdings | number | coin | Estimasi koin yang dimiliki dana: AUM terakhir yang diketahui ÷ harga spot aset saat ini; estimasi, bukan kepemilikan yang dilaporkan penerbit. |
| fund.fee_pct | number | % | Biaya pengelolaan tahunan dana dalam persen (0.25 = 0.25 % per tahun); nilai terakhir yang diketahui dari sumber pihak ketiga. |
| fund.mkt_share_pct | number | % | AUM dana sebagai persentase dari total kapitalisasi pasar koin dasarnya (bukan pangsanya di antara ETF); nilai pihak ketiga terakhir yang diketahui. |
| fund.volume_usd_million | number | million USD | Volume perdagangan dana pada hari terakhir sumber pihak ketiga melaporkannya. |
| fund.cum_inflow_official_million | number | million USD | Arus masuk bersih kumulatif sejak peluncuran sebagaimana dipublikasikan sumber pihak ketiga (nilai terakhir yang diketahui); dapat berbeda dari hasil penjumlahan `flows.latest.cum_total`. |
| flows | object | — | Riwayat arus bersih harian dana beserta total berjalan; jumlahnya dalam juta USD (`unit`). |
| flows.unit | string | — | Satuan nilai dalam objek ini. |
| flows.latest | object | — | Catatan terbaru. |
| flows.latest.date | string | — | Tanggal kalender (UTC). |
| flows.latest.flow | number | — | Arus penciptaan / penebusan bersih pada hari tersebut. |
| flows.latest.cum_total | number | — | Total kumulatif. |
| flows.latest.sum_7d | number | — | Jumlah 7 hari. |
| flows.count | number | — | Jumlah item. |
| flows.data | array | — | Payload. |
| flows.data[] | object | — | Payload. |
| flows.data[].date | string | — | Tanggal kalender (UTC). |
| flows.data[].flow | number | — | Arus penciptaan / penebusan bersih pada hari tersebut. |
| flows.data[].cum | number | — | Arus bersih kumulatif sejak pencatatan. |
| premium | object | — | Premium (+) atau diskon (−) harga pasar terhadap NAV. |
| premium.unit | string | — | Satuan nilai dalam objek ini. |
| premium.note | string | — | Catatan. |
| premium.count | number | — | Jumlah item. |
| premium.data | array | — | Payload. |
| premium.data[] | object | — | Payload. |
| premium.data[].date | string | — | Tanggal kalender (UTC). |
| premium.data[].premium | number | — | Premium (+) atau diskon (−) harga pasar terhadap NAV. |
Dihasilkan 2026-11-11 23:00 UTC dari 1 respons nyata.
Contoh respons
/api/etf/fund/IBIT · Respons nyata yang direkam 2026-11-13 04:02:51 UTC. Array dan map yang panjang dipersingkat untuk tampilan: flows.data berisi 712 item; price.data berisi 713 item; premium.data berisi 64 item.
- "success"true
- "ticker""IBIT"
- "asset""BTC"
- "issuer""BlackRock"
- "price"
- "currency""USD"
- "latest"
- "change_abs"-1.88
- "change_pct"-4.4508
- "week52_high"59.56
- "week52_low"32.84
- "avg_volume_10d"52099530
- "count"713
- "data"
- "fund"
- "aum_usd_million"62297.756
- "aum_as_of""2026-11-11"
- "estimated_holdings"905689.4173
- "fee_pct"0.25
- "mkt_share_pct"3.995
- "volume_usd_million"2604.817
- "cum_inflow_official_million"65711.051
- "flows"
- "unit""million_usd"
- "latest"
- "count"712
- "data"
- "premium"
- "unit""pct"
- "note""sparse_snapshot"
- "count"64
- "data"
Detail
- Autentikasi
- Tidak ada. Endpoint publik.
- Batas permintaan
- 1200 permintaan per menit per IP
- Cache server
- 5m
- Mikro-cache edge
- 10s
- Frekuensi pembaruan
- setiap jam (harga pada menit 20, arus pada menit 15); bar harian
- Jendela
- riwayat harga dan arus harian yang tersimpan; tertinggi/terendah 52 minggu dan volume rata-rata 10 hari
- Sumber data
- Data halaman satu dana: harga dana harian dari situs data pasar publik, arus dari pelacak arus ETF publik.
- Cakupan bursa
- 36 ticker ETF spot AS yang dilacak (404 untuk ticker yang tidak dikenal).
- Pengurutan
- tanggal, menaik
- Satuan
- USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
- Metode
- estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
- Stempel waktu
- Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
- Format respons
- json
- Stabilitas
- Stabil
Status langsung
Ketersediaan, 30 hari terakhir
100% 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 →
| 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/etf/fund/:tickerTersediastring — Fund ticker (letters only, upper-cased); 404 if unknown.
https://www.coinboss.com/api/etf/fund/IBITLainnya di kategori ini
- Dana ETF spot /api/sd/etf/funds
- Riwayat ETF spot /api/sd/etf/history
- Ikhtisar ETF spot (pengungkapan penerbit) /api/sd/etf/overview
- Arus bersih harian ETF spot per dana /api/etf/detail
- Riwayat arus bersih harian ETF spot /api/etf/flows
- Detail satu ETF /api/etf/fund/:ticker
- Daftar dana ETF /api/etf/funds
- Kepemilikan koin ETF per dana /api/etf/holdings
- Produk ETF / trust dari satu penerbit /api/etf/issuer
- Ikhtisar ETF /api/etf/overview
- Premium / diskon trust Grayscale /api/grayscale/premium
- Volume ETF berbasis futures /api/indicators/futures-etf-volumes