极速数据股票查询（Jisu Stock）

基于 股票查询 API 的 OpenClaw 技能，支持：

• 股票查询（/stock/query）：根据股票代码查询当日行情，数据粒度为分钟，含趋势数据
• 股票列表查询（/stock/list）：按分类（沪深股市/港股/北证A股）分页获取股票列表
• 股票详情查询（/stock/detail）：根据股票代码获取单只股票详情（最新价、涨跌幅、成交量、市盈率等）

如需做更深入的走势分析、K 线研究或回测，推荐配合 股票历史行情查询 Skill（stockhistory） 一起使用：
- ClawHub 链接：https://clawhub.ai/jisuapi/stockhistory

使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/stock/

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/stock/stock.py

使用方式

1. 股票查询（/stock/query）

根据股票代码查询当日行情，返回名称、代码、最新价、昨收盘价、数据量、更新时间及按分钟维度的趋势数组（时间、价格、成交量、成交总额、平均价）。

python3 skills/stock/stock.py query '{"code":"300917"}'

请求 JSON：

{
  "code": "300917"
}

字段名	类型	必填	说明
code	string	是	股票代码

2. 股票列表查询（/stock/list）

按分类分页获取股票列表。分类：1 沪深股市，3 港股，4 北证A股。

python3 skills/stock/stock.py list '{"classid":1,"pagenum":1,"pagesize":10}'

请求 JSON：

{
  "classid": 1,
  "pagenum": 1,
  "pagesize": 10
}

字段名	类型	必填	说明
classid	int	是	1 沪深股市 3 港股 4 北证A股
pagenum	int	否	当前页，默认 1
pagesize	int	否	每页数量，默认 30

3. 股票详情查询（/stock/detail）

根据股票代码获取单只股票详情：最新价、最高/最低价、成交量、成交额、换手率、开盘价、昨收盘价、涨跌幅、涨跌额、振幅、量比、市盈率、市净率、更新时间等。

python3 skills/stock/stock.py detail '{"code":"300917"}'

请求 JSON：

{
  "code": "300917"
}

字段名	类型	必填	说明
code	string	是	股票代码

返回结果示例（节选）

股票查询（query）

[
  {
    "name": "特发服务",
    "code": "300917",
    "price": "51.08",
    "lastclosingprice": 51,
    "trendnum": "271",
    "updatetime": "2020-12-29 15:28:13",
    "trend": [
      "2020-12-29 09:30,51.08,1582,8082745.00,51.080",
      "2020-12-29 09:31,48.50,4282,21596207.00,50.612"
    ]
  }
]

股票列表（list）

{
  "pagesize": 10,
  "pagenum": 1,
  "total": "4486",
  "classid": 1,
  "list": [
    { "name": "信达增利", "code": "166105" },
    { "name": "R003", "code": "201000" }
  ]
}

股票详情（detail）

{
  "name": "C特发",
  "code": "300917",
  "classid": 1,
  "price": "40.70",
  "maxprice": "43.80",
  "minprice": "40.20",
  "tradenum": 76873,
  "tradeamount": "319857632.00",
  "turnoverrate": "36.030",
  "openningprice": "43.00",
  "lastclosingprice": "47.60",
  "changepercent": "-14.5",
  "changeamount": "-6.90",
  "amplitude": "7.56",
  "quantityratio": "1.03",
  "per": "41.91",
  "pbr": "5.36",
  "updatetime": "2020-12-22 11:56:20"
}

当接口返回业务错误时，脚本会输出：

{
  "error": "api_error",
  "code": 201,
  "message": "股票代码为空"
}

常见错误码

来源于 极速数据股票文档：

代号	说明
201	股票代码为空
202	股票代码不存在
210	没有信息

系统错误码：

代号	说明
101	APPKEY 为空或不存在
102	APPKEY 已过期
103	APPKEY 无请求此数据权限
104	请求超过次数限制
105	IP 被禁止
106	IP 请求超过限制
107	接口维护中
108	接口已停用

在 OpenClaw 中的推荐用法

1. 用户提问：「300917 这只股票今天行情怎么样？」
2. 代理可先调用：python3 skills/stock/stock.py detail '{"code":"300917"}' 获取最新价、涨跌幅、成交量等摘要；若需要当日分钟级走势，再调用 python3 skills/stock/stock.py query '{"code":"300917"}'。
3. 用户问「沪深股市有哪些股票」或「给我看一页港股列表」时，可调用：python3 skills/stock/stock.py list '{"classid":1,"pagenum":1,"pagesize":20}' 或 classid: 3 获取列表，再结合用户问题选取并展示名称、代码等信息。