Search IsinISIN 检索
该接口支持按 12 位国际证券识别码（ISIN）精确检索对应的证券名称、股票代码及最新市值。它是跨国资产配置、全球指数成分映射与多市场清算数据接入时实现国际标准编码与交易代码互转的关键工具。
https://quote-fmp.com/stable/search-isin?isin=US0378331005数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 全球跨市场投资组合编码转换：欧洲、亚太及跨国资管机构的持仓报表与跨境托管指令均以 ISO 标准的 12 位 ISIN 码作为全球唯一证券身份证。该接口可将不同国家前缀的 ISIN 编码直接转换为交易终端可识别的股票代码。
- 国际指数成分与海外 ETF 清单对齐：MSCI、富时罗素等全球指数供应商及海外 ETF 披露的每日持仓篮子通常仅提供 ISIN 编码。通过该接口批量映射标准交易代码，可快速搭建指数跟踪策略与跨市场套利监控流水线。
- 多地双重上市识别与市值初筛：同一证券在不同地区交易时可能共享同一 ISIN 码，接口返回匹配的股票代码、公司名称及当前市值快照，辅助全球宏观与多资产策略团队完成底层标的清洗与规模核验。
- 配套投研接口：Company Profile Data（公司概况） · Stock Quote（股票报价） · Income Statement（利润表） · Financial Statement Symbols List（报表公司清单）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
isin | string | 必填 | US0378331005 | 国际证券识别码（ISIN），全球唯一的 12 位证券代码（国际 12 位证券识别码，首 2 位为国家代码，如 US0378331005） |
调用代码示例
Python 关键代码示例向 /stable/search-isin 发起ISIN 检索请求（必填 isin），并清洗 name（名称）、isin（国际证券识别码）、marketCap（总市值） 等核心列。
resp = requests.get(
"https://quote-fmp.com/stable/search-isin",
params={"isin": "US0378331005", "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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按苹果 ISIN（US0378331005）检索ISIN 检索 | isin=US0378331005 | 向 /stable/search-isin 传 12 位 isin=US0378331005，定位 name、isin、marketCap（样本 name=Apple Inc.）。 |
| 切换微软 ISIN（US5949181045）查询ISIN 检索 | isin=US5949181045 | 改传 isin=US5949181045 请求 /stable/search-isin，对齐跨国证券主表的 name、isin、marketCap。 |
/stable/search-isin 返回的ISIN 检索数据集（必填 isin）以 name（样本 Apple Inc.）为核心，入库或关联前建议先做缺失值检测。
同步 /stable/search-isin 的 4 个字段入库时，依赖 (symbol, isin, name) 实现幂等去重；核心数值 marketCap（如 4874072686740）可直接用于量化回测计算。
返回数据
4 个字段本接口示例响应共包含 4 个字段（数值型 1 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
name | string | "Apple Inc." | 名称 |
isin | string | "US0378331005" | 国际证券识别码 |
marketCap | number | 4874072686740 | 总市值 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"name": "Apple Inc.",
"isin": "US0378331005",
"marketCap": 4874072686740
}
]常见问题解答（FAQ）
2 个问题ISIN 检索（/stable/search-isin）相比同模块的 股票代码检索，在查询维度与字段上差在哪？
ISIN 检索 走 /stable/search-isin 端点（必填 isin），单条含 name、isin、marketCap 共 4 项字段；同模块的 Stock Symbol Search（股票代码检索） 走 /stable/search-symbol（必填 query，5 项字段）。
针对 /stable/search-isin（ISIN 检索），工程脚本中如何避免漏数或无效轮询？
生产调度中通常传入精确匹配的 isin 参数调用 /stable/search-isin；每次拉回 name（样本 Apple Inc.）后，按时间或代码水位线增量推进。
同模块相关接口对比
Search本接口路径 /stable/search-isin，必填参数 isin。 同一模块「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）精确反查对应的上市公司档案、股票代码及挂牌交易所 |
| CUSIP 检索CUSIP | /stable/search-cusip | 按北美统一证券识别码（CUSIP）精确查询对应的上市公司名称、交易代码及实时市值 |
| 条件选股Stock Screener | /stable/company-screener | 是面向全市场证券的横截面多条件初筛工具 |
| 多交易所上市检索Exchange Variants | /stable/search-exchange-variants | 查询单一上市公司在全球所有公开证券交易所的双重上市、交叉挂牌及不同币种交易代码变体 |