市场数据

面向 AI 智能体的现货 ETF 数据 API

一个 API 获取比特币与以太坊现货 ETF 数据:19 只美国现货 ETF 的官方基本面,逐个发行方提供:流通份额、资产净值、持币量与净资产。无需逐只基金收集和解析监管文件:一个密钥、一种格式、覆盖全部基金。

19 只美国现货 ETF 的官方基本面(10 只比特币、9 只以太坊),按发行方列出。全市场数据:这些接口不接受交易对。

#面向 AI 智能体与 LLM 的现货 ETF 数据

“美国现货 ETF 持有多少比特币?”“哪家发行方的以太坊 ETF 最大?”“IBIT 的净资产如何变化?”:AI 智能体通过 MCP 工具 get_options_data(提供按资产划分的数据族)用 19 只基金的官方基本面作答。

MCP tools/call
一次 MCP 调用获取比特币现货 ETF 的基本面,按发行方列出。
{
  "name": "get_options_data",
  "arguments": {
    "asset": "BTC",
    "fields": ["etf_fundamentals"]
  }
}
  • 给 LLM 的提示:这些数字按季度发布,来自监管文件;这里没有每日净流入,回答时应说明所指的季度。
  • 给开发者:/v1/etf/fundamentals 每个资产一次调用,是你自己 AI 智能体(tool calling)的简单工具;其历史接口提供过往季度的数据。
  • 适用环境:Claude、ChatGPT、Cursor 及任何 MCP 客户端,包括支持 MCP 的 AI 智能体框架,如 LangChain 或 n8n。

通过 MCP 服务器指南接入你的 AI 智能体,或用开源的 Agent Skills 教它使用 BytNode。

#ETF 基本面

GET/v1/etf/fundamentalsdata_type · etf_fundamentals完整参考
此接口的全部 11 个字段(取自接口契约)
timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The balance-sheet date of the filing — the day the holdings, NAV and net assets are measured (end of the quarter for a 10-Q), at midnight UTC. `filed_date` says when the filing reached the SEC.
tickerETF ticker.
issuerETF issuer.
shares_outstandingsharesETF shares outstanding.
nav_per_share_usdUSDNet asset value per share.
net_assets_usdUSDNet assets (AUM).
formSEC form type of the filing (`10-Q`, `10-K`...).
filed_datecalendar date (YYYY-MM-DD)Filing date at the SEC.
filing_urlLink to the filing on SEC EDGAR.
holdingsunits of the asset (BTC for asset=BTC, ETH for asset=ETH)Crypto held by the fund, in units of the asset.
is_holdings_estimated`true` if the holdings are derived from net assets / price rather than read in the filing.
GET/v1/etf/fundamentals/historydata_type · etf_fundamentals_history完整参考
此接口的全部 12 个字段(取自接口契约)
timeISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z)The balance-sheet date of the filing — the day the holdings, NAV and net assets are measured (end of the quarter for a 10-Q), at midnight UTC. `filed_date` says when the filing reached the SEC.
tickerETF ticker.
issuerETF issuer.
shares_outstandingsharesETF shares outstanding.
nav_per_share_usdUSDNet asset value per share.
net_assets_usdUSDNet assets (AUM).
formSEC form type of the filing (`10-Q`, `10-K`...).
filed_datecalendar date (YYYY-MM-DD)Filing date at the SEC.
filing_urlLink to the filing on SEC EDGAR.
holdingsunits of the asset (BTC for asset=BTC, ETH for asset=ETH)Crypto held by the fund, in units of the asset.
is_holdings_estimated`true` if the holdings are derived from net assets / price rather than read in the filing.
is_closed`true` = the row is final; `false` = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with `?live=1` on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades.

发行方提交的官方锚定数据:份额数、资产净值、持有的加密资产和净资产,按发行方列出。共跟踪十个比特币发行方和九个以太坊发行方。

该市场数据族分两部分,由必填的 ?asset= 选择:BTC 返回十只比特币 ETF;ETH 返回九只以太坊 ETF。两部分的持仓都在 holdings 中,以该部分资产为单位。

参数类型默认值说明
assetstring必填BTC 或 ETH。必填:缺少或填入其他任何值时,返回 422 并列出可接受的值。
tickerstring—用于历史接口:按代码筛选单个发行方(例如 IBIT)。
since_ms / until_msinteger—用于历史接口:按资产负债表日期(time)设定的边界,以毫秒为单位。
limitinteger100历史接口上为 1 到 1000。
curl
# The nine Ethereum ETFs (?asset= is required: BTC or ETH)
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/etf/fundamentals?asset=ETH"

# The filing history of a single issuer
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/etf/fundamentals/history?asset=BTC&ticker=IBIT&limit=8"
字段类型说明
tickerstringETF 代码。
issuerstring发行方。
timestring申报文件的资产负债表截止日期(持仓所对应的日期),UTC 零点;若申报文件未给出,则取所涵盖期间的结束日。时间范围、分页和排序均使用这一时刻。
shares_outstandingfloat流通份额数。
nav_per_share_usdfloat每份资产净值,以美元计。
net_assets_usdfloat净资产,以美元计。
holdingsfloat | null持有的资产数量:比特币部分以 BTC 计,以太坊部分以 ETH 计。
is_holdings_estimatedboolean若持仓为估算值而非申报数字,则为 true。
form, filed_date, filing_urlstring所提交的表格类型、提交日期以及原始文件的链接。