Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt

Use this file to discover all available pages before exploring further.

已暴露为 MCP 工具：etf_lookup —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线   免费 · 0 credit

​
它为 Agent 做什么

etf_lookup 返回单只美国上市 ETF 的 基本信息（名称、issuer、资产类型、分类）、SEC 注册信息（CIK / Series / Class）、最近一份监管披露快照和汇总信息 —— top holdings 摘要、行业 / 国家 / 资产类型分布。是 agent 拿 ETF 上下文的入口接口：想知道一只 ETF 是什么、大致持仓什么、或者在不在覆盖范围内，先调它。 它不是 OHLCV 接口。要 ETF 价格历史请用 equity_historical_prices —— ETF 价格走和股票一样的日线接口。它也不是 issuer 当日 / intraday 持仓数据源：返回的是 ETF 在 SEC 上申报的最近一份监管披露快照，不等于 issuer 内部当日底仓。 不在覆盖范围的 ticker（如当前的 IBIT / DRAM）也会返回 200 OK，coverage_status="unsupported" + 明确的 coverage_notice，让 agent 继续推理，不静默返回空。

​
返回值

​
data
EtfLookupResult
required
​
meta.creditsUsed
number
固定 0 —— lookup 免费。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · etf_lookup（supported）
{
  "data": {
    "ticker": "SPY",
    "fund_name": "SPDR S&P 500 ETF Trust",
    "issuer": "State Street",
    "asset_class": "equity",
    "category": "Large Blend",
    "cik": "0000884394",
    "series_id": "S000004310",
    "class_id": "C000012075",
    "expense_ratio": 0.0945,
    "aum": null,
    "nav": null,
    "market_price": null,
    "premium_discount_pct": null,
    "inception_date": "1993-01-22",
    "holdings_count": 503,
    "top_holdings": [
      { "ticker": "AAPL", "holding_name": "APPLE INC", "weight": 0.071 },
      { "ticker": "MSFT", "holding_name": "MICROSOFT CORP", "weight": 0.065 }
    ],
    "sector_exposure": [
      { "sector": "Information Technology", "weight": 0.297 },
      { "sector": "Financials", "weight": 0.135 }
    ],
    "country_exposure": [{ "country": "US", "weight": 0.99 }],
    "asset_type_exposure": [{ "asset_type": "equity", "weight": 0.995 }],
    "source": "sec_nport",
    "source_url": "https://www.sec.gov/files/dera/data/form-n-port-data-sets/2019q4_nport.zip#FUND_REPORTED_HOLDING.tsv",
    "as_of_date": "2019-09-30",
    "fetched_at": "2026-05-12T03:14:00Z",
    "stale": false,
    "coverage_status": "full",
    "coverage_notice": "Latest available SEC regulatory disclosure snapshot. Not the issuer's daily latest holdings."
  },
  "meta": { "creditsUsed": 0, "remainingCredits": 100 }
}
200 OK · etf_lookup（不在覆盖范围）
{
  "data": {
    "ticker": "IBIT",
    "fund_name": null,
    "issuer": null,
    "asset_class": null,
    "category": null,
    "cik": null,
    "series_id": null,
    "class_id": null,
    "expense_ratio": null,
    "aum": null,
    "nav": null,
    "market_price": null,
    "premium_discount_pct": null,
    "inception_date": null,
    "holdings_count": null,
    "top_holdings": null,
    "sector_exposure": null,
    "country_exposure": null,
    "asset_type_exposure": null,
    "source": "sec_nport",
    "source_url": null,
    "as_of_date": null,
    "fetched_at": null,
    "stale": false,
    "coverage_status": "unsupported",
    "coverage_notice": "IBIT is not in the current covered ETF list. As a spot Bitcoin trust, its SEC disclosure path differs from the conventional ETFs we cover today; we may add a dedicated path later."
  },
  "meta": { "creditsUsed": 0, "remainingCredits": 100 }
}

​
Coverage 语义

coverage_status含义stale
fullTicker 在覆盖列表内；核心字段和持仓快照可用。false（通常）
partialTicker 在覆盖列表内，但部分字段缺失 —— 受影响字段返回 null。false / true
stale快照曾经可用，但最近一次刷新失败或超过 fresh 窗口，返回旧缓存。true
unsupportedTicker 不在当前覆盖列表内。返回 200 OK + 明确 notice —— 不静默返回空。false
把 coverage_status 当 contract 用：agent 应该先按它分支，再消费下游字段。

​
说明

配合 etf_holdings 使用：当 agent 需要完整持仓列表、详细权重、或要计算两只 ETF 的 overlap 时再调 holdings。etf_lookup 已经返回 top_holdings 摘要；只有 top-N 不够用时才升级到 etf_holdings。
ETF 的 价格历史不要调这个接口 —— 用 equity_historical_prices 配合 ETF ticker。ETF OHLCV 走和股票一样的日线 contract。
lookup 免费（0 credit），但调用仍会写 usage log。可以放心当 coverage probe 用，在花 credit 调 holdings 之前先探一次。

​
当前限制

覆盖范围有限。目前覆盖一批精选热门 ETF（如 SPY、QQQ、VTI、SOXX、ARKK）。不在覆盖范围的 ticker 返回 coverage_status="unsupported"，不静默返回空。我们不承诺覆盖整个美国 ETF 市场。
监管披露快照，不是每日数据。持仓和 exposure 来自 SEC 官方监管披露公开数据集，发布有几十天到 60 天延迟。as_of_date 是该次申报对应的报告日，不是”今天的持仓”。
IBIT / DRAM 当前不在覆盖范围。前者是现货 BTC trust，其 SEC 披露路径与我们当前覆盖的传统 ETF 不同；后者在我们当前数据样本里没有可信的映射。当前请预期 coverage_status="unsupported"。
不解析 issuer PDF。Issuer fact-sheet PDF 不在数据源范围内。expense_ratio / aum / nav / market_price / premium_discount_pct 可能为 null。

​
直接调用

// 支持的 ticker
{
  "method": "tools/call",
  "params": {
    "name": "etf_lookup",
    "arguments": { "ticker": "SPY" }
  }
}

// 不支持的 ticker —— 200 OK，coverage_status="unsupported"
{
  "method": "tools/call",
  "params": {
    "name": "etf_lookup",
    "arguments": { "ticker": "IBIT" }
  }
}

​
完整参数参考

​
ticker
string
required
美国上市 ETF ticker（如 SPY、QQQ、VTI、SOXX、ARKK）。大小写不敏感；服务端会 uppercase 并 trim。只接受 A-Z、0-9、.、-。不在覆盖范围的 ticker 返回 200 OK，coverage_status="unsupported"。

​
相关接口

ETF Holdings

单只 ETF 的完整持仓列表，按权重降序，可分页。

美股历史日线

ETF 价格历史走 equity 日线 contract。

MCP Server 接入

60 秒接入 Claude / Cursor / 任意 agent harness。