ESG RatingsESG评级查询
该接口返回公司与基金的详细 ESG 评级数据,覆盖环境、社会、治理三个维度并附争议评分,便于投资者评估投资标的的可持续性与伦理影响。
https://quote-fmp.com/stable/esg-ratings?symbol=AAPL数据更新周期
1 Hour
接口说明
- 评估 ESG 表现:获取反映公司或基金在环境、社会、治理三方面表现的 ESG 评级,数据来自企业可持续发展报告、ESG 研究机构和政府机构。
- 支持投资决策:借助 ESG 评级找出符合自身伦理与可持续发展目标的公司和基金,让投资支持积极的社会与环境成果。
- 按 ESG 评分筛选:自定义检索条件,筛选 ESG 评级高或 ESG 争议评分低的公司,聚焦符合自己 ESG 标准的机构。
- 跨模块关联接口:Company Profile Data(公司概况) · Executive Compensation(高管薪酬查询) · Financial Scores(财务健康评分) · Stock Screener(条件选股)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码,例如 AAPL、MSFT、NVDA(仅覆盖美股及在美上市 ADR,无需附加交易所后缀)。 |
调用代码示例
Python 关键代码读取风险等级 ESGRiskRating 与行业位置 industryRank,并保留 fiscalYear;E/S/G 分项得分请查看 esg-disclosures。
resp = requests.get(
"https://quote-fmp.com/stable/esg-ratings",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
if not df.empty:
result = df.reindex(columns=['symbol', 'fiscalYear', 'ESGRiskRating', 'industryRank'])
print(result)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取 AAPL 标的ESG评级查询(symbol=AAPL) | symbol=AAPL | 指定标的代码 symbol=AAPL 调用 /stable/esg-ratings,直接提取 ESG评级查询 的 ESGRiskRating、industryRank、companyName 数据。 |
| 检索美股 NVDA ESG评级查询截面 | symbol=NVDA | 针对 NVDA 请求 /stable/esg-ratings,采集对应的 ESGRiskRating、industryRank、companyName 并与 AAPL 面板合并。 |
/stable/esg-ratings(必填 symbol)返回的 ESGRiskRating(ESG 风险评级,样本 B)为当前有效记录;在写入本地维表或缓存前,请先去除首尾空白字符并校验非空。
ESG评级查询返回的 fiscalYear(财政年度,示例 2025)在增量同步时,应按 (symbol, cik, fiscalYear) 覆盖更新已有记录。
返回数据
7 个字段本接口示例响应共包含 7 个字段(数值型 1 个,文本/日期/布尔型 6 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
cik | string | "0000320193" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
companyName | string | "Apple Inc." | 公司名称 |
industry | string | "CONSUMER ELECTRONICS" | 细分行业 |
fiscalYear | number | 2025 | 财政年度 |
ESGRiskRating | string | "B" | ESG 风险评级 |
industryRank | string | "17 out of 20" | 行业排名 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"cik": "0000320193",
"companyName": "Apple Inc.",
"industry": "CONSUMER ELECTRONICS",
"fiscalYear": 2025,
"ESGRiskRating": "B",
"industryRank": "17 out of 20"
}
]常见问题解答(FAQ)
2 个问题ESG 风险等级与 E/S/G 分项得分是同一类结果吗?
不是。本地接口样例中 esg-ratings 返回 ESGRiskRating、industryRank 与 fiscalYear;esg-disclosures 返回 environmentalScore、socialScore、governanceScore、ESGScore 及披露信息。先按需要的是风险等级还是披露得分选择接口;不同方法和报告期的数据不能直接合并成同一种评分。
调用 /stable/esg-ratings 采集ESG评级查询时,如何设计参数控制与批量请求策略?
工程上推荐按标的代码 symbol 请求 /stable/esg-ratings(非美标的需附交易所后缀);同时复用 requests.Session() 保持 HTTP Keep-Alive,直接提取 ESGRiskRating 与 industryRank。
同模块相关接口对比
Esg本接口路径 /stable/esg-ratings,必填参数 symbol。 同一模块「Esg」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。