面向 AI 智能体的现货 ETF 数据 API
一个 API 获取比特币与以太坊现货 ETF 数据:19 只美国现货 ETF 的官方基本面,逐个发行方提供:流通份额、资产净值、持币量与净资产。无需逐只基金收集和解析监管文件:一个密钥、一种格式、覆盖全部基金。
19 只美国现货 ETF 的官方基本面(10 只比特币、9 只以太坊),按发行方列出。全市场数据:这些接口不接受交易对。
#面向 AI 智能体与 LLM 的现货 ETF 数据
“美国现货 ETF 持有多少比特币?”“哪家发行方的以太坊 ETF 最大?”“IBIT 的净资产如何变化?”:AI 智能体通过 MCP 工具 get_options_data(提供按资产划分的数据族)用 19 只基金的官方基本面作答。
{
"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 基本面
此接口的全部 11 个字段(取自接口契约)
time | ISO 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. |
ticker | ETF ticker. | |
issuer | ETF issuer. | |
shares_outstanding | shares | ETF shares outstanding. |
nav_per_share_usd | USD | Net asset value per share. |
net_assets_usd | USD | Net assets (AUM). |
form | SEC form type of the filing (`10-Q`, `10-K`...). | |
filed_date | calendar date (YYYY-MM-DD) | Filing date at the SEC. |
filing_url | Link to the filing on SEC EDGAR. | |
holdings | units 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. |
此接口的全部 12 个字段(取自接口契约)
time | ISO 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. |
ticker | ETF ticker. | |
issuer | ETF issuer. | |
shares_outstanding | shares | ETF shares outstanding. |
nav_per_share_usd | USD | Net asset value per share. |
net_assets_usd | USD | Net assets (AUM). |
form | SEC form type of the filing (`10-Q`, `10-K`...). | |
filed_date | calendar date (YYYY-MM-DD) | Filing date at the SEC. |
filing_url | Link to the filing on SEC EDGAR. | |
holdings | units 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 中,以该部分资产为单位。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
asset | string | 必填 | BTC 或 ETH。必填:缺少或填入其他任何值时,返回 422 并列出可接受的值。 |
ticker | string | — | 用于历史接口:按代码筛选单个发行方(例如 IBIT)。 |
since_ms / until_ms | integer | — | 用于历史接口:按资产负债表日期(time)设定的边界,以毫秒为单位。 |
limit | integer | 100 | 历史接口上为 1 到 1000。 |
# 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"| 字段 | 类型 | 说明 |
|---|---|---|
ticker | string | ETF 代码。 |
issuer | string | 发行方。 |
time | string | 申报文件的资产负债表截止日期(持仓所对应的日期),UTC 零点;若申报文件未给出,则取所涵盖期间的结束日。时间范围、分页和排序均使用这一时刻。 |
shares_outstanding | float | 流通份额数。 |
nav_per_share_usd | float | 每份资产净值,以美元计。 |
net_assets_usd | float | 净资产,以美元计。 |
holdings | float | null | 持有的资产数量:比特币部分以 BTC 计,以太坊部分以 ETH 计。 |
is_holdings_estimated | boolean | 若持仓为估算值而非申报数字,则为 true。 |
form, filed_date, filing_url | string | 所提交的表格类型、提交日期以及原始文件的链接。 |