估值数据

本接口提供 A 股多股票最新估值快照，用于查看股票当前价格相对于公司盈利、净资产、营业收入和经营现金流的估值水平。当前支持市盈率（PE）、市净率（PB）、市销率（PS）和市现率（PCF）四类指标，共 5 个数据字段；其中市盈率同时提供 TTM 和 MRQ 两种口径。

这些指标可用于个股基本面分析、同行业公司对比、股票筛选和估值监控。不同指标的适用范围存在差异，建议结合公司盈利状态、行业特征、财务质量及其他基本面数据综合判断。

接口返回统一响应信封 ApiResponse，业务错误经 code 字段表达，HTTP 状态码恒为 200。

通用约定

Base URL：https://fuyao.aicubes.cn。
必需请求头：X-api-key，缺失或无效返回 code=2001。
thscodes 使用英文逗号分隔，大小写不敏感；服务端会 trim、转为大写、去重并保留首次出现顺序。
一次请求默认最多接受 100 个原始 token；该上限由服务端配置，调用方不能覆盖。
接口固定返回市盈率 TTM/MRQ、市净率 MRQ、市销率 TTM 和市现率 TTM 五个估值指标，不提供历史估值、分页、指标选择或高低估结论。

接口

REST 端点	MCP Tool	说明
`GET /api/a-share/valuations/snapshot`	`get_a_share_valuations_snapshot`	批量查询 A 股最新估值快照

A股估值快照

GET /api/a-share/valuations/snapshot

MCP Tool：get_a_share_valuations_snapshot

请求参数

参数	位置	类型	必需	说明
`thscodes`	query	string	是	英文逗号分隔的 A 股 thscode 列表，如 `600519.SH,000001.SZ`；每项必须为六位数字加 `.SH`、`.SZ` 或 `.BJ`。

请求示例

curl 'https://fuyao.aicubes.cn/api/a-share/valuations/snapshot?thscodes=600519.SH,000001.SZ' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "a1b2c3d4e5f6789012345678abcdef01",
  "data": {
    "timestamp": 1784736000000,
    "total": 1,
    "item": [
      {
        "thscode": "600519.SH",
        "ticker": "600519",
        "name": "贵州茅台",
        "pe_ttm": 21.3567,
        "pe_mrq": 20.8841,
        "pb_mrq": 7.1532,
        "ps_ttm": 10.3284,
        "pcf_ttm": 19.7716
      }
    ]
  }
}

示例数值仅用于说明响应结构，不代表实时数据。

响应字段

字段	类型	说明
`code`	integer	业务状态码，`0` 表示成功。
`message`	string	业务状态说明。
`request_id`	string	请求追踪 ID。
`data.timestamp`	long \| null	本次响应所用上游指标元数据中的最大有效时间，单位为毫秒；无有效时间时为 `null`。
`data.total`	integer	实际返回的股票条数。
`data.item`	array	估值快照列表，按去重后的请求顺序返回。
`data.item[].thscode`	string	带交易所后缀的完整 thscode。
`data.item[].ticker`	string	六位股票代码，不含交易所后缀。
`data.item[].name`	string \| null	本地 A 股代码表中的股票名称。
`data.item[].pe_ttm`	number \| null	市盈率 TTM。
`data.item[].pe_mrq`	number \| null	市盈率 MRQ。
`data.item[].pb_mrq`	number \| null	市净率 MRQ。
`data.item[].ps_ttm`	number \| null	市销率 TTM。
`data.item[].pcf_ttm`	number \| null	市现率 TTM。

数据语义

每个返回项固定包含 5 个指标字段；上游空值返回 null，不会补零。
负值和高精度十进制值原样返回，服务端不做估值计算、聚合、取绝对值或四舍五入。
上游未返回的股票不会生成占位项；无匹配记录时返回 code=0、total=0、item=[]。

指标说明

指标分类	数据项	字段名
市盈率（PE）	市盈率（TTM）	`pe_ttm`
市盈率（PE）	市盈率（MRQ）	`pe_mrq`
市净率（PB）	市净率（MRQ）	`pb_mrq`
市销率（PS）	市销率（TTM）	`ps_ttm`
市现率（PCF）	市现率（TTM）	`pcf_ttm`

市盈率（PE）

市盈率反映股票价格相对于公司盈利水平的倍数，可用于衡量投资者为公司每单位盈利支付的价格。本接口提供 pe_ttm 和 pe_mrq 两种口径。当公司净利润为负时，市盈率可能为负值或无有效结果，此时不宜直接按“市盈率越低，估值越低”判断。

市净率（PB）

市净率反映股票价格相对于公司每股净资产的倍数。本接口提供 pb_mrq，通常适合用于金融、地产、制造等资产规模较重要的行业。使用时还应关注资产质量、负债水平和行业差异；当公司净资产为负时，该指标可能不具备常规估值意义。

市销率（PS）

市销率反映股票价格相对于公司营业收入的倍数。本接口提供 ps_ttm，适合比较业务模式和收入结构相近的公司，但无法直接反映成本、利润率和盈利质量，不建议单独作为估值判断依据。

市现率（PCF）

市现率反映股票价格相对于公司经营现金流的倍数。本接口提供 pcf_ttm，可用于观察经营现金流对当前估值的支撑程度。当经营现金流为负或波动较大时，该指标可能为负值、空值或出现较大波动，使用时应结合公司的现金流结构和经营周期判断。

计算口径

口径	英文全称	说明
TTM	Trailing Twelve Months	使用最近连续 12 个月的数据，通常由最近四个季度数据计算。
MRQ	Most Recent Quarter	使用最近一个已披露报告期的数据。

估值指标由股票价格和对应财务数据共同决定。股票价格会随行情变化，财务数据根据上市公司定期报告更新，因此不同指标的更新时间可能存在差异。响应中的 data.timestamp 表示本次响应所用上游指标元数据中的最大有效时间，不应将其理解为所有指标完全同步更新的时间。

使用说明

估值指标衡量股票价格与公司财务数据之间的相对关系，不代表股票的绝对投资价值。
不同行业的盈利模式、资产结构和现金流特征不同，跨行业直接比较可能产生偏差。
当净利润、净资产或经营现金流为负时，部分指标可能返回负值或 null。
TTM 与 MRQ 使用的财务数据周期不同，同一股票的两个口径可能存在明显差异。
实际结果应以接口返回的数据值、data.timestamp 和字段说明为准。

错误与约束

场景	`code`	说明
缺少 `thscodes`	`1001`	必填参数缺失。
存在空 token 或 thscode 格式非法	`1002`	每项必须为六位数字加 `.SH`、`.SZ` 或 `.BJ`。
原始 token 数超过服务端上限	`1003`	默认最多 100 个。
格式正确但代码表不存在	`3001`	目标不在 A 股代码表中。
数据源超时	`5002`	DataAPI 请求超时。
数据源不可用	`5003`	DataAPI 返回异常、空响应或非成功状态。

接口​

A股估值快照​

请求参数​

请求示例​

响应示例​

响应字段​

指标说明​

市盈率（PE）​

市净率（PB）​

市销率（PS）​

市现率（PCF）​

计算口径​

错误与约束​

接口