24h成交量—未平倉—24h爆倉$1.36B24h多空比—BTC市佔—ETH市佔—
App
語言 ▾
NT$ TWD ▾
/api/etf/fund/:ticker
GET可用

單一 ETF 詳情

單一 ETF 詳情（概況與資金流歷史）

GET/api/etf/fund/:ticker

請求

查詢參數

名稱型別必填預設值可用值說明
ticker pathstring必填——基金代號（僅限字母，會轉為大寫）；未知時回傳 404。 範例: IBIT

標示為「path」的參數屬於 URL 的一部分。

請求範例

curl -s "https://www.coinboss.com/api/etf/fund/IBIT"

回應欄位

欄位表由真實回應產生，因此列出的正是端點實際回傳的內容。路徑中的 a[] 代表陣列元素，{*} 代表以動態名稱（例如幣種或交易所）為鍵的物件。

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
tickerstring—基金代號。
assetstring—資產代號。
issuerstring—基金發行商。
priceobject—以計價貨幣表示的最新價格（除非另有註明，否則為 USD 或 USDT）。
price.currencystring—貨幣／資產代號。
price.latestobject—最近一筆紀錄。
price.latest.datestring—日曆日期（UTC）。
price.latest.closenumber—該期間的收盤價。
price.latest.opennumber—該期間的開盤價。
price.latest.highnumber—該期間的最高價。
price.latest.lownumber—該期間的最低價。
price.latest.volumenumber—成交量。
price.change_absnumberUSD基金份額最新的每日收盤價減去前一個交易日的收盤價。
price.change_pctnumber%漲跌幅（百分比）。
price.week52_highnumberUSD截至最新價格日期為止的 365 個日曆日內，基金份額的最高單日最高價。
price.week52_lownumberUSD截至最新價格日期為止的 365 個日曆日內，基金份額的最低單日最低價。
price.avg_volume_10dnumbershares基金過去 10 個交易日的日均成交量，以份額計。
price.countnumber—項目數。
price.dataarray—回應主體資料。
price.data[]object—回應主體資料。
price.data[].datestring—日曆日期（UTC）。
price.data[].opennumber—該期間的開盤價。
price.data[].highnumber—該期間的最高價。
price.data[].lownumber—該期間的最低價。
price.data[].closenumber—該期間的收盤價。
price.data[].volumenumber—成交量。
fundobject—基金層級的快照數值；每一項都是最後已知的數值，日期可能各不相同（見 `aum_as_of`）。
fund.aum_usd_millionnumbermillion USD基金最近一筆非 null 的資產管理規模，有效日期為 `aum_as_of`。
fund.aum_as_ofstring—`aum_usd_million` 所對應的交易日（YYYY-MM-DD）。
fund.estimated_holdingsnumbercoin基金持有幣數的估算值：最後已知的 AUM ÷ 該資產目前的現貨價格；此為估算值，並非發行商回報的持有量。
fund.fee_pctnumber%基金的年度管理費，以百分比表示（0.25 = 每年 0.25 %）；為取自第三方來源的最後已知數值。
fund.mkt_share_pctnumber%基金 AUM 佔標的幣種總市值的百分比（並非其在 ETF 之間的佔比）；為第三方來源的最後已知數值。
fund.volume_usd_millionnumbermillion USD第三方來源最後一次回報當日的基金成交量。
fund.cum_inflow_official_millionnumbermillion USD第三方來源公布的上市以來累計淨流入（最後已知數值）；可能與加總而得的 `flows.latest.cum_total` 不同。
flowsobject—基金的每日淨流量歷史，附累計總額；金額單位為百萬 USD（`unit`）。
flows.unitstring—此物件中數值的單位。
flows.latestobject—最近一筆紀錄。
flows.latest.datestring—日曆日期（UTC）。
flows.latest.flownumber—當日的淨申購／贖回流量。
flows.latest.cum_totalnumber—累計總額。
flows.latest.sum_7dnumber—7 天加總。
flows.countnumber—項目數。
flows.dataarray—回應主體資料。
flows.data[]object—回應主體資料。
flows.data[].datestring—日曆日期（UTC）。
flows.data[].flownumber—當日的淨申購／贖回流量。
flows.data[].cumnumber—上市以來的累計淨流量。
premiumobject—市價相對於 NAV 的溢價（+）或折價（−）。
premium.unitstring—此物件中數值的單位。
premium.notestring—備註。
premium.countnumber—項目數。
premium.dataarray—回應主體資料。
premium.data[]object—回應主體資料。
premium.data[].datestring—日曆日期（UTC）。
premium.data[].premiumnumber—市價相對於 NAV 的溢價（+）或折價（−）。

產生於 2026-11-11 23:00 UTC，依據 1 筆真實回應。

回應範例

/api/etf/fund/IBIT · 真實回應，擷取於 2026-11-13 03:58:19 UTC。 較長的陣列與對應表已截短顯示：flows.data 原有 712 個項目; price.data 原有 713 個項目; premium.data 原有 64 個項目。

  • {
    • "success": true,
    • "ticker": "IBIT",
    • "asset": "BTC",
    • "issuer": "BlackRock",
    • "price": {
      • "currency": "USD",
      • "latest": { … 6 },
      • "change_abs": -1.88,
      • "change_pct": -4.4508,
      • "week52_high": 59.56,
      • "week52_low": 32.84,
      • "avg_volume_10d": 52099530,
      • "count": 713,
      • "data": [ … 2 ]
      },
    • "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": { … 4 },
      • "count": 712,
      • "data": [ … 2 ]
      },
    • "premium": {
      • "unit": "pct",
      • "note": "sparse_snapshot",
      • "count": 64,
      • "data": [ … 2 ]
      }
    }

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
5m
邊緣微快取
10s
更新頻率
每小時（價格在第 20 分鐘，流量在第 15 分鐘）；日 K 線
時間視窗
已儲存的每日價格與流量歷史；52 週高點／低點與 10 日平均成交量
資料來源
單一基金頁面資料：每日基金價格取自公開的行情資料網站，流量取自公開的 ETF 資金流追蹤網站。
交易所覆蓋範圍
36 個追蹤中的美國現貨 ETF 代號（未知的代號回傳 404）。
排序
日期升冪
單位
USD (fund price), million USD (flows, AUM), percent (premium, fee), coins (estimated holdings)
計算方法
estimated_holdings = fund AUM in USD / latest coin price (an estimate, not issuer-reported holdings).
時間戳記
Unix epoch 毫秒（UTC），除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

可用檢查於 2026-11-13 03:58:19 UTCHTTP 20015 ms結構描述相符最新資料點距今 28h

近 30 天可用率

410 次檢查中有 100% 通過

錯誤

所有端點的失敗回應都採用同一種結構。完整清單請見錯誤頁面。 錯誤與速率限制 →

錯誤碼HTTP意義處理方式
INVALID_PARAM400缺少必填參數，或某個值不被接受。已知時，`param` 會指出是哪個參數。請勿原樣重試；請修正請求。
UNAUTHORIZED401已送出 `CB-API-KEY` 標頭，但金鑰未知或已撤銷。公開資料不需要金鑰——請移除該標頭或改用有效的金鑰。請勿原樣重試。
FORBIDDEN403此路由不屬於公開 API（內部或僅限帳戶使用）。請勿重試。
NOT_FOUND404未知的路由，或所請求的幣種／交易所／基金不存在。請勿重試；請對照目錄檢查路徑與識別碼。
RATE_LIMITED429請求數超過每分鐘上限。`Retry-After` 會指出需等待的秒數。等待 `Retry-After` 指定的時間後，再以退避策略重試。
INTERNAL500非預期的伺服器錯誤。訊息刻意保持籠統；回報時請附上 `request_id`。幾秒後重試一次；若問題持續，請附上請求 ID 回報。
UPSTREAM_FAILED503此端點背後的資料來源未及時回應。不會以過期或替代的數字代替回傳。以退避策略重試；並查看狀態頁面。
UNAVAILABLE501 / 503資料集暫時尚未就緒（快取預熱中），或此端點目前尚無合法的公開來源。稍後重試；目錄會標示出設計上即無法使用的端點。
REQUEST_FAILED200部分舊版端點會以 HTTP 200 回應但帶有 `success: false`。請務必檢查 `success`，而不只是 HTTP 狀態碼。視訊息而定；請當作失敗的請求處理。

試用

GET/api/etf/fund/:ticker可用
參數

string — Fund ticker (letters only, upper-cased); 404 if unknown.

請求 URLhttps://www.coinboss.com/api/etf/fund/IBIT
選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。