核心用法
jisu-stockhistory 是基于极速数据官方API的股票历史行情查询技能，提供三类核心能力：
1. 历史行情查询（query）：按股票代码+时间范围获取日线级历史数据，包含开/收/高/低价、成交量、成交额、换手率、涨跌幅等K线必需字段，支持自由时间窗口回溯
2. 股票列表（list）：按分类（classid=1为沪深股市）分页获取全量股票清单，便于选股与批量处理
3. 单股详情（detail）：获取个股最新快照，包含实时价、PE/PB、市值等财务指标
调用方式为Python CLI脚本，需配置JISU_API_KEY环境变量。请求参数均为JSON格式，返回结构化JSON数据，错误码体系明确（201代码为空、202代码不存在、210无信息等）。
显著优点
- 数据粒度完整：日线级历史数据覆盖价格、量能、估值多维度，可直接用于K线绘制与技术分析
- 官方数据源：极速数据为合规数据服务商，A股行情数据权威性较高
- 接口设计清晰：三端点分离（query/list/detail），参数命名直观，分页机制支持批量获取
- OpenClaw原生适配：已配置emoji标识、环境变量依赖声明，与代理系统整合度高
潜在局限与风险
- API Key门槛：需用户自行注册极速数据账号并申请权限，非开箱即用
- 调用成本：极速数据为商业API，高频调用或大量历史数据请求可能产生费用（具体以官网定价为准）
- 数据延迟：历史行情通常为收盘后数据，非实时推送，不适用于秒级交易决策
- 覆盖范围：文档明确classid=1为沪深股市，港股、美股等市场支持情况未说明
- Python依赖：目标系统需预装Python3运行时
适合人群
- 需要回溯个股历史走势进行技术分析或策略回测的投资者/研究员
- 构建量化模型、需要批量获取A股日线数据的开发者
- 希望在OpenClaw代理内实现「历史+实时」组合查询的自动化场景
常规风险
- 密钥泄露：
JISU_API_KEY需妥善保管，避免硬编码或日志泄露导致滥用 - 合规使用：获取的股票数据仅限个人研究或内部使用，未经授权不得用于商业数据服务转售
- 接口稳定性：依赖第三方商业API，存在服务变更、限速或停服风险，建议实现降级逻辑
- 数据解读：历史行情不含未来函数警示，回测结果不代表实盘表现，需警惕过拟合