/api/etf/funds
GETSebagian

Daftar dana ETF

Daftar dana ETF (ticker, penerbit, AUM, biaya, ...)

GET/api/etf/funds
Cakupan sebagian. Arus dan kepemilikan diperbarui setiap hari. `fee_pct`, `volume_usd`, `mkt_share_pct`, dan `cum_inflow_official` berasal dari sumber yang berhenti memublikasikan pada 2026-10-08 dan mempertahankan nilai terakhirnya sampai penggantinya aktif; jangan menganggap keempat kolom itu sebagai nilai terkini. `latest_premium_pct` bernilai `null` karena alasan yang sama. Objek `frozen_fields` di respons menyebutkan kolom-kolom ini beserta tanggal yang dirujuk setiap nilainya.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
assetstringOpsionalBTCBTC, ETH, SOL, HYPEAset dasar. Nilai lain mengembalikan 400 `INVALID_PARAM`. Contoh: BTC

Contoh permintaan

curl -s "https://www.coinboss.com/api/etf/funds?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.

KolomTipeSatuanDeskripsi
successboolean—true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`.
assetstring—Simbol aset.
unitstring—Satuan nilai dalam objek ini.
countnumber—Jumlah item.
fundsarray—Semua dana ETF spot aset tersebut, diurutkan menurun menurut `latest_aum`.
funds[]object—Satu dana beserta arus terbaru, AUM, dan atribut snapshot-nya.
funds[].tickerstring—Ticker dana.
funds[].issuerstring—Penerbit dana.
funds[].latest_datestring—Hari perdagangan terbaru (YYYY-MM-DD) yang memiliki data arus untuk dana ini; null jika dana tidak memiliki baris.
funds[].latest_flownumbermillion USDArus bersih dana pada `latest_date`; negatif = arus keluar bersih.
funds[].sum_7dnumber—Jumlah 7 hari.
funds[].cum_totalnumber—Total kumulatif.
funds[].latest_aumnumbermillion USDAset kelolaan dana pada `latest_date`; null jika tidak tersedia untuk hari itu.
funds[].latest_premium_pctnumber|null%Premium (+) atau diskon (−) harga pasar dana terhadap nilai aset bersihnya pada `latest_date`; null jika tidak tersedia untuk hari itu.
funds[].sourcestring—Asal nilai tersebut.
funds[].fee_pctnumber%Biaya pengelolaan tahunan dana dalam persen (0.25 = 0.25 % per tahun); nilai terakhir yang diketahui, lihat `frozen_fields` untuk tanggalnya.
funds[].volume_usdnumberUSDVolume dalam nosional USD.
funds[].mkt_share_pctnumber%AUM dana sebagai persentase dari total kapitalisasi pasar koin dasarnya (bukan pangsanya di antara ETF); nilai terakhir yang diketahui, lihat `frozen_fields`.
funds[].cum_inflow_officialnumbermillion USDArus masuk bersih kumulatif sejak peluncuran sebagaimana dipublikasikan sumber pihak ketiga; nilai terakhir yang diketahui, lihat `frozen_fields` untuk tanggalnya.
funds[].etf_share_pctnumber%`latest_aum` dana sebagai persentase dari jumlah `latest_aum` semua dana untuk aset yang sama.
frozen_fieldsobject—Kolom yang sumbernya berhenti diperbarui; kolom tersebut membawa nilai terakhir yang diketahui dan tidak boleh dibaca sebagai nilai terkini. `null` jika tidak ada yang beku.
frozen_fields.fieldsarray—Nama kolom-kolom yang beku.
frozen_fields.fields[]string—Nama kolom.
frozen_fields.as_ofstring—Tanggal pembaruan terakhir kolom-kolom yang beku (YYYY-MM-DD).
frozen_fields.latest_datestring—Tanggal terbaru dari kolom-kolom yang masih diperbarui (YYYY-MM-DD).
frozen_fields.detailarray—Detail.
frozen_fields.detail[]object—Detail.
frozen_fields.detail[].fieldstring—Nama kolom yang beku.
frozen_fields.detail[].as_ofstring—Tanggal pembaruan terakhir kolom ini (YYYY-MM-DD).
frozen_fields.detail[].servedstring—Yang dikembalikan API untuk kolom ini: `last_known_value` atau `null`.
frozen_fields.by_tickerobject—Per dana: tanggal pembaruan terakhir setiap kolom yang beku. kunci dinamis: IBIT,FBTC,GBTC,BTC,BITB,ARKB
frozen_fields.by_ticker.{*}object—Kolom-kolom beku satu dana, dengan nama kolom sebagai kuncinya.
frozen_fields.by_ticker.{*}.fee_pctstring%Tanggal pembaruan terakhir `fee_pct` (YYYY-MM-DD).
frozen_fields.by_ticker.{*}.volume_usdstringUSDVolume dalam nosional USD.
frozen_fields.by_ticker.{*}.mkt_share_pctstring%Tanggal pembaruan terakhir `mkt_share_pct` (YYYY-MM-DD).
frozen_fields.by_ticker.{*}.cum_inflow_officialstring—Tanggal pembaruan terakhir `cum_inflow_official` (YYYY-MM-DD).
frozen_fields.by_ticker.{*}.latest_premium_pctstring%Tanggal pembaruan terakhir `latest_premium_pct` (YYYY-MM-DD).
frozen_fields.notestring—Catatan.

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

Contoh respons

/api/etf/funds?asset=BTC · Respons nyata yang direkam 2026-11-13 03:58:19 UTC. Array dan map yang panjang dipersingkat untuk tampilan: funds berisi 13 item; frozen_fields.detail berisi 5 item; frozen_fields.by_ticker berisi 13 item.

  • {
    • "success": true,
    • "asset": "BTC",
    • "unit": "million_usd",
    • "count": 13,
    • "funds": [
      • { … 14 },
      • { … 14 }
      ],
    • "frozen_fields": {
      • "fields": [ … 5 ],
      • "as_of": "2026-10-08",
      • "latest_date": "2026-11-12",
      • "detail": [ … 2 ],
      • "by_ticker": { … 2 },
      • "note": "fields 所列字段的数据源自 as_of 之后未再更新:served=last_known_value 的字段返回的是 as_of 当日的最后已知值(不是 latest_date 的值);served=null 的字段在 latest_date 无数据、返回 null。其余字段(latest_flow/sum_7d…"
      }
    }

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 (menit 15); sumber memublikasikan sekali per hari perdagangan AS
Jendela
snapshot terbaru per dana (arus dijumlahkan selama 7 hari perdagangan dan sejak pencatatan)
Sumber data
Daftar per dana ETF kripto spot AS: arus dari pelacak arus ETF publik, AUM dari situs data pasar publik.
Cakupan bursa
Semua dana dari aset yang dipilih (BTC, ETH, SOL, HYPE).
Pengurutan
AUM terbaru, menurun
Satuan
million USD (flows, AUM); percent (premium, fee, shares)
Metode
cum_total = sum of daily flows; etf_share_pct = fund AUM / sum of AUM of all funds of the same asset x 100.
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil

Status langsung

SebagianDiperiksa 2026-11-13 03:58:19 UTCHTTP 2001 msSkema sesuaiTitik data terbaru berusia 28h

Arus dan kepemilikan diperbarui setiap hari. `fee_pct`, `volume_usd`, `mkt_share_pct`, dan `cum_inflow_official` berasal dari sumber yang berhenti memublikasikan pada 2026-10-08 dan mempertahankan nilai terakhirnya sampai penggantinya aktif; jangan menganggap keempat kolom itu sebagai nilai terkini. `latest_premium_pct` bernilai `null` karena alasan yang sama. Objek `frozen_fields` di respons menyebutkan kolom-kolom ini beserta tanggal yang dirujuk setiap nilainya.

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 →

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/etf/fundsSebagian
Parameter

string · default BTC — Underlying asset. Any other value returns 400 `INVALID_PARAM`.

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