Stock Inquiry - 股票查询

核心用法

极速数据股票查询（jisu-stock）是一款基于 JisuAPI 的 Python 股票数据获取工具，提供三类核心功能：

1. 股票实时查询（`/stock/query`）：按股票代码获取当日行情，含最新价、昨收价及分钟级趋势数组（时间、价格、成交量、成交额、均价），数据粒度精细，适合日内走势追踪。

2. 股票列表查询（`/stock/list`）：按市场分类（1=沪深股市、3=港股、4=北证A股）分页获取股票列表，支持自定义页码与每页数量，便于批量浏览或筛选。

3. 股票详情查询（`/stock/detail`）：获取单只股票的完整基本面数据，包括最新价、最高/最低价、成交量/额、换手率、开盘价、涨跌幅/额、振幅、量比、市盈率（PER）、市净率（PBR）等关键指标。

显著优点

• 数据权威：源自极速数据专业 API 平台，覆盖 A 股、港股、北交所三大市场，数据实时性高
• 接口简洁：统一 Python 脚本入口，通过子命令（query/list/detail）+ JSON 参数调用，易于集成到自动化工作流
• 字段丰富：详情接口提供 15+ 项技术指标，满足基础分析需求
• 分钟级趋势：query 接口返回当日分钟级成交数据，支持微观走势观察

潜在缺点与局限性

• 需外部 API Key：依赖极速数据账户，免费额度有限，高频调用需付费
• 非完整历史数据：仅限当日行情，历史 K 线需配合 stockhistory skill 使用
• 无技术分析功能：仅提供原始数据，不含均线、MACD、RSI 等计算
• 港股/北交所覆盖度：需确认具体股票代码是否在极速数据库范围内
• 无交易功能：纯数据查询，不支持下单或账户管理

适合人群

• 个人投资者：快速查盘、监控持仓、获取实时报价
• 量化爱好者：作为数据源接入自建分析系统
• 金融开发者：构建股票筛选、监控机器人等自动化工具
• 研究人员：批量获取市场列表与基础指标进行统计分析

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| API 密钥泄露 | `JISU_API_KEY` 若硬编码或日志泄露可能导致滥用 | 使用环境变量注入，定期轮换密钥 |

| 调用频率超限 | 免费/付费套餐均有次数限制（错误码 104） | 实施请求限流与缓存机制 |

| 数据延迟 | 极端行情下可能存在分钟级延迟 | 关键决策需交叉验证交易所官方数据 |

| 服务中断 | 极速数据可能维护（错误码 107）或停用接口（错误码 108） | 设计降级方案，备选数据源 |

| 代码格式风险 | 股票代码输入错误（201/202）导致查询失败 | 前端校验与错误处理封装 |

使用建议

推荐将本 skill 作为轻量级实时数据入口，搭配 stockhistory 进行历史回测，或接入 Grafana/自建看板实现可视化监控。开发时注意封装错误处理逻辑，对 101-108 错误码分级响应。

核心用法

jisu-stock 是一款面向金融数据查询场景的 OpenClaw Skill，通过与极速数据(JisuAPI)平台对接，为 Agent 提供标准化的股票数据获取能力。该技能支持三大核心功能模块：

股票实时查询（/stock/query）：根据股票代码获取当日分钟级行情数据，包括最新价、昨收盘价、更新时间，以及按时间维度排列的趋势数组（时间戳、价格、成交量、成交总额、平均价）。适用于需要追踪盘中走势、分析短期波动的场景。

股票列表查询（/stock/list）：按分类分页获取股票名录，支持沪深股市（classid=1）、港股（classid=3）、北证A股（classid=4）三大市场板块，可灵活配置页码和每页数量，便于批量筛选标的或构建股票池。

股票详情查询（/stock/detail）：获取单只股票的全面财务指标，涵盖最新价、最高/最低价、成交量/额、换手率、涨跌幅、振幅、量比、市盈率（PER）、市净率（PBR）等关键数据，为基本面和技术面分析提供数据支撑。

使用方式为通过 Python 脚本命令行调用，传入 JSON 格式的参数对象，返回结构化的 JSON 数据，便于 Agent 进一步解析和呈现。

显著优点

数据源专业可靠：极速数据是国内成熟的 API 数据服务商，专注金融数据领域多年，接口稳定性和数据准确性经过市场验证，覆盖 A 股、港股等主流市场。

功能边界清晰：三档接口分工明确，从列表浏览到详情概览再到分时走势，形成完整的数据查询闭环，满足不同深度的信息需求。

接入成本低廉：提供免费额度和阶梯套餐，个人开发者亦可零成本试用；仅需环境变量配置 API Key，无需复杂的基础设施搭建。

响应格式标准化：所有接口返回统一的 JSON 结构，错误码体系完善（201-210 业务错误、101-108 系统错误），便于程序化处理和异常熔断。

生态协同性强：官方推荐与 stockhistory 技能联用，可扩展至历史行情回溯、K 线研究等进阶场景，形成投研数据工具链。

潜在缺点与局限性

数据时效性受限：免费套餐可能存在调用频率限制，高频实时追踪场景下可能触发限流（错误码 104/106）；分钟级数据更新粒度对于毫秒级量化交易略显粗糙。

市场覆盖不全：当前仅支持沪深、港股、北证A股，未覆盖美股、期货、期权、基金等多元资产类别，全球资产配置需求无法一站式满足。

缺乏计算分析能力：技能定位为纯数据查询层，不内置技术指标计算（如 MACD、RSI）、财务建模或回测框架，复杂策略研究需用户自行二次开发。

输入验证待强化：安全报告指出 json.loads 解析用户输入时存在潜在的反序列化风险，虽当前实现已做异常捕获，但参数白名单校验（如股票代码格式、classid 枚举值）仍有提升空间。

网络依赖单一：所有数据请求均路由至 api.jisuapi.com 单一域名，若服务商出现区域性网络故障或接口维护（错误码 107），将直接影响服务可用性。

适合的目标群体

个人投资者与理财用户：需要快速查询持仓股票行情、了解市场涨跌动态的非专业用户，可通过自然语言与 Agent 交互获取直观数据呈现。

量化研究与策略开发者：将 jisu-stock 作为数据采集层，配合 Python 生态的 pandas、backtrader 等工具，进行因子挖掘、策略回测的前期数据准备。

金融科技产品经理与运营：构建智能客服、投教内容、行情推送等应用场景，利用结构化数据快速原型验证和 MVP 迭代。

高校金融专业师生：用于教学演示、课程作业、学术研究中的市场数据获取，替代繁琐的手工数据采集流程。

使用风险与注意事项

API 密钥安全管理：JISU_API_KEY 需通过环境变量配置，避免硬编码至代码仓库或日志输出；生产环境建议采用密钥管理服务（KMS）或私有配置中心，防止密钥泄露导致额度被盗用或账户封禁（错误码 105）。

调用配额与成本控制：免费额度耗尽后将按次计费，高频自动化调用需前置评估成本模型，建议实施本地缓存机制（如 LRU Cache）减少重复查询，并设置熔断策略应对连续失败场景。

数据延迟与决策风险：技能返回的数据存在网络传输和处理时滞，不宜作为高频交易或实时风控的唯一决策依据，关键投资决策应交叉验证交易所官方行情终端。

合规使用边界：获取的股票数据仅限个人研究、教学或非商业用途，若用于公开发布的投资建议、基金产品运作或商业化数据服务，需确认与极速数据的授权协议条款，避免合规风险。