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 工具：sec_filing_read —— 在 Claude / Cursor / 任意 MCP 客户端中直接调用。详见 MCP Server 60 秒配置。
已上线   每次 1 credit

​
它为 Agent 做什么

sec_filing_read 是 SEC Filing progressive disclosure 模式的第二步：在 sec_filing_browse 拿到某 ticker 的 filing 列表之后，用本工具抽出某份 filing 中具体 item 的全文（Risk Factors、MD&A、财务报表等）。传 accession_number（在 browse 后推荐这种用法）或 year / quarter + item code，响应里会带上正文 + 该 filing 其他章节的 manifest。 sec_filing_read 不是 semantic search：按 (ticker, filing_type, accession_number 或 year[+quarter], item) 做参数化精确查询，返回精确的章节文本 —— 不做相关性排序，不做模糊匹配。

​
返回值

​
data
FilingReadResult
required
​
meta.count
number
本次返回的 item 数。
​
meta.creditsUsed
number
本次调用消耗的 credit（固定 1）。
​
meta.remainingCredits
number
账户剩余 credit。
200 OK · sec_filing_read
{
  "data": {
    "ticker": "NVDA",
    "filing_type": "10-K",
    "accession_number": "0001045810-26-000021",
    "year": 2025,
    "quarter": null,
    "available_sections": [
      { "section_key": "1", "section_title": "Business", "ordinal": 1, "char_count": 48578 },
      { "section_key": "1A", "section_title": "Risk Factors", "ordinal": 2, "char_count": 32100 },
      { "section_key": "7", "section_title": "MD&A", "ordinal": 10, "char_count": 25400 }
    ],
    "items": [
      {
        "number": "1A",
        "name": "Risk Factors",
        "text": "Item 1A. Risk Factors\n\nOur business, financial condition and operating results may be materially affected by..."
      }
    ]
  },
  "meta": { "count": 1, "creditsUsed": 1, "remainingCredits": 99 }
}

​
说明

两步检索是 canonical 模式：先用 sec_filing_browse（免费）拿 filing 列表，挑出想读的 accession_number，再用 sec_filing_read（1 credit）+ 具体 item 抽正文。这样能避开 10-Q 的 period_of_report 和 filed_at 季度不一致问题。
抽更多章节前先看 available_sections[i].char_count —— Risk Factors、MD&A 等长 item 动辄几万字。每次只读一个章节，agent context 才不会爆。
10-K 和 10-Q 使用完全不同的 item code 体系，参数参考下方表格。混用会返回 400。
10-Q 时单传 year 不够 —— 必须 year + quarter 一起传，或者直接传 accession_number。10-Q 只传 year 会返回 400。
仅支持纯文本输出，不返回 HTML / 结构化表格。极新 filing 可能因 sec-api.io 尚未索引而返回 “Processing”。

​
直接调用

// 1) Browse 拿 filing 列表
{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_browse",
    "arguments": { "ticker": "NVDA", "filing_type": "10-K", "limit": 5 }
  }
}

// 2) 读最新 10-K 的 Risk Factors（item 1A）
{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_read",
    "arguments": {
      "ticker": "NVDA",
      "filing_type": "10-K",
      "accession_number": "0001045810-26-000021",
      "item": "1A"
    }
  }
}

​
完整参数参考

​
ticker
string
required
美股 ticker（如 AAPL、NVDA、META）。
​
filing_type
string
required
文件类型 —— 10-K 或 10-Q。
​
year
integer
period_of_report 的日历年。当 accession_number 省略时：10-K 必填；10-Q 必须与 quarter 一起传。
​
quarter
integer
period_of_report 的季度（1-4）。仅适用于 10-Q。10-Q 通过 year 查询且不传 accession_number 时必填。
​
item
string
指定要抽取的章节。省略则返回所有可抽取章节。10-K item code： 1、1A、1B、1C、2、3、4、5、6、7、7A、8、9、9A、9B、10、11、12、13、14、15。10-Q item code： part1item1、part1item2、part1item3、part1item4、part2item1、part2item1a、part2item2、part2item3、part2item4、part2item5、part2item6。常用组合：10-K 1（Business）· 1A（Risk Factors）· 7（MD&A）· 8（财务报表）· 10（董事/高管）；10-Q part1item1（财务报表）· part1item2（MD&A）· part2item1a（Risk Factors）。
​
accession_number
string
精确 SEC 受理号（如 0001045810-26-000021）。在 sec_filing_browse 之后推荐用这种方式。不能与 year / quarter 同时使用。

​
相关接口

SEC 申报文件浏览

第 1 步 —— 调 read 之前先列出该 ticker 的可用 filing。

13F 按机构查持仓

机构持仓数据 —— 不同的 SEC 申报家族（Form 13F）。

MCP Server 接入

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