Exchange Variants多交易所上市检索
该接口用于查询单一上市公司在全球所有公开证券交易所的双重上市、交叉挂牌及不同币种交易代码变体。输入主市场股票代码,即可完整枚举该企业在美股、欧股、加股或亚太市场的全部可交易代码与对应行情快照。
https://quote-fmp.com/stable/search-exchange-variants?symbol=AAPL数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- 全球双重上市与跨市场套利标的发现:大型跨国企业常在纽约、伦敦、法兰克福或多伦多等多个交易所同步挂牌交易。该接口一次性列出同一公司底层资产在不同市场的全部交易代码与计价货币,为跨市场价差监控与 ADR 折溢价套利提供完整代码清单。
- 跨时区流动性接力与价格追踪:当美股主市场休市时,许多跨国龙头的欧洲或亚太挂牌代码仍处于活跃交易时段。通过该接口获取全市场挂牌变体,投研团队可构建跨时区接力的价格监控面板,提前捕捉盘前重大事件的市场定价反应。
- 多区域行情与估值指标同屏核验:接口除返回各交易所变体代码与所属板块外,还同步提供各挂牌代码的最新价格、成交量、市值与滚动市盈率,便于直观比对不同交易场所的流动性深度与估值折溢价水平。
- 关联数据线接口:Company Profile Data(公司概况) · Stock Quote(股票报价) · Income Statement(利润表) · Financial Statement Symbols List(报表公司清单)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码请求 多交易所上市检索(/stable/search-exchange-variants,必填 symbol),解析后可得 price(最新价)、beta(Beta 系数)、volAvg(平均成交量) 共 36 项数据。
resp = requests.get(
"https://quote-fmp.com/stable/search-exchange-variants",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 price(最新价)
df["price"] = pd.to_numeric(df["price"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 同步 AAPL 单标的多交易所上市检索 | symbol=AAPL | 针对 AAPL 请求 /stable/search-exchange-variants,获取含 price、beta、volAvg(示例 331.85501)的结构化 JSON。 |
| 改传 symbol=NVDA 查询多交易所上市检索 | symbol=NVDA | 向 /stable/search-exchange-variants 传 NVDA,获取该标的的 price、beta、volAvg(共 36 列)用于跨公司比较。 |
拉取多交易所上市检索(/stable/search-exchange-variants,必填 symbol)时,返回的 price(如 331.85501)可直接缓存在本地内存或 Redis 字典中,减少重复网络请求。
多交易所上市检索(/stable/search-exchange-variants)包含 8 个数值列与 28 个文本/日期列,按 (symbol, cik, exchange) 建主键并将 price(最新价)设为双精度类型最为稳妥。
返回数据
36 个字段本接口示例响应共包含 36 个字段(数值型 8 个,文本/日期/布尔型 28 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
price | number | 331.85501 | 最新价 |
beta | number | 1.097 | Beta 系数 |
volAvg | number | 55309000 | 平均成交量 |
mktCap | number | 4874072686740 | 总市值 |
lastDiv | number | 1.05 | 最近一次派息额 |
range | string | "201.5-344.57" | 区间 |
changes | number | -6.33498 | 涨跌 |
companyName | string | "Apple Inc." | 公司名称 |
currency | string | "USD" | 计价币种 |
cik | string | "0000320193" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
isin | string | "US0378331005" | 国际证券识别码 |
cusip | string | "037833100" | CUSIP 代码 |
exchange | string | "NASDAQ Global Select" | 交易所代码 |
exchangeShortName | string | "NASDAQ" | 交易所简称(如 NASDAQ) |
industry | string | "Consumer Electronics" | 细分行业 |
website | string | "https://www.apple.com" | 官网地址 |
description | string | "Apple Inc. is a global technol…" | 描述 |
ceo | string | "Timothy D. Cook" | 首席执行官(CEO) |
sector | string | "Technology" | 板块 |
country | string | "US" | 国家/地区 |
fullTimeEmployees | string | "166000" | 全职员工人数 |
phone | string | "(408) 996-1010" | 联系电话 |
address | string | "One Apple Park Way" | 注册地址 |
city | string | "Cupertino" | 城市 |
state | string | "CA" | 州/省 |
zip | string | "95014" | 邮政编码 |
dcfDiff | number | 191.60731 | DCF 估值与现价差额 |
dcf | number | 140.70269296445176 | DCF 估值 |
image | string | "https://images.financialmodeli…" | 图片链接 |
ipoDate | string | "1980-12-12" | IPO(上市)日期 |
defaultImage | boolean | false | 默认图片链接 |
isEtf | boolean | false | 是否为 ETF |
isActivelyTrading | boolean | true | 是否在活跃交易 |
isAdr | boolean | false | 是否为 ADR(美国存托凭证) |
isFund | boolean | false | 是否为基金 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"price": 331.85501,
"beta": 1.097,
"volAvg": 55309000,
"mktCap": 4874072686740,
"lastDiv": 1.05,
"range": "201.5-344.57",
"changes": -6.33498,
"companyName": "Apple Inc.",
"currency": "USD",
"cik": "0000320193",
"isin": "US0378331005",
"cusip": "037833100",
"exchange": "NASDAQ Global Select",
"exchangeShortName": "NASDAQ",
"industry": "Consumer Electronics",
"website": "https://www.apple.com",
"description": "Apple Inc. is a global technology corporation that specializes in the conceptualization, production, and sale of a diverse suite of electronic devices. Its comprehensive hardware lineup features the well-known iPhone smartphones, Mac personal computers, and versatile iPad tablets. The company also supplies a range of wearables, smart home products, and accessories, including AirPods, Apple TV, Apple Watch, items from the Beats brand, and HomePod speakers. Beyond its device offerings, Apple deliv...",
"ceo": "Timothy D. Cook",
"sector": "Technology",
"country": "US",
"fullTimeEmployees": "166000",
"phone": "(408) 996-1010",
"address": "One Apple Park Way",
"city": "Cupertino",
"state": "CA",内容已截断,完整字段以实际返回为准。
常见问题解答(FAQ)
2 个问题多交易所上市检索(共 36 列)与 股票代码检索(共 5 列)在工程调用中怎么配合?
在参数上,多交易所上市检索(/stable/search-exchange-variants)为必填 symbol,输出 price(331.85501)等 36 列;Stock Symbol Search(股票代码检索)为必填 query,输出 5 列,可按需串联调用。
在多资产或长周期策略中使用多交易所上市检索(/stable/search-exchange-variants),请求参数该如何编排?
调用 /stable/search-exchange-variants 时宜传入目标证券 symbol 访问 /stable/search-exchange-variants 采集单票数据;冷启动全量回填可分批执行,日常盘后则只拉最新一期 price(最新价)。
同模块相关接口对比
Search本接口路径 /stable/search-exchange-variants,必填参数 symbol。 同一模块「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)精确查询对应的上市公司名称、交易代码及实时市值 |
| ISIN 检索Search Isin | /stable/search-isin | 按 12 位国际证券识别码(ISIN)精确检索对应的证券名称、股票代码及最新市值 |
| 条件选股Stock Screener | /stable/company-screener | 是面向全市场证券的横截面多条件初筛工具 |