加密货币 ETF

查询加密货币 ETF 汇总、基金明细及币种级历史净资金流。

GET/api/v1/crypto-etf
数据域
持仓与资金流
解析层级
asset-level
MCP 工具
ownership_flows_query (task=crypto_etf)

可查询数据

查看比特币、以太坊等加密货币相关 ETF 的最新表现与历史资金变化。

  • 币种概览:查看相关 ETF 的数量、基金代码,以及最新成交量、资产管理规模(AUM)和市值汇总。
  • 基金详情:查看某只 ETF 的最新价格、成交量、资产管理规模、市值、溢价率和费率。
  • 历史趋势:选择一段日期,查看该币种相关 ETF 每天的净资金流入或流出、资产管理规模及其占币种市值的比例。
  • 历史数据按币种汇总,暂不支持单只 ETF 的历史查询;缺失数据不按零计算。

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

资产定位与筛选

至少提供 asset_id、query、ticker、symbol 中一项,并定位同一唯一资产;不传日期返回最新 summary/detail,传入完整日期范围返回 history。

asset_idstringquery示例asset_btc条件必须

资产标识,标识股票、加密资产等资产对象

querystringquery示例BTC条件必须

资产名称、符号或别名。

tickerstringquery示例BTC条件必须

加密资产代码,不是 ETF 代码。

symbolstringquery示例BTC条件必须

资产符号,精确匹配且不区分大小写。

etf_tickerstringquery示例IBIT可选

ETF 代码,转大写后精确匹配;仅支持无日期的最新单基金查询,不能与日期参数同时传入。

历史日期范围

两个日期均不传时查询最新数据;查询历史时必须同时填写两个日期,包含首尾日期,最多366个自然日。

start_datestringquery示例2026-10-01条件必须

历史开始日期,YYYY-MM-DD,包含当天;传入时必须同时提供 end_date。

end_datestringquery示例2026-10-14条件必须

历史结束日期,YYYY-MM-DD,包含当天;须不早于 start_date,两个日期必须同时提供。

响应

codeinteger示例0

业务状态码,成功为 0。

messagestring示例success

结果说明。

dataobject

解析后的资产、ETF明细或汇总及历史序列。

asset_idstring示例asset_btc

资产标识,标识股票、加密资产等资产对象

symbolstring示例BTC

资产符号。

modestring示例history

summary:最新币种汇总;detail:最新单基金明细;history:指定日期范围的币种日历史。

currencystring示例USD

固定 USD。

etfobject | null

仅 detail 返回基金对象;summary、history 时为 null。

etf_tickerstring

ETF 代码,仅最新单基金明细。

fund_namestring

基金名称。

pricedecimal string | null

ETF 价格,USD;十进制字符串,缺失时为 null。

volumedecimal string | null

成交量,USD;十进制字符串,缺失时为 null。

aumdecimal string | null

资产管理规模,USD;十进制字符串,缺失时为 null。

market_capdecimal string | null

市值,USD;十进制字符串,缺失时为 null。

premium_pctdecimal string | null

溢价率,百分比字符串;1.25 表示 1.25%。

net_fee_pctdecimal string | null

净费率,百分比字符串;0.25 表示 0.25%。

typestring | null

源站基金类型,例如 Spot、Futures。

source_urlstring

数据来源页面 URL。

source_updated_atdatetime | null

源站更新时间,ISO 8601 UTC;源站未提供时为 null。

crawled_atdatetime

最近成功采集时间,ISO 8601 UTC。

summaryobject | null

仅 summary 返回原有最新汇总;detail、history 时为 null,不存放历史统计。

etf_countinteger

关联 ETF 数量,按 ETF ID 去重;包含金额缺失的 ETF。

etf_tickersstring[]

关联 ETF 代码,去重后升序排列。

total_volumedecimal string | null

成交量汇总,USD;忽略 null,全缺失时为 null。

total_aumdecimal string | null

AUM 汇总,USD;忽略 null,全缺失时为 null。

total_market_capdecimal string | null

市值汇总,USD;忽略 null,全缺失时为 null。

valid_countsobject

各指标参与汇总的非空记录数。

volumeinteger

参与汇总的非空记录数。

auminteger

参与汇总的非空记录数。

market_capinteger

参与汇总的非空记录数。

crawled_atdatetime | null

最近成功采集时间,ISO 8601 UTC。

points[]object[]

币种级日历史;history 模式按起止日期过滤并升序返回,无记录为空数组,不补0。

stat_datedate示例2026-10-12

源站统计日期,YYYY-MM-DD。

aumdecimal string | null示例100000000000

资产管理规模,USD;十进制字符串,缺失时为 null。

net_flowdecimal string | null示例100000000

当日净资金流,USD;正值流入,负值流出,非累计值,不使用 AUM 日差替代。

aum_pctdecimal string | null示例6.40

AUM 占币种市值的百分比;6.47 表示 6.47%。

错误与降级

400
缺少资产条件、条件冲突或歧义;日期未成对提供、为空或无效、起点晚于终点、超过366天,或日期与 etf_ticker 同时传入。错误沿用 code/message/data 信封,data=null。
404
资产不存在,或指定 ETF 不属于该资产。
401
API Key 缺失或无效。
403
API Key 无访问权限。
429
请求频率超限。
503
数据库读取失败,不作为成功空数据返回。