Stock Symbol Search股票代码检索
该接口支持按股票代码前缀或片段在全球多个证券市场中快速检索匹配标的,覆盖美股、国际股票与 ETF。作为行情终端搜索框与投研系统的主代码解析入口,它可按交易所过滤并即时返回候选证券的标准代码、全称及交易币种。
https://quote-fmp.com/stable/search-symbol?query=AAPL数据更新周期
该接口暂无固定更新周期(多为按需更新的参考或静态数据)。
接口说明
- 行情终端搜索与联想底座:针对用户在搜索框中输入不完整代码或模糊字母的场景,该接口提供毫秒级代码匹配能力,返回标准证券代码、挂牌交易所缩写与结算币种,直接支撑前端代码自动补全组件。
- 跨市场重名代码与交易所定界:全球多个交易所常存在相同字母简写但代表不同资产的同名代码。接口支持结合交易所维度精准过滤,协助量化系统在落库与下单前锁定唯一的目标交易场所与计价货币。
- 下游行情与财报前置校验器:在批量拉取日线行情或财务三表前,先调用该接口核验外部传入代码的合法性与归属市场,可有效拦截拼写错误或非目标交易所代码,避免无效请求损耗下游数据配额。
- 配套投研接口:Company Profile Data(公司概况) · Stock Quote(股票报价) · Income Statement(利润表) · Financial Statement Symbols List(报表公司清单)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
query | string | 必填 | AAPL | 搜索关键词,按名称或代码匹配返回相关标的。 |
limit | number | 可选 | 50 | 返回结果条数上限,用于控制单次响应大小。 |
exchange | string | 可选 | NASDAQ | 目标交易所代码或名称,如 NASDAQ、NYSE、AMEX。 |
调用代码示例
Python 关键代码示例向 /stable/search-symbol 发起股票代码检索请求(必填 query),并清洗 name(名称)、exchangeFullName(交易所全称)、exchange(交易所代码) 等核心列。
resp = requests.get(
"https://quote-fmp.com/stable/search-symbol",
params={"query": "AAPL", "limit": 50, "exchange": "NASDAQ", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 股票代码检索 核心列:symbol, name, currency, exchangeFullName
df = df[["symbol", "name", "currency", "exchangeFullName"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 指定纳斯达克(NASDAQ)拉取股票代码检索 | query=AAPL&exchange=NASDAQ | 向 /stable/search-symbol 传 exchange=NASDAQ,获取纳斯达克市场的 name、exchangeFullName、exchange(样本 name=Apple Inc.)。 |
| 切换纽交所(NYSE)对比股票代码检索 | query=AAPL&exchange=NYSE | 改传 exchange=NYSE 调用 /stable/search-symbol,拉取纽交所主板对应的 name、exchangeFullName、exchange。 |
/stable/search-symbol 返回的股票代码检索数据集(必填 query)以 name(样本 Apple Inc.)为核心,入库或关联前建议先做缺失值检测。
同步 /stable/search-symbol 的 5 个字段入库时,依赖 (symbol, exchange, name) 实现幂等去重;核心标识 name(如 Apple Inc.)可直接作为跨表关联键。
返回数据
5 个字段本接口示例响应共包含 5 个字段(数值型 0 个,文本/日期/布尔型 5 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
name | string | "Apple Inc." | 名称 |
currency | string | "USD" | 计价币种 |
exchangeFullName | string | "NASDAQ Global Select" | 交易所全称 |
exchange | string | "NASDAQ" | 交易所代码 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"name": "Apple Inc.",
"currency": "USD",
"exchangeFullName": "NASDAQ Global Select",
"exchange": "NASDAQ"
}
]常见问题解答(FAQ)
2 个问题按股票代码搜索和按公司名称搜索,应怎样选择?
输入的是 AAPL 这类代码或代码片段时,用本接口的 query;输入的是 Apple 这类公司名称文本时,用公司名称检索。两者可能返回相同字段,区别在检索内容。展示候选时保留 symbol、name、exchangeFullName;确认交易所和币种后再调用行情或财报,不把首条候选无条件当作目标证券。
如何减少搜索结果中的同名歧义和无效调用?
使用目标代码或名称作为 query,按需要设置 exchange 与 limit 缩小候选范围。limit 只控制返回上限,不是历史窗口或分页游标。让用户确认候选的 symbol、交易所和币种后再请求业务数据;不要按时间水位线把搜索结果当作历史序列增量同步。
同模块相关接口对比
Search本接口路径 /stable/search-symbol,必填参数 query。 同一模块「Search」下共 7 个接口,下表列出其余 6 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司名称检索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 | 是面向全市场证券的横截面多条件初筛工具 |
| 多交易所上市检索Exchange Variants | /stable/search-exchange-variants | 查询单一上市公司在全球所有公开证券交易所的双重上市、交叉挂牌及不同币种交易代码变体 |