核心用法
极速数据股票查询技能(jisu-stock)是基于极速数据股票API的OpenClaw封装工具,提供三类核心功能:
1. 股票查询(query):按代码获取当日分钟级行情趋势,包含时间戳、价格、成交量、成交额、均价等维度数据
2. 股票列表查询(list):支持沪深股市(classid=1)、港股(3)、北证A股(4)三大市场分页拉取全量股票代码
3. 股票详情查询(detail):获取单股完整基本面数据,涵盖最新价、涨跌幅、换手率、量比、市盈率(PER)、市净率(PBR)等关键指标
典型调用示例:
python3 skills/stock/stock.py detail '{"code":"300917"}'显著优点
- 数据维度丰富:分钟级趋势数组支持日内走势可视化,财务指标覆盖技术面与基本面核心字段
- 多市场覆盖:统一接口支持A股、港股、北交所,便于跨市场策略分析
- 响应结构清晰:JSON标准化输出,易于程序化解析与后续数据处理
- 生态协同:官方推荐与stockhistory技能联动,形成"实时快照+历史回测"的完整分析链路
潜在缺点与局限性
- 实时性约束:免费/低阶套餐可能存在延迟,分钟级数据非交易所直连,存在秒级滞后
- 频率限制:API存在调用次数上限(错误码104/106),高频量化场景需评估成本
- 数据深度不足:无逐笔成交、Level-2订单簿等高级行情,仅限基础OHLC+指标
- 密钥依赖:必须配置
JISU_API_KEY,且存在过期/权限/封禁风险(错误码101-108) - 退市与新股覆盖:文档未明确说明ST股、退市整理期、新股上市首日的特殊处理逻辑
适合人群
- 个人投资者快速查询持仓行情与基础技术指标
- 财经内容创作者批量获取股票元数据构建知识库
- 中小型量化团队作为数据补充源,配合主数据源做交叉验证
- 教育场景下的金融市场入门教学与数据分析演练
常规风险
1. API密钥泄露风险:JISU_API_KEY需妥善保管,避免硬编码上传代码仓库
2. 数据可靠性边界:第三方聚合数据可能与交易所官方行情存在偏差,不宜用于高频交易决策
3. 服务连续性风险:接口可能维护(107)或停用(108),需设计降级方案
4. 合规使用约束:需遵守极速数据平台的用户协议,禁止未经授权的数据再分发