Search CikCIK 检索
该接口用于按美国证监会(SEC)中央索引键(CIK)精确反查对应的上市公司档案、股票代码及挂牌交易所。它是打通 SEC EDGAR 原始监管申报文件与二级市场行情、财务数据体系的核心标识转换工具。
https://quote-fmp.com/stable/search-cik?cik=320193数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- SEC 监管编码与行情跨库桥接:SEC 官方披露的 10-K 年报、13F 机构持仓与 8-K 重大事件均以 10 位 CIK 编号作为唯一主体标识,而非股票代码。该接口可将监管文件中的 CIK 即时解析为可交易股票代码,实现合规数据与二级市场行情的无缝拼接。
- 公司更名与代码变更的恒定锚点:上市公司在经历并购重组或品牌更名时常更换股票交易代码,但其 SEC 注册的 CIK 编号终身不变。在长周期历史回测中以 CIK 作为底层主键并通过本接口反查当前代码,可彻底规避历史代码漂移导致的数据断链。
- 同一注册主体下多类别证券枚举:部分发行人在单一 CIK 主体下同时挂牌拥有不同投票权的 A/B 类普通股或优先股。调用该接口可完整枚举同一监管实体关联的全部上市证券代码,辅助并表市值核算与股权结构穿透。
- 跨模块关联接口:Company Profile Data(公司概况) · Stock Quote(股票报价) · Income Statement(利润表) · Financial Statement Symbols List(报表公司清单)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
cik | string | 必填 | 320193 | SEC Central Index Key(CIK)编号,用于定位公司 SEC 主体(须传补足前导零的 10 位定长字符串,如 "0000320193",切勿传整型) |
limit | number | 可选 | 50 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码通过 /stable/search-cik 检索CIK 检索(参数:必填 cik),输出 companyName(公司名称)、exchangeFullName(交易所全称)、exchange(交易所代码)(示例 companyName=Apple Inc.)。
resp = requests.get(
"https://quote-fmp.com/stable/search-cik",
params={"cik": "0000320193", "limit": 50, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 CIK 检索 核心列:symbol, companyName, cik, exchangeFullName
df = df[["symbol", "companyName", "cik", "exchangeFullName"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 10 位 CIK(0000320193)检索CIK 检索 | cik=0000320193 | 向 /stable/search-cik 传补零 10 位 cik=0000320193,获取 companyName、exchangeFullName、exchange(样本 companyName=Apple Inc.)。 |
| 切换代表性机构/主体(cik=0001067983)对比CIK 检索 | cik=0001067983 | 改传 cik=0001067983 调用 /stable/search-cik,横向比较不同 SEC 申报主体的 companyName、exchangeFullName、exchange。 |
/stable/search-cik(必填 cik)返回的 companyName(公司名称,样本 Apple Inc.)为当前有效记录;在写入本地维表或缓存前,请先去除首尾空白字符并校验非空。
CIK 检索返回的 companyName(公司名称,示例 Apple Inc.)在增量同步时,应按 (symbol, cik, exchange) 覆盖更新已有记录,保证本地维表幂等。
返回数据
6 个字段本接口示例响应共包含 6 个字段(数值型 0 个,文本/日期/布尔型 6 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
companyName | string | "Apple Inc." | 公司名称 |
cik | string | "0000320193" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
exchangeFullName | string | "NASDAQ Global Select" | 交易所全称 |
exchange | string | "NASDAQ" | 交易所代码 |
currency | string | "USD" | 计价币种 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"companyName": "Apple Inc.",
"cik": "0000320193",
"exchangeFullName": "NASDAQ Global Select",
"exchange": "NASDAQ",
"currency": "USD"
}
]常见问题解答(FAQ)
2 个问题自动化采集中如何搭配调用CIK 检索(/stable/search-cik)与同模块的 股票代码检索?
在「Search」模块内,CIK 检索(/stable/search-cik,必填 cik)负责输出 companyName 与 exchangeFullName 等 6 项指标,Stock Symbol Search(股票代码检索)负责输出 5 项指标。
调用 /stable/search-cik 采集CIK 检索时,如何设计参数控制与批量请求策略?
工程上推荐通过 /stable/search-cik 的 limit 参数控制单次返回的历史期数或记录上限;同时复用 requests.Session() 保持 HTTP Keep-Alive,直接提取 companyName 与 exchangeFullName。
同模块相关接口对比
Search本接口路径 /stable/search-cik,必填参数 cik。 同一模块「Search」下共 7 个接口,下表列出其余 6 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 股票代码检索Stock Symbol Search | /stable/search-symbol | 按股票代码前缀或片段在全球多个证券市场中快速检索匹配标的,覆盖美股、国际股票与 ETF |
| 公司名称检索Company Name Search | /stable/search-name | 通过公司英文全称、简称或资产名称关键词反向检索全球交易所上市的股票与 ETF 代码 |
| CUSIP 检索CUSIP | /stable/search-cusip | 按北美统一证券识别码(CUSIP)精确查询对应的上市公司名称、交易代码及实时市值 |
| ISIN 检索Search Isin | /stable/search-isin | 按 12 位国际证券识别码(ISIN)精确检索对应的证券名称、股票代码及最新市值 |
| 条件选股Stock Screener | /stable/company-screener | 是面向全市场证券的横截面多条件初筛工具 |
| 多交易所上市检索Exchange Variants | /stable/search-exchange-variants | 查询单一上市公司在全球所有公开证券交易所的双重上市、交叉挂牌及不同币种交易代码变体 |