ESG Investment SearchESG投资检索
该接口按 ESG 评分、表现、争议情况及业务涉足领域筛选公司与基金,帮助你找到与自身 ESG 价值观一致的投资标的。
https://quote-fmp.com/stable/esg-disclosures?symbol=AAPL数据更新周期
1 Hour
接口说明
- 按 ESG 评分检索:找出 ESG 评级强、符合自己投资标准的公司与基金,传入
symbol后可拉取companyName(公司名称)、formType(SEC申报表单类型(如10-K、10-Q、8-K、4、13F))与environmentalScore(环境(E)得分) 等指标,为基本面与量价研究提供标准输入。 - 评估 ESG 表现:按 ESG 表现过滤投资标的,确保其符合你的价值观和财务目标,配合
formType(SEC申报表单类型(如10-K、10-Q、8-K、4、13F))与environmentalScore(环境(E)得分) 等返回项,能高效支撑同行业标的横向比对。 - 评估争议风险:按争议评分过滤,避开卷入重大 ESG 争议的公司,实务中常与同模块的「ESG评级查询」联合调用,先做广度筛查再下钻单标明细。
- 上下游关联接口:Financial Scores(财务健康评分) · Stock Screener(条件选股) · Company Profile Data(公司概况) · Executive Compensation(高管薪酬查询)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码,例如 AAPL、MSFT、NVDA(仅覆盖美股及在美上市 ADR,无需附加交易所后缀)。 |
调用代码示例
Python 关键代码从披露记录提取 E/S/G 分项与 ESGScore,保留 symbol 和 date 以核对报告口径;风险等级并非本接口的同一项输出。
resp = requests.get(
"https://quote-fmp.com/stable/esg-disclosures",
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', 'date', 'environmentalScore', 'socialScore', 'governanceScore', 'ESGScore'])
for column in ['environmentalScore', 'socialScore', 'governanceScore', 'ESGScore']:
result[column] = pd.to_numeric(result[column], errors='coerce')
print(result)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求ESG投资检索 | symbol=AAPL | 调用 /stable/esg-disclosures 拉取 AAPL 的ESG投资检索,输出 environmentalScore、socialScore、governanceScore 等 11 项标准化属性。 |
| 拉取 NVDA 的ESG投资检索做同业对标 | symbol=NVDA | 通过 symbol=NVDA 请求 /stable/esg-disclosures,拉回 ESG投资检索 的 environmentalScore、socialScore、governanceScore 明细数据。 |
/stable/esg-disclosures 返回 acceptedDate(样本 2026-04-30),但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报,可结合接收时间和时区判断可见性;非美标的、与期末同日的零点时间或回填日期,须先核对原始披露来源。未核实前保留原值,不据此承诺回测已消除前视偏差。
从 /stable/esg-disclosures 抽取 environmentalScore(样本 66.29)入库时,以 (symbol, cik, date) 建唯一索引可安全支持断点续传。
返回数据
11 个字段本接口示例响应共包含 11 个字段(数值型 4 个,文本/日期/布尔型 7 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-03-28" | 日期 |
acceptedDate | string | "2026-04-30" | 受理日期(SEC 精确到秒接收时间戳;Point-in-Time 量化回测须以此时间为准以防未来函数) |
symbol | string | "AAPL" | 证券代码 |
cik | string | "0000320193" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
companyName | string | "Apple Inc." | 公司名称 |
formType | string | "8-K" | SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F) |
environmentalScore | number | 66.29 | 环境(E)得分 |
socialScore | number | 45.21 | 社会(S)得分 |
governanceScore | number | 58.87 | 治理(G)得分 |
ESGScore | number | 56.79 | ESG 综合评分 |
url | string | "https://www.sec.gov/Archives/e…" | 链接地址 |
查看响应数据示例(原始 JSON)
[
{
"date": "2026-03-28",
"acceptedDate": "2026-04-30",
"symbol": "AAPL",
"cik": "0000320193",
"companyName": "Apple Inc.",
"formType": "8-K",
"environmentalScore": 66.29,
"socialScore": 45.21,
"governanceScore": 58.87,
"ESGScore": 56.79,
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000011/0000320193-26-000011-index.htm"
}
]常见问题解答(FAQ)
2 个问题ESG 风险等级与 E/S/G 分项得分是同一类结果吗?
不是。本地接口样例中 esg-ratings 返回 ESGRiskRating、industryRank 与 fiscalYear;esg-disclosures 返回 environmentalScore、socialScore、governanceScore、ESGScore 及披露信息。先按需要的是风险等级还是披露得分选择接口;不同方法和报告期的数据不能直接合并成同一种评分。
拉取 /stable/esg-disclosures 的ESG投资检索数据时,如何处理历史回溯、空结果判定或代码格式?
针对 /stable/esg-disclosures,推荐向 /stable/esg-disclosures 传入标准 symbol(港股带 .HK、A 股带 .SS);这样既能稳定获取 environmentalScore(环境(E)得分),又能避免单次请求载荷过大。
同模块相关接口对比
Esg本接口路径 /stable/esg-disclosures,必填参数 symbol。 同一模块「Esg」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。