dvcrn 极速数据股票查询（Jisu Stock）
基于 股票查询 API 的 OpenClaw 技能，支持：
- 股票查询（
/stock/query）：根据股票代码查询当日行情，数据粒度为分钟，含趋势数据 - 股票列表查询（
/stock/list）：按分类（沪深股市/港股/北证A股）分页获取股票列表 - 股票详情查询（
/stock/detail）：根据股票代码获取单只股票详情（最新价、涨跌幅、成交量、市盈率等）
使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/stock/
环境变量配置
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
脚本路径
脚本文件：skill/stock/stock.py
使用方式
1. 股票查询（/stock/query）
根据股票代码查询当日行情，返回名称、代码、最新价、昨收盘价、数据量、更新时间及按分钟维度的趋势数组（时间、价格、成交量、成交总额、平均价）。
python3 skill/stock/stock.py query '{"code":"300917"}'
请求 JSON：
{
"code": "300917"
}
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 股票代码 |
2. 股票列表查询（/stock/list）
按分类分页获取股票列表。分类：1 沪深股市，3 港股，4 北证A股。
python3 skill/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 skill/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 中的推荐用法
- 用户提问：「300917 这只股票今天行情怎么样？」
- 代理可先调用：
python3 skill/stock/stock.py detail '{"code":"300917"}'获取最新价、涨跌幅、成交量等摘要；若需要当日分钟级走势，再调用python3 skill/stock/stock.py query '{"code":"300917"}'。 - 用户问「沪深股市有哪些股票」或「给我看一页港股列表」时，可调用：
python3 skill/stock/stock.py list '{"classid":1,"pagenum":1,"pagesize":20}'或classid: 3获取列表，再结合用户问题选取并展示名称、代码等信息。