Complex Template · SEC Filing Search & Extraction

用例 1: 搜索美国证券交易委员会(SEC)文件

按公司、表单类型和日期检索 10-K / 10-Q / 8-K,把风险因素、MD&A 这些章节抽出来,附带原文出处。

Use this template when
  • 找一家公司最近的 10-K、10-Q 或 8-K
  • 把风险因素、MD&A 交给 LLM 做摘要
  • 写研究简报时需要能追溯到原文的段落
适用用户: 美股投研、合规、AI 分析工具
输出预览静态样例,非实时
10-KAAPL · 2025-11-01
Annual report · Risk Factors
"Global supply chain concentration in the Asia-Pacific region continues to expose the Company to..."
supply-chaingeopoliticsfx
即将开放 模板已上架便于发现;对应数据域 / endpoint GA 后才能在 Playground 真实试跑。
创建 API Key API Reference

API / MCP 调用

同一个模板同时支持 REST、Python 与 MCP Prompt。选择你熟悉的入口。

import requests

url = "https://api.gatedata.ai/api/v1/disclosures/sec-filings?symbol=AAPL&form_type=10-K&limit=5"
r = requests.get(url, headers={"Authorization": "Bearer gd_live_…"}, timeout=15)
filings = r.json().get("filings", [])
for f in filings:
    print(f.get("form_type"), f.get("filed_at"), f.get("filing_url"))
# Template layer: extract_section(filing_url, section="Risk Factors")

输入参数

修改下方参数,上方代码示例和请求 URL 会同步更新。Live 模板的默认值即可一键跑通。

GET/api/v1/disclosures/sec-filings?symbol=AAPL&form_type=10-K&limit=5

输出与解读

静态样例响应静态样例,非实时
{
  "symbol": "AAPL",
  "filings": [
    {
      "form_type": "10-K",
      "filed_at": "2025-11-01",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/...",
      "matched_sections": ["Risk Factors"]
    }
  ],
  "summary": "Supply chain concentration in APAC ...",
  "citations": [
    { "filing_url": "...", "section": "Risk Factors", "offset": 12480 }
  ],
  "metadata": {
    "data_status": "ready",
    "object_refs": [
      {
        "type": "listing",
        "id": "listing_aapl_xnas",
        "asset_id": "asset_aapl_common_stock",
        "entity_id": "entity_sec_cik_0000320193",
        "instrument_id": "instrument_aapl_common_stock",
        "listing_id": "listing_aapl_xnas",
        "venue_id": "venue_xnas",
        "resolved_from": "primary_listing",
        "resolution_confidence": "1"
      }
    ]
  }
}
字段说明
  • filings[]array
    命中的文件列表,含 form_type、filed_at、URL
  • matched_sections[]array
    章节提取结果(模板层聚合)
  • summarystring
    章节摘要,可直接给 LLM 使用
  • citations[]array
    每段摘要对应的原文位置,便于回溯
  • metadata.object_refs[]object[]
    统一对象引用数组
  • object_refs[].typestring
    对象引用类型
  • object_refs[].idstring
    对象标识,标识 type 指定的具体对象
  • object_refs[].asset_idstring
    资产标识,标识股票、加密资产等资产对象
  • object_refs[].resolved_fromstring
    对象解析所用输入来源
  • object_refs[].resolution_confidencestring
    对象解析置信度
如何解读结果
  • 看 form_type 和 filed_at,先判断文件是不是最新的
  • matched_sections 为空,通常是关键字太窄,换个说法再试
  • citations 用来给 LLM 的输出加引用,减少胡编

边界与下一步

Do NOT use for
  • 不给投资建议
  • 只覆盖美股披露,非美股公司请另寻数据源
常见边界与状态
  • SEC 检索走的是原生接口,章节提取和摘要在模板层做
  • 超长 10-K 的摘要比较费额度,建议先按章节裁剪