Kepemilikan koin ETF per dana
Kepemilikan koin ETF per dana
/api/etf/holdingsPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| asset | string | Opsional | BTC | BTC, ETH, SOL, HYPE | Aset dasar. Nilai lain mengembalikan 400 `INVALID_PARAM`. Contoh: BTC |
Contoh permintaan
curl -s "https://www.coinboss.com/api/etf/holdings?asset=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.
| Kolom | Tipe | Satuan | Deskripsi |
|---|---|---|---|
| success | boolean | — | true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`. |
| asset | string | — | Simbol aset. |
| unit | string | — | Satuan nilai dalam objek ini. |
| count | number | — | Jumlah item. |
| latest | object | — | Catatan terbaru. |
| latest.date | string | — | Tanggal kalender (UTC). |
| latest.holdings | number | — | Jumlah koin yang dipegang dana. |
| latest.aum_pct_of_mcap | number | % | AUM gabungan ETF spot aset tersebut sebagai persentase dari kapitalisasi pasar koin, pada tanggal terbaru di `data`. |
| data | array | — | Payload. |
| data[] | object | — | Payload. |
| data[].date | string | — | Tanggal kalender (UTC). |
| data[].holdings | number | — | Jumlah koin yang dipegang dana. |
| data[].aum_pct_of_mcap | number | % | AUM gabungan ETF spot aset tersebut sebagai persentase dari kapitalisasi pasar koin pada tanggal itu, dari sumber pihak ketiga. |
Dihasilkan 2026-11-11 23:00 UTC dari 1 respons nyata.
Contoh respons
/api/etf/holdings?asset=BTC · Respons nyata yang direkam 2026-11-13 03:58:19 UTC. Array dan map yang panjang dipersingkat untuk tampilan: data berisi 64 item.
- "success"true
- "asset""BTC"
- "unit""token_count"
- "count"64
- "latest"
- "date""2026-10-08"
- "holdings"1282351.4417
- "aum_pct_of_mcap"6.3813
- "data"
Detail
- Autentikasi
- Tidak ada. Endpoint publik.
- Batas permintaan
- 1200 permintaan per menit per IP
- Cache server
- 5m
- Mikro-cache edge
- 10s
- Frekuensi pembaruan
- kolektor berjalan setiap jam, tetapi sumber hulu telah dinonaktifkan sejak 2026-10-08
- Jendela
- seluruh riwayat harian yang tersimpan (berakhir 2026-10-08)
- Sumber data
- Total koin yang dipegang semua ETF spot AS untuk suatu aset, dari situs data ETF pihak ketiga.
- Cakupan bursa
- BTC, ETH, SOL (sebagaimana tersimpan); tidak ada data setelah 2026-10-08.
- Pengurutan
- tanggal, menaik
- Satuan
- holdings in coins (token count); aum_pct_of_mcap in percent
- Stempel waktu
- Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
- Format respons
- json
- Stabilitas
- Stabil
Status langsung
Titik data terbaru berumur 3124699 s (seharusnya dalam 345600 s)
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/etf/holdingsTerdegradasistring · default BTC — Underlying asset. Any other value returns 400 `INVALID_PARAM`.
https://www.coinboss.com/api/etf/holdings?asset=BTCLainnya 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