用户输入代码或名称片段,实时返回匹配标的与所属交易所。
Search(证券搜索)
此类接口提供证券代码的检索与匹配信息,包括按代码、公司名、CIK、CUSIP、ISIN 反查标的,股票筛选器按条件列出候选标的,以及同一代码在不同交易所的写法对照。做数据清洗和批量入库前,先用它把代码对齐,后面的报价与财报接口才不会成片返回空数组。
典型使用场景
3 个场景把监管申报里的 CIK 或 CUSIP 映射为可查行情的 Ticker。
按市值、流动性与行业过滤出可交易标的池。
接口怎么选?
7 项选型对照证券搜索类别是所有量化与投研工作流的第一步:在调取行情或财报前,先把用户输入的简称、CIK、CUSIP 或 ISIN 转换成 FMP 标准 symbol。
如果目标是按市值、行业、Beta、股息率或交易所构建候选股票池(Universe),直接使用 Stock Screener 一次筛出标的列表,再进下游拉取报表或日线。
| 你的需求 | 推荐接口 | 选择理由 |
|---|---|---|
| 按股票代码前缀或关键词联想 | Stock Symbol Search股票代码检索 | 最常用的搜索框联想与代码定位入口 |
| 按公司名称模糊查找股票代码 | Company Name Search公司名称检索 | 适合只知道公司英文名、不知道 Ticker 的场景 |
| 按 SEC 10 位 CIK 编号反查 | Search CikCIK 检索 | 对接 13F 机构持仓与 SEC 申报文件时必用 |
| 按北美证券 CUSIP 编码反查 | CUSIPCUSIP 检索 | 13F 持仓明细常以 CUSIP 标识证券 |
| 按国际证券识别码 ISIN 反查 | Search IsinISIN 检索 | 跨国组合与欧洲/亚太标的映射常用 |
| 按市值、行业、估值等条件筛选股票池 | Stock Screener条件选股 | 量化策略构建初始股票池(Universe)的核心工具 |
| 查看同一公司在不同交易所的挂牌代码 | Exchange Variants多交易所上市检索 | 识别美股主挂牌、ADR 与海外双重上市代码 |
数据覆盖与参数口径
- 支持标识:Ticker (symbol)、Company Name、CIK、CUSIP、ISIN
- 选股维度:市值、价格、Beta、成交量、股息率、Sector、Industry、Country、Exchange
- 代码后缀:美股无后缀(AAPL),港股 .HK(0700.HK),A 股 .SS/.SZ
- 常见联动:搜索拿到 symbol 后,转入 Company Profile 或 Quote 验证状态
调用示例
Python 关键代码示例场景:用条件选股器筛选美股科技板块大盘股 · 对应接口:Stock Screener(条件选股)
resp = requests.get(
"https://quote-fmp.com/stable/company-screener",
params={
"exchange": "NASDAQ", "sector": "Technology",
"marketCapMoreThan": 10_000_000_000, # 单位为 1 美元(100 亿美元)
"isEtf": "false", "isFund": "false", "isActivelyTrading": "true",
"includeAllShareClasses": "false", "limit": 500, "apikey": FMP_KEY,
},
)
df = pd.DataFrame(resp.json())
# lastAnnualDividend 为年度每股派息额(美元),除以 price 换算真实股息率百分比
df["dividendYieldPct"] = (df["lastAnnualDividend"] / df["price"] * 100).round(2)- 构建策略股票池时建议显式传 isActivelyTrading=true,过滤已停牌或退市代码。
- Stock Screener 适合做横截面初筛,精细估值指标请继续拉 Key Metrics TTM(TTM 关键指标)。
数据注意事项
4 条实盘要点- 跨国公司常在美股、欧股、港股多地挂牌,处理 Stock Symbol Search(股票代码检索) 或 Company Name Search(公司名称检索) 结果时请结合
exchangeFullName与currency过滤主上市地代码,或调 Exchange Variants(多交易所上市检索) 对照。 - SEC CIK 标准格式为 10 位前导零字符串,使用 Search Cik(CIK 检索)、CUSIP(CUSIP 检索) 或 Search Isin(ISIN 检索) 与 13F 持仓表关联时建议统一标准化编码格式。
- Stock Screener(条件选股) 适合做横截面多条件初筛,构建实盘交易池时建议显式传入
isActivelyTrading=true与isEtf=false排除停牌代码与基金。 - 搜索类接口仅返回核心标识与基础属性,命中目标
symbol后请转入 Company Profile Data(公司概况) 或 Stock Quote(股票报价) 获取完整基本面与实时报价。
常见问题
3 个问题Stock Symbol Search(股票代码检索) 和 Company Name Search(公司名称检索) 有什么区别?
Stock Symbol Search(股票代码检索) 同时匹配代码和名称,适合通用搜索框;Company Name Search(公司名称检索) 专门针对公司名称匹配,在代码与名称字母巧合冲突时更精准。
为什么同一个公司搜出来多个 symbol?
跨国公司常在美股、法兰克福、伦敦或港股多地上市(或有 ADR / 优先股)。可根据返回里的 exchangeShortName 和 currency 选择主上市地代码,或用 Exchange Variants(多交易所上市检索) 核对。
CIK 编号不足 10 位怎么传?
SEC 标准 CIK 为 10 位左侧补零字符串(如 0000320193),接口同时兼容去零格式,但本地落库建议统一格式化为 10 位以便跨表关联。
接口一览(7个)
1 个功能模块Search
7 个接口该接口支持按股票代码前缀或片段在全球多个证券市场中快速检索匹配标的,覆盖美股、国际股票与 ETF。作为行情终端搜索框与投研系统的主代码解析入口,它可按交易所过滤并即时返回候选证券的标准代码、全称及交易币种。
/stable/search-symbol该接口支持通过公司英文全称、简称或资产名称关键词反向检索全球交易所上市的股票与 ETF 代码。它解决了仅有企业名称而缺失标准交易代码的映射难题,适用于外部资讯实体对齐与跨数据源证券主表建库。
/stable/search-name该接口用于按美国证监会(SEC)中央索引键(CIK)精确反查对应的上市公司档案、股票代码及挂牌交易所。它是打通 SEC EDGAR 原始监管申报文件与二级市场行情、财务数据体系的核心标识转换工具。
/stable/search-cik该接口支持按北美统一证券识别码(CUSIP)精确查询对应的上市公司名称、交易代码及实时市值。主要用于将机构持仓申报(如 13F 表格)、托管行结算单或债券组合中的 CUSIP 编码转换为标准股票代码。
/stable/search-cusip该接口支持按 12 位国际证券识别码(ISIN)精确检索对应的证券名称、股票代码及最新市值。它是跨国资产配置、全球指数成分映射与多市场清算数据接入时实现国际标准编码与交易代码互转的关键工具。
/stable/search-isin该接口是面向全市场证券的横截面多条件初筛工具。支持按市值规模、交易活跃度、波动率(Beta)、派息水平及所属行业与交易所快速过滤,一步剔除 ETF 与基金,生成符合策略底线的候选股票池。
/stable/company-screener该接口用于查询单一上市公司在全球所有公开证券交易所的双重上市、交叉挂牌及不同币种交易代码变体。输入主市场股票代码,即可完整枚举该企业在美股、欧股、加股或亚太市场的全部可交易代码与对应行情快照。
/stable/search-exchange-variants