Futures Eod Price

---
name: futures-eod-price
description: 分页查询期货日终行情（开高低收/结算价/前结算价/涨跌额/成交量/成交额/持仓量）。用户提到「期货日终行情」「期货 EOD」「期货日线行情」「futures eod price」时使用。按交易所/合约/精确交易日或日期区间过滤，分页返回，page_size 最大 200，支持 --all 翻页。
---

# 查询期货日终行情

## 接口说明

| 项目 | 说明 |
|------|------|
| 接口名称 | 查询期货日终行情 |
| 外部接口 | GET /api/v1/market/data/futures/eod-price |
| 请求方式 | GET |
| 适用场景 | 分页查询期货日终行情，包括开高低收、结算价、成交量、成交额和持仓量等字段 |

## 请求参数

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| exchange | string | 否 | 交易所代码 | `SHFE` | 精确匹配 |
| symbol | string | 否 | 合约代码 | `rb2610` | 精确匹配 |
| trade_date | int | 否 | 精确交易日 | `20260721` | 8 位 YYYYMMDD；**与 start_date/end_date 互斥** |
| start_date | int | 否 | 起始交易日 | `20260701` | 8 位 YYYYMMDD；须与 end_date 同时提供 |
| end_date | int | 否 | 结束交易日 | `20260721` | 8 位 YYYYMMDD；须与 start_date 同时提供 |
| page | int | 否 | 页码 | `1` | 默认 1 |
| page_size | int | 否 | 每页条数 | `50` | 默认 50，最大 200 |

> `trade_date` 不可与 `start_date`/`end_date` 同时使用；同时提供起止日期时需满足 `start_date <= end_date`。

## 执行方式

```bash
# 查某合约某日日终行情
python <RUN_PY> futures-eod-price --exchange SHFE --symbol rb2610 --trade_date 20260721 --page 1 --page_size 20
# 查某合约日期区间
python <RUN_PY> futures-eod-price --symbol rb2610 --start_date 20260701 --end_date 20260721
# 自动翻页获取全量
python <RUN_PY> futures-eod-price --exchange SHFE --all
```

`<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。

## 响应结构

返回 `code/message/data`，分页数据位于 `data.records`。

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "pageNum": 1, "pageSize": 20, "total": 1, "pages": 1,
    "records": [
      {
        "trade_date": 20260721, "exchange": "SHFE", "symbol": "rb2610",
        "open_price": "3210", "highest_price": "3212", "lowest_price": "3208", "close_price": "3211",
        "settlement_price": "3205", "pre_settlement_price": "3198",
        "up_down_1": "13", "up_down_2": "7",
        "volume": 1234, "amount": "39621740.00",
        "open_interest": "456789", "open_interest_change": "-1000",
        "updated_at": "2026-07-21 15:00:00"
      }
    ]
  }
}
```

### records 字段

| 字段 | 类型 | 说明 |
|------|------|------|
| trade_date | int | 交易日 |
| exchange | string | 交易所 |
| symbol | string | 合约代码 |
| open_price / highest_price / lowest_price / close_price | string | 开 / 最高 / 最低 / 收 |
| settlement_price / pre_settlement_price | string | 结算价 / 前结算价 |
| up_down_1 / up_down_2 | string | 涨跌额口径一 / 口径二 |
| volume | int64 | 成交量 |
| amount | string | 成交额 |
| open_interest / open_interest_change | string | 持仓量 / 持仓量变化 |
| updated_at | string | 更新时间 |

## 注意事项

- `trade_date` 与 `start_date`/`end_date` 互斥；`start_date`/`end_date` 必须成对且 `start_date <= end_date`。
- `page_size` 最大 200，超过按 200 处理。
- 多数价格/金额字段以字符串返回，`volume` 为 int64。
- HTTP 恒为 200，业务错误通过 `code`/`message` 携带。