# 每日指标

每日基本面指标，每只股票每个交易日一行，含市盈率（PE 与 TTM）、市净率、市销率、股息率、换手率、量比，以及总股本/流通股本/自由流通股本和总市值/流通市值。随每日收盘价同步更新，适合做估值筛选、横截面排序、市值分层与因子构建。注意估值比率受亏损或负值影响可能为空或为负，市值单位为万元，使用前应明确口径（TTM 与静态、流通与总）。

`GET /v2/market/fundamentals`

## 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `symbol` | string | 否 | 股票代码，如 000001.SZ |
| `start_date` | string | 否 | 开始日期 (YYYYMMDD) |
| `end_date` | string | 否 | 结束日期 (YYYYMMDD) |
| `trade_date` | string | 否 | 交易日期，YYYYMMDD（查单日） |

## 关键返回字段

| 字段 | 说明 |
| --- | --- |
| `pe / pe_ttm` | 市盈率 / 滚动市盈率 |
| `pb` | 市净率 |
| `turnover_rate / turnover_rate_f` | 换手率 / 自由流通换手率 |
| `total_mv / circ_mv` | 总市值 / 流通市值（万元） |
| `ps / ps_ttm` | 市销率 / 滚动市销率 |

## 接口示例

cURL

```
curl -H "X-API-Key: YOUR_KEY" \
  "https://asharehub.com/v2/market/fundamentals?symbol=000001.SZ"
```

Python SDK

```
from asharehub import AShareHub

client = AShareHub(api_key="YOUR_KEY")
df = client.fundamentals(symbol="000001.SZ")
print(df.head())
```

## 数据样例

返回 pandas.DataFrame

| symbol | trade_date | close | turnover_rate | turnover_rate_f | volume_ratio | pe | pe_ttm | pb | ps | … +8 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 000001.SZ | 20260626 | 10.23 | 0.6372 | 1.5152 | 1.01 | 4.6565 | 4.6104 | 0.4278 | 1.5103 | … |
| 000001.SZ | 20260625 | 10.42 | 0.5586 | 1.3284 | 0.91 | 4.743 | 4.696 | 0.4357 | 1.5384 | … |
| 000001.SZ | 20260624 | 10.51 | 0.5802 | 1.3796 | 0.97 | 4.784 | 4.7366 | 0.4395 | 1.5517 | … |

## 按日期查询历史市盈率（PE / PE TTM）

查询一只 A 股的历史市盈率时，将 `symbol` 与 `start_date`、`end_date` 一起传入每日指标接口。下面查询 2026 年 6 月的可用记录，并按交易日期升序排列；日期格式为 `YYYYMMDD`。

Python SDK

```
from asharehub import AShareHub

with AShareHub(api_key="YOUR_KEY") as client:
    history = client.fundamentals(
        symbol="000001.SZ",
        start_date="20260601",
        end_date="20260630",
    )

if history.empty:
    print("No valuation records for this symbol and date range.")
else:
    history = history.sort_values("trade_date")
    columns = ["symbol", "trade_date", "pe", "pe_ttm", "pb"]
    print(history[columns].to_string(index=False))
```

`pe` 是静态市盈率，`pe_ttm` 是滚动 12 个月市盈率，两者不能混作同一序列。估值比率没有货币单位；缺失值应保持为空，不要填成 0，也不要自动删除负值。接口返回可用交易日记录，不保证每个自然日都有数据。

这些历史日期记录不等于财报发布当时的可见数据快照；用于回测时还需核实披露时间与后续修订。首次接入可查看 [Python SDK 安装](https://asharehub.com/zh/docs/sdk-install)，需要同步价格序列时查看 [日线行情](https://asharehub.com/zh/docs/market-daily)。