# 基金总览

- 接口：get_fund_overview
- 路径：/api/v1/market/data/fund/fund-overview
- 方法：GET
- 描述：分页查询所有基金概览（近两个交易日单位/累计净值、日增长值与增长率、基金类别、申购状态）。返回分页结构（items/total_pages/total_items）。
- 数据范围：最新快照（概览为最近两个交易日净值聚合，无历史时间序列）
- 单次限量：分页返回，由 `page` / `page_size` 控制
- 提示：
  - 无净值的基金对应字段为 `null`。
  - `daily_growth_ratio` 保留两位小数。

## 输入参数

| 名称 | 类型 | 必选 | 描述 |
|------|------|------|------|
| page | integer | Y | 当前页 |
| page_size | integer | Y | 每页条数 |

## 输出参数
成功响应外层固定为 `code`、`message`、`data`：

| 名称 | 类型 | 默认显示 | 描述 |
|------|------|---------|------|
| code | integer | Y | HTTP 状态码；成功固定为 200 |
| message | string | Y | 成功固定为 `success`；失败时为中文错误信息 |
| data | object / null | Y | 成功时为业务数据对象；失败时为 `null`。其字段如下 |

data 对象：

| 名称 | 类型 | 默认显示 | 描述 |
|------|------|---------|------|
| items | array | Y | 概览列表 |
| total_pages | integer | Y | 总页数 |
| total_items | integer | Y | 总记录数（未分页前） |

items 数组：

| 名称 | 类型 | 默认显示 | 描述 |
|------|------|---------|------|
| fund_code | string | Y | 基金代码 |
| fund_name | string | Y | 基金名称 |
| last_trade_day_unitnv | string | Y | 上一交易日单位净值（无数据 null） |
| last_trade_day_accum_unitnv | string | Y | 上一交易日累计净值（无数据 null） |
| second_last_trade_day_unitnv | string | Y | 上上交易日单位净值（无数据 null） |
| second_last_trade_day_accum_unitnv | string | Y | 上上交易日累计净值（无数据 null） |
| daily_growth_value | string | Y | 日增长值（无数据 null） |
| daily_growth_ratio | string | Y | 日增长率（%，两位小数，无数据 null） |
| fund_type | string | Y | 基金类别 |
| subscription_status | string | Y | 申购状态 |

## 接口示例

```bash
curl -sS "https://market.ft.tech/gateway/api/v1/market/data/fund/fund-overview?page=1&page_size=10"
```

Python（[`ftshare`](https://github.com/FTShare-Lab/FTShare-python-sdk.git) SDK，方法 `market.fund_overview`，默认返回 pandas `DataFrame`）：

```python
import ftshare as ft

market = ft.market_api()

# 无必填参数，取一页基金总览（最新净值/涨跌幅等）
df = market.fund_overview(page=1, page_size=10)
print(df.shape)  # (10, 10)
print(df[["fund_code", "fund_name", "last_trade_day_unitnv", "daily_growth_ratio"]].head())
#   fund_code    fund_name  last_trade_day_unitnv  daily_growth_ratio
# 0           000001          华夏成长混合A                  1.45              -1.29
# 1           000003         中海可转债债券A                   ...              -2.06
# ...

# limit 跨页取数（SDK 自动翻页拼成 50 行）
df = market.fund_overview(limit=50)

# 返回原始 JSON 信封（未经 DataFrame 抽取）
payload = market.fund_overview(page=1, page_size=10, raw=True)
```

## 数据样例

基金概览节选（无净值的字段为 `null`）：

| fund_code | fund_name | last_trade_day_unitnv | second_last_trade_day_unitnv | ... |
|------------------|------------------|-----------------------|------------------------------|-----|
| 000001 | 华夏成长混合A | null | 1.345 | ... |
