SEC Filings By Symbol按代码查 SEC 申报
该接口按股票代码与起止日期区间查询指定上市公司的全部美国证监会（SEC）监管申报记录，逐条返回申报表单类型、监管系统精确到秒的接收时间戳、报告期末日及原始归档文件直链，是构建合规事件监控与财务数据时点对齐的基础索引。
https://quote-fmp.com/stable/sec-filings-search/symbol?symbol=AAPL&from=2024-01-01&to=2024-03-01&page=0&limit=100数据更新周期
N/A · 不适用固定周期
接口说明
- 按公司查申报：输入股票代码即可获取任何上市公司的详细 SEC 申报，传入
symbol后可拿到symbol（证券代码）、cik（SECCIK编号）与filingDate（申报日期） 等明细项，便于在 Python 或 SQL 中直接聚合。 - 文档直达链接：提供完整 SEC 申报及相关附件的直接链接，研究过程完全透明，借助
cik（SECCIK编号）与filingDate（申报日期） 等数值，方便研究员在长周期序列上识别趋势拐点。 - 实时数据更新：接口实时更新，SEC 一发布最新申报即可获取，实务中常与同模块的「按表格类型查 SEC 申报」联合调用，先做广度筛查再下钻单标明细。
- 配套投研接口：SEC Filings Company Search By Symbol（股票代码检索公司） · SEC Filings Company Search By CIK（CIK 检索公司） · As Reported Income Statements（原始申报利润表） · Search Cik（CIK 检索）
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码，例如 AAPL、MSFT、NVDA（仅覆盖美股及在美上市 ADR，无需附加交易所后缀）。 |
from | string | 必填 | 2024-01-01 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | string | 必填 | 2024-03-01 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
调用代码示例
Python 关键代码按示例请求 /stable/sec-filings-search/symbol 获取按代码查 SEC 申报（必填 symbol, from, to），DataFrame 包含 formType（SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F））、link（详情链接）、finalLink（申报文件最终链接）（formType=4）。
resp = requests.get(
"https://quote-fmp.com/stable/sec-filings-search/symbol",
params={"symbol": "AAPL", "from": "2024-01-01", "to": "2024-03-01", "page": 0, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 按代码查 SEC 申报 核心列：symbol, cik, filingDate, acceptedDate
df = df[["symbol", "cik", "filingDate", "acceptedDate"]].dropna(how="all")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 查询 AAPL 的按代码查 SEC 申报明细（symbol=AAPL） | symbol=AAPL&from=2024-01-01&to=2024-03-01 | 向 /stable/sec-filings-search/symbol 传 symbol=AAPL，返回包含 formType、link、finalLink（如 formType=4）在内的 7 项字段。 |
| 按年度日期边界拉取 AAPL 按代码查 SEC 申报历史序列 | symbol=AAPL&from=2024-01-01&to=2024-12-31 | 在 /stable/sec-filings-search/symbol 中组合 symbol=AAPL 与日期范围，过滤出 2024 全年的 formType、link、finalLink 明细记录。 |
| 按 NVDA 代码提取按代码查 SEC 申报明细 | symbol=NVDA&from=2024-01-01&to=2024-03-01 | 指定 symbol=NVDA 查询 /stable/sec-filings-search/symbol，输出 formType、link、finalLink 等 7 项同口径指标。 |
/stable/sec-filings-search/symbol 返回 acceptedDate（样本 2024-03-01 18:36:45），但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报，可结合接收时间和时区判断可见性；非美标的、与期末同日的零点时间或回填日期，须先核对原始披露来源。未核实前保留原值，不据此承诺回测已消除前视偏差。
/stable/sec-filings-search/symbol 单行含 7 个属性（如 formType=4）；PostgreSQL 或 ClickHouse 建表推荐以 (symbol, cik, filingDate) 为主键。
返回数据
7 个字段本接口示例响应共包含 7 个字段（数值型 0 个，文本/日期/布尔型 7 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
cik | string | "0000320193" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
filingDate | string | "2024-03-01 00:00:00" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
acceptedDate | string | "2024-03-01 18:36:45" | 受理日期（SEC 精确到秒接收时间戳；Point-in-Time 量化回测须以此时间为准以防未来函数） |
formType | string | "4" | SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F） |
link | string | "https://www.sec.gov/Archives/e…" | 详情链接 |
finalLink | string | "https://www.sec.gov/Archives/e…" | 申报文件最终链接 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"cik": "0000320193",
"filingDate": "2024-03-01 00:00:00",
"acceptedDate": "2024-03-01 18:36:45",
"formType": "4",
"link": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000039/0000320193-24-000039-index.htm",
"finalLink": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000039/xslF345X05/wk-form4_1709336196.xml"
}
]常见问题解答（FAQ）
2 个问题在对接「Search Filings」数据线时，按代码查 SEC 申报与 按表格类型查 SEC 申报 各自解决什么问题？
按代码查 SEC 申报 通过 /stable/sec-filings-search/symbol（必填 symbol, from, to）返回 formType（SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F））、link（详情链接）等 7 列明细；同模块的 SEC Filings By Form Type（按表格类型查 SEC 申报） 则通过 /stable/sec-filings-search/form-type（必填 formType, from, to）提供配套数据。
想要完整归档按代码查 SEC 申报，请求 /stable/sec-filings-search/symbol 时在参数调度上有什么最佳实践？
在采集 按代码查 SEC 申报 时，可在 /stable/sec-filings-search/symbol 中传入 from/to 日期区间分批拉取；若遇到休市日或未披露窗口返回 []，脚本应记录水位线并平滑跳过。
同模块相关接口对比
Search Filings本接口路径 /stable/sec-filings-search/symbol，必填参数 symbol、from、to。 同一模块「Search Filings」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 按表格类型查 SEC 申报SEC Filings By Form Type | /stable/sec-filings-search/form-type | 按监管表单类型与日期区间批量检索全市场 SEC EDGAR 申报文件及原文链接 |
| 按 CIK 查 SEC 申报SEC Filings By CIK | /stable/sec-filings-search/cik | 按 SEC 10 位 CIK 编号查询指定主体提交的历史监管申报文件清单 |
| 按名称查 SEC 申报SEC Filings By Name | /stable/sec-filings-company-search/name | 按公司名称或申报实体英文关键词模糊检索 SEC EDGAR 申报记录 |