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。

执行方式

# 查某合约某日日终行情
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。

{
  "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 携带。