查询东财美股历史 OHLC

接口说明

项目	说明
接口名称	查询东财美股历史日 K 线
外部接口	/api/v1/market/data/eastmoney-us-stock-daily-ohlc
请求方式	GET
适用场景	查询东财美股历史日 K 线；有日期范围时按 3 天窗口分批请求，无日期范围时全量拉取

请求参数

参数名	类型	是否必填	描述	取值示例	备注
--stock_code	string	是	股票代码	AAL	东财美股代码
--start_date	string	否	起始日期（含）	2026-06-01	格式 YYYY-MM-DD 或 YYYYMMDD
--end_date	string	否	截止日期（含）	2026-06-10	格式 YYYY-MM-DD 或 YYYYMMDD
--page	int	否	页码	1	从 1 开始，默认 1
--page_size	int	否	每页条数	50	默认 50
--all	flag	否	全量返回	—	返回全量数据（不分页）

执行策略：有日期范围时，将区间拆分为最多 3 天的窗口分批请求，合并去重排序；无日期范围时全量拉取（不传日期参数）。

查询模式

模式	参数	说明
全部历史	--stock_code	全量拉取全部历史 K 线（分页）
日期区间	--stock_code --start_date --end_date	按 3 天窗口分批请求，合并后分页
日期区间全量	--stock_code --start_date --end_date --all	按 3 天窗口分批请求，合并后返回全量（不分页）

执行方式

通过根目录的 run.py 调用：

python <RUN_PY> eastmoney-us-stock-daily-ohlc --stock_code AAL --page 1 --page_size 10
python <RUN_PY> eastmoney-us-stock-daily-ohlc --stock_code AAL --start_date 2026-05-01 --end_date 2026-06-10 --page 1 --page_size 50
python <RUN_PY> eastmoney-us-stock-daily-ohlc --stock_code AAL --start_date 2026-05-01 --end_date 2026-06-10 --all

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径，参见主 SKILL.md 的「调用方式」说明。

响应结构

顶层为分页包装对象：

字段名	类型	描述
code	int	业务状态码，成功为 0
message	string	业务消息
data	object/null	分页数据体；无数据时可能为 null
data.pageNum	int	当前页码
data.pageSize	int	每页条数
data.total	int	总记录数
data.pages	int	总页数
data.records	array	当前页 K 线列表

data.records[] 单条记录字段（全部字段按字符串返回）：

字段名	类型	描述
secid	string	证券 ID，格式 {market}.{code}，如 105.ADV
code	string	股票代码
name	string	股票名称
market	string	市场编号
date	string	日期，格式 YYYY-MM-DD
open	string	开盘价
close	string	收盘价
high	string	最高价
low	string	最低价
volume	string	成交量
amount	string	成交额
amplitude	string	振幅
klt	string	K 线类型
fqt	string	复权类型

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 50,
    "total": 503,
    "pages": 11,
    "records": [
      {
        "secid": "105.ADV",
        "code": "ADV",
        "name": "Advantage Solutions Inc",
        "market": "105",
        "date": "2021-01-05",
        "open": "12.34",
        "close": "12.56",
        "high": "12.78",
        "low": "12.10",
        "volume": "1234567",
        "amount": "9876543.21",
        "amplitude": "5.5",
        "klt": "101",
        "fqt": "1"
      }
    ]
  }
}

注意事项

• 有日期范围时，区间拆分为最多 3 天的窗口分别请求，避免服务端大范围 500 错误
• 无日期范围时，全量拉取全部历史 K 线（单只股票数据量较小，如 AAL ~1365 条）
• start_date / end_date 支持 YYYY-MM-DD 与 YYYYMMDD 两种格式
• 记录字段为 snake_case，所有数值字段均为字符串
• data 在错误或无数据时可能为 null
• stock_code 为东财美股代码（如 AAL）
• 可先通过 eastmoney-us-stock-list 获取有效的美股代码列表