CUSIPCUSIP 检索
该接口支持按北美统一证券识别码（CUSIP）精确查询对应的上市公司名称、交易代码及实时市值。主要用于将机构持仓申报（如 13F 表格）、托管行结算单或债券组合中的 CUSIP 编码转换为标准股票代码。
https://quote-fmp.com/stable/search-cusip?cusip=037833100数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 13F 机构持仓与清算单自动化解码：华尔街对冲基金提交的 SEC 13F 持仓明细及券商清算交割文件普遍采用 9 位 CUSIP 编码标识证券。该接口提供从 CUSIP 到标准股票代码的直接映射，省去投研团队采购昂贵商业编码库的成本。
- 主代码映射与市值快照一站式获取：除返回对应的股票代码与公司全称外，接口同步附带该证券的最新市值与挂牌交易所信息，便于在解析机构持仓清单的同时快速过滤微盘股或按市值规模做持仓权重归因。
- 跨资产主数据管理编码对齐：在构建多源融合的量化证券主表（Security Master）时，可利用该接口将外部风险模型、指数成分股文件或柜台系统中的 CUSIP 标识统一对齐至平台内部交易代码体系。
- 上下游关联接口：Company Profile Data（公司概况） · Stock Quote（股票报价） · Income Statement（利润表） · Financial Statement Symbols List（报表公司清单）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
cusip | string | 必填 | 037833100 | CUSIP 代码，北美证券的 9 位字母数字识别码（北美 9 位标准证券编码，如苹果 037833100，须作为字符串保留前导零） |
调用代码示例
Python 关键代码CUSIP 检索（/stable/search-cusip，必填 cusip）返回 companyName（公司名称）、cusip（CUSIP 代码）、marketCap（总市值） 等 4 列（样本 companyName=Apple Inc.）。
resp = requests.get(
"https://quote-fmp.com/stable/search-cusip",
params={"cusip": "037833100", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 marketCap（总市值）
df["marketCap"] = pd.to_numeric(df["marketCap"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按苹果 CUSIP（037833100）查询CUSIP 检索 | cusip=037833100 | 传 9 位编码 cusip=037833100 请求 /stable/search-cusip，映射出 companyName、cusip、marketCap（如 companyName=Apple Inc.）。 |
| 切换微软 CUSIP（594918104）反查CUSIP 检索 | cusip=594918104 | 传 cusip=594918104 调用 /stable/search-cusip，将 13F 持仓中的北美证券编码转换为 companyName、cusip、marketCap。 |
请求 /stable/search-cusip 获取CUSIP 检索需传入必填 cusip；返回数组涵盖 companyName（Apple Inc.）等 4 列，作主表关联键前请统一大小写与编码格式。
在 /stable/search-cusip 的返回结构中，companyName（Apple Inc.）与 marketCap（4227021056800）构成核心载荷，本地表以 (symbol, cusip) 保证幂等入库。
返回数据
4 个字段本接口示例响应共包含 4 个字段（数值型 1 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "APC.F" | 证券代码 |
companyName | string | "Apple Inc." | 公司名称 |
cusip | string | "037833100" | CUSIP 代码 |
marketCap | number | 4227021056800 | 总市值 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "APC.F",
"companyName": "Apple Inc.",
"cusip": "037833100",
"marketCap": 4227021056800
}
]常见问题解答（FAQ）
2 个问题/stable/search-cusip 端点（CUSIP 检索）的参数设计与同模块的 股票代码检索 有什么区别？
工程上常将两者配合：用 CUSIP 检索（/stable/search-cusip，必填 cusip）拉取 companyName 与 cusip 等 4 列，同时用 Stock Symbol Search（股票代码检索）补充 5 列关联信息。
使用 /stable/search-cusip 采集CUSIP 检索构建因子库，推荐的请求切片方式是什么？
采集 /stable/search-cusip 的核心技巧是传入精确匹配的 cusip 参数调用 /stable/search-cusip；这能确保 CUSIP 检索 的 companyName 与 cusip 连续完整且无截断遗漏。
同模块相关接口对比
Search本接口路径 /stable/search-cusip，必填参数 cusip。 同一模块「Search」下共 7 个接口，下表列出其余 6 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 股票代码检索Stock Symbol Search | /stable/search-symbol | 按股票代码前缀或片段在全球多个证券市场中快速检索匹配标的，覆盖美股、国际股票与 ETF |
| 公司名称检索Company Name Search | /stable/search-name | 通过公司英文全称、简称或资产名称关键词反向检索全球交易所上市的股票与 ETF 代码 |
| CIK 检索Search Cik | /stable/search-cik | 按美国证监会（SEC）中央索引键（CIK）精确反查对应的上市公司档案、股票代码及挂牌交易所 |
| ISIN 检索Search Isin | /stable/search-isin | 按 12 位国际证券识别码（ISIN）精确检索对应的证券名称、股票代码及最新市值 |
| 条件选股Stock Screener | /stable/company-screener | 是面向全市场证券的横截面多条件初筛工具 |
| 多交易所上市检索Exchange Variants | /stable/search-exchange-variants | 查询单一上市公司在全球所有公开证券交易所的双重上市、交叉挂牌及不同币种交易代码变体 |