Company Profile Data公司概况
该接口返回指定上市公司的全维度基础档案与最新市场快照。单次请求即可集齐公司市值、最新股价、Beta 波动率、日均成交量、所属一级板块与二级细分行业、CEO 姓名、全职员工数、总部地址、挂牌交易所、CIK/ISIN/CUSIP 三大编码及业务简介,是全站个股画像的顶层总表。
https://quote-fmp.com/stable/profile?symbol=AAPL数据更新周期
Ad-Hoc · 按需更新
接口说明
- 个股详情页“一页纸”全景画像:在研发行情终端或投研平台时,打开任意一只股票主页所需的顶部行情摘要(当前股价、涨跌幅、52 周高低区间、总市值)、行业归属标签、三大国际标准编码及公司主营业务中英文简介,均可通过该接口一次调用完整渲染。
- 多因子模型行业分类与标的过滤底座:量化研究员在构建本地证券主表时,依赖该接口获取每只股票所属的一级板块、二级细分行业、Beta 系数、上市日期及是否为 ETF/ADR/基金的布尔标识,直接用于回归模型的行业哑变量构建与非普通股剔除。
- 跨数据源三大唯一编码对齐中枢:接口在同一返回体中同时提供股票代码、SEC 10 位 CIK 编号、12 位国际 ISIN 码及 9 位北美 CUSIP 码,是打通二级市场行情库、SEC 监管申报库与海外托管清算系统的核心映射中枢。
- 跨模块关联接口:Batch Market Cap(批量市值数据) · Historical Market Cap(历史市值查询) · Stock Screener(条件选股) · Stock Quote(股票报价)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
调用代码示例
Python 关键代码采集 公司概况(/stable/profile)需传必填 symbol,重点读取 price(最新价)、marketCap(总市值)、beta(Beta 系数)(样本 price=331.85501)。
resp = requests.get(
"https://quote-fmp.com/stable/profile",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 ipoDate 升序重排并数值化 price(最新价)
df["price"] = pd.to_numeric(df["price"], errors="coerce")
df = df.sort_values("ipoDate").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取 AAPL 标的公司概况(symbol=AAPL) | symbol=AAPL | 指定标的代码 symbol=AAPL 调用 /stable/profile,直接提取 公司概况 的 price、marketCap、beta 数据。 |
| 非美交易所标的(symbol=0700.HK)查询公司概况 | symbol=0700.HK | 向 /stable/profile 传带交易所后缀的 symbol=0700.HK,拉取非美标的的 price、marketCap、beta 明细。 |
对接 /stable/profile(公司概况,必填 symbol)时,重点字段 price(331.85501)反映最新快照状态,与下游行情或财务表关联前须对齐代码后缀。
清洗公司概况响应时,先按 (symbol, cik, exchange) 剔除重复行,再提取 price(最新价,样本 331.85501)构造量化指标。
返回数据
36 个字段本接口示例响应共包含 36 个字段(数值型 8 个,文本/日期/布尔型 28 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
price | number | 331.85501 | 最新价 |
marketCap | number | 4874072686740 | 总市值 |
beta | number | 1.097 | Beta 系数 |
lastDividend | number | 1.05 | 最近一次每股派息 |
range | string | "201.5-344.57" | 区间 |
change | number | -6.33498 | 涨跌额 |
changePercentage | number | -1.8732 | 涨跌幅(%) |
volume | number | 28718014 | 成交量 |
averageVolume | number | 55309000 | 平均成交量 |
companyName | string | "Apple Inc." | 公司名称 |
currency | string | "USD" | 计价币种 |
cik | string | "0000320193" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
isin | string | "US0378331005" | 国际证券识别码 |
cusip | string | "037833100" | CUSIP 代码 |
exchangeFullName | string | "NASDAQ Global Select" | 交易所全称 |
exchange | string | "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" | 邮政编码 |
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,
"marketCap": 4874072686740,
"beta": 1.097,
"lastDividend": 1.05,
"range": "201.5-344.57",
"change": -6.33498,
"changePercentage": -1.8732,
"volume": 28718014,
"averageVolume": 55309000,
"companyName": "Apple Inc.",
"currency": "USD",
"cik": "0000320193",
"isin": "US0378331005",
"cusip": "037833100",
"exchangeFullName": "NASDAQ Global Select",
"exchange": "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",内容已截断,完整字段以实际返回为准。
常见问题解答(FAQ)
2 个问题请求 /stable/profile 获取公司概况时有哪些必填项?它与 按 CIK 查公司概况 的边界在哪?
公司概况(/stable/profile)采用必填 symbol查询,返回首条样本如 price=331.85501(共 36 列);同模块相邻的 Company Profile by CIK(按 CIK 查公司概况)则包含 36 列。
初次建库回填公司概况与日常增量拉取 /stable/profile,在传参方式上有何技巧?
在量化管道中,应按标的代码 symbol 请求 /stable/profile(非美标的需附交易所后缀);若并发拉取多组任务,请结合网关 RPM 配额控制并发协程数,稳健采集 price。
同模块相关接口对比
Profile本接口路径 /stable/profile,必填参数 symbol。 同一模块「Profile」下共 5 个接口,下表列出其余 4 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 按 CIK 查公司概况Company Profile by CIK | /stable/profile-cik | 直接按美国证监会(SEC)10 位中央索引键(CIK)查询上市公司的完整档案与最新市场快照 |
| 公司债券与票据Company Notes | /stable/company-notes | 指定上市公司在证券交易所公开挂牌交易的企业票据与债券类证券清单 |
| 同业公司对比Stock Peer Comparison | /stable/stock-peers | 基于所属挂牌交易所、二级细分行业及当前市值规模相近度 |
| 退市公司清单Delisted Companies | /stable/delisted-companies | 按分页返回已从全球主要证券交易所摘牌退市的历史公司台账 |