opd-data
查询 OPD 金融数据接口(api.originp.com):A股上市公司基本信息、证券与行业分类、行情交易(日/周/月线、大宗交易、停复牌、异动)、财务报表与财务指标、融资融券与股权质押、IPO/增发/配股/分红、处罚诉讼担保等重大事项、股东/高管/股本等股权治理数据。当用户询问上市公司或股票相关数据时使用本技能。
OPD 金融数据查询
通过 OPD 数据接口(https://api.originp.com)查询 A 股上市公司数据,共 62 个接口、6 大类。
权限与数据流声明
本技能的全部外部行为如下,超出此范围的行为均非本技能所为:
- 网络:仅访问
https://api.originp.com(OPD_BASE_URL仅接受*.originp.com的 https 地址,脚本强制校验),发送查询参数与X-API-Key请求头;不向任何第三方地址发送数据。 - 环境变量:仅读取
OPD_API_KEY(密钥)与OPD_BASE_URL(调试用接口地址)。 - 文件:仅读写
~/.opd/api_key(密钥保存位置,唯一落盘文件),不访问其他文件。 - 依赖:仅使用 Python 标准库,不执行
pip install,不下载任何可执行文件。 - 图表:可视化需求委托
echarts-ai-skill技能处理(执行其 Node.js 脚本生成 HTML,并由用户本地浏览器打开查看);本技能脚本不自行绘图或访问网络获取图表资源。 - 密钥:不在对话中索取、回显或转发密钥;配置一律由用户在本地终端完成。
环境准备(首次使用,一次性)
-
获取 API Key:由 OPD 平台分配,形如
opd_xxx。注册/订阅等管理操作在https://data.originp.com/完成(该站提供页面服务);https://api.originp.com为接口调用地址,专供程序调用、不含页面。注意:除 Key 外还需订阅所需接口(试用或购买套餐),未订阅的接口调用会返回 BIZ_INTERFACE_FORBIDDEN。 -
配置 API Key(推荐:终端交互输入):指引用户在本地终端运行:
bash python scripts/opd_query.py --set-key按提示粘贴 Key(从标准输入读取,不进入命令历史,也不经过对话),保存到
~/.opd/api_key,脚本自动读取,无需重启即可生效。安全提示:不要请用户把 API Key 粘贴到对话消息中发送——对话记录可能被留存、转发或用于训练;也不要用
--set-key <Key>带值形式执行(Key 会留在 shell 命令历史)。若用户已把密钥发进对话,提醒其尽快在 OPD 平台重置该 Key。 -
(可选,兼容旧方式)配置环境变量
OPD_API_KEY:- Windows(用户级,需在配置后重启 OpenClaw Gateway 才会对 Agent 生效):
powershell [Environment]::SetEnvironmentVariable("OPD_API_KEY", "opd_你的Key", "User") - Linux/macOS:在 shell 配置文件中加入
export OPD_API_KEY=opd_你的Key
- Windows(用户级,需在配置后重启 OpenClaw Gateway 才会对 Agent 生效):
-
验证配置:
bash python scripts/opd_query.py --check python scripts/opd_query.py co_info --fields sec_code --limit 1返回 JSON 中
code=0即成功;--check会显示掩码与 Key 来源(--api-key参数 / 环境变量 / 配置文件)。
调用方法
使用本技能目录下的 scripts/opd_query.py(命令中的 scripts/opd_query.py 相对本技能目录,如 ~/.openclaw/workspace/skills/opd-data/;在其他目录执行时请使用完整路径):
python scripts/opd_query.py <接口短名> --fields <字段1,字段2,...> [--过滤参数 值 ...] [--limit N] [--offset N]
示例:
# 查询平安银行的证券简称与董事长
python scripts/opd_query.py co_info --fields sec_code,sec_name,chairman --sec_code 000001
# 查询 2024 年全年日行情收盘价(日期 between:两个边界逗号分隔)
python scripts/opd_query.py daily_quote_hist --fields trade_date,close --sec_code 000001 --trade_date 2024-01-01,2024-12-31 --limit 300
调用规范
- 鉴权:脚本自动读取 Key(优先级:
--api-key参数 > 环境变量OPD_API_KEY> 配置文件~/.opd/api_key,见"环境准备")。缺失或无效时脚本会报错——按下方"错误码与处置"指引用户修复,不要凭记忆编造数据。 - fields 必填:各接口返回字段可选值见 references/ 分类文档的"返回字段"表(标注"默认返回"的字段未指定时也会返回)。不传返回 BIZ_PARAM_INVALID。
- 统一响应:
{code, message, data};业务错误同为 HTTP 200,code != 0即失败。脚本业务错误退出码为 2(网络/HTTP 错误为 1)。 - 分页:
limit默认 20、最大 5000;offset为位移量。取全量数据时循环翻页直至 data 为空。 - 多值与区间:
in操作符参数(如sec_code)逗号分隔多值;between操作符参数(如日期)逗号分隔两个边界。 - 限频:每分钟 60 次,批量查询时控制节奏。
- 按需加载:先在下方速查表确定接口名与额外必填参数,再查阅对应 references/ 文档获取过滤参数与字段可选值;不要一次读取全部参考文档。
- 数据最小化:部分接口(如
co_info)默认返回联系电话、电子邮箱、统一社会信用代码等敏感字段(见 references/ 文档标注"默认返回"的字段)。查询时应仅选取所需字段,避免无差别全量获取导致敏感信息过度暴露。 - Key 安全:不在对话中索取、回显或转发用户密钥。配置一律指引用户在本地终端完成:
python scripts/opd_query.py --set-key(标准输入粘贴,不落命令历史)或环境变量方式。Key 仅保存到~/.opd/api_key(唯一允许的落盘位置),不得写入其他文件。若用户把密钥粘贴到了对话中,提醒其密钥已进入对话记录、存在泄露风险,建议在 OPD 平台重置后再以本地方式配置。
错误码与处置
| 现象 | 原因 | 处置 |
|---|---|---|
| 脚本提示"未配置 API Key" | Key 未配置(环境变量与配置文件均缺失) | 按"环境准备"指引用户在本地终端配置(--set-key 交互输入,无需重启;环境变量方式 Windows 下需重启 Gateway) |
code=20004(message:API Key 无效) | Key 错误或已失效 | 指引用户检查/重新获取 API Key,再用 --set-key 更新或改环境变量 |
message 含 BIZ_INTERFACE_FORBIDDEN | 未订阅该接口 | 告知用户需在 OPD 平台订阅(试用或购买套餐)该接口后重试 |
message 含 BIZ_PARAM_INVALID | 参数错误 | 检查 fields 是否遗漏、过滤参数名与可选值是否正确(对照 references/ 文档) |
| message 含"限频"或大量请求失败 | 超过每分钟 60 次 | 等待约 1 分钟后重试,批量任务放慢节奏 |
| HTTP 5xx / 退出码 1 | 网络或服务端异常 | 稍后重试;持续失败时报告用户服务端异常 |
接口速查表
基本信息(references/catalog_basic.md,6 个接口)
| 接口 | 名称 | 额外必填参数 |
|---|---|---|
co_info | 公司基本信息 | — |
industry_chg | 公司行业归属的变动 | sec_code |
security_info | 证券信息 | — |
sector | 股票所属板块 | — |
background | 股票背景资料 | sec_code |
intermediary | 中介机构 | — |
交易信息(references/catalog_trading.md,11 个接口)
| 接口 | 名称 | 额外必填参数 |
|---|---|---|
daily_quote_latest | 股票最新日行情 | — |
daily_quote_hist | 股票历史日行情 | sec_code、trade_date |
block_trade | 公司大宗交易 | sec_code |
abnormal_info | 沪深异动证券公开信息 | — |
suspend_resume | 证券交易停复牌信息 | — |
weekly_quote | 股票行情周报 | — |
monthly_quote | 股票行情月报 | — |
special_notice | 证券交易特别提示 | — |
multi_market_daily | 多市场交易日报 | — |
weekly_acct_stats | 一周股票账户情况统计 | — |
ipo_approval | 新股过会情况 | — |
财务信息(references/catalog_finance.md,16 个接口)
| 接口 | 名称 | 额外必填参数 |
|---|---|---|
perf_forecast | 公司业绩预告 | sec_code |
perf_express | 公司业绩快报 | sec_code |
fin_indicators | 上市公司财务指标 | sec_code |
bs | 上市公司资产负债表 | sec_code |
is | 上市公司利润表 | sec_code |
cf | 上市公司现金流量表 | sec_code |
bs_fin | 金融类上市公司资产负债表 | sec_code |
is_fin | 金融类上市公司利润表 | sec_code |
cf_fin | 金融类上市公司现金流量表 | sec_code |
rev_by_product | 分产品主营业务收入 | sec_code |
rev_by_industry | 分行业主营业务收入 | sec_code |
rev_by_region | 分地区主营业务收入 | sec_code |
audit_opinion | 定期报告审计意见 | sec_code |
pre_disclosure_date | 定期报告预披露时间 | sec_code |
top5_suppliers | 公司前五大供应商信息表 | sec_code |
top5_customers | 公司前五大客户信息表 | sec_code |
融资分配(references/catalog_financing.md,8 个接口)
| 接口 | 名称 | 额外必填参数 |
|---|---|---|
margin_trade | 公司融资融券 | target_security_code |
pledge_ratio | 单一股票质押比例 | sec_code |
issuance_plan | 公司增发股票实施方案 | — |
rights_issue_plan | 公司配股实施方案 | — |
ipo | 公司首发股票 | — |
dividend_cap | 公司分红转增 | — |
ipo_review | 公司首发股票审核信息 | — |
underwriting | 股票发行中介机构及承销情况 | — |
重大事项(references/catalog_events.md,6 个接口)
| 接口 | 名称 | 额外必填参数 |
|---|---|---|
penalty | 公司受处罚记录 | sec_code |
arbitration | 公司仲裁 | — |
litigation | 公司诉讼 | — |
asset_freeze | 公司资产冻结 | — |
external_guarantee | 公司对外担保 | — |
related_party_trade | 公司日常关联交易 | — |
股权与治理(references/catalog_governance.md,15 个接口)
| 接口 | 名称 | 额外必填参数 |
|---|---|---|
actual_controller | 公司实际控制人 | sec_code |
capital_chg | 公司股本变动 | sec_code |
major_sh | 主要股东持股 | sec_code |
sh_count | 公司股东人数 | sec_code |
top10_circulating_sh | 十大流通股东持股变化 | sec_code |
top10_sh | 十大股东持股变化 | sec_code |
major_sh_chg | 大股东增(减)持情况 | sec_code |
sh_freeze | 公司股东股份冻结 | sec_code |
sh_pledge | 公司股东股份质押 | sec_code |
holding_concentration | 股东持股集中度 | sec_code |
mgmt_holding | 上市公司管理层持股及报酬 | sec_code |
management | 公司管理人员情况 | sec_code |
employee | 公司员工情况 | sec_code |
restricted_release_date | 受限股份实际解禁日期 | sec_code |
restricted_listing_date | 受限股份流通上市日期 | sec_code |
图表输出
统一使用 echarts-ai-skill 生成图表(交互式 HTML)。不要探测或使用 matplotlib、mplfinance、pyecharts 等 Python 绘图库——本机不作为绘图路线,探测它们只会产生报错。也不要执行 pip install 安装绘图库。
用户需要可视化时,将查询结果交给 echarts-ai-skill 技能渲染(交互式 HTML,浏览器打开查看):
- 用本技能查询数据后,将
data数组整理为ChartRequestJSON(dataset即行数组,字段名对应接口返回字段)。 - 调用 echarts-ai-skill 的命令生成图表(工作目录为其技能目录):
powershell node dist\cli\generate-chart.js --input <request.json> --out <option.json> node dist\cli\render-chart.js --input <option.json> --format html --out <输出路径.html> - 用
start <输出路径.html>为用户打开浏览器查看。
常用图表映射:
| 需求 | ChartRequest 要点 |
|---|---|
| K 线图 | chartType: "candlestick",xField: trade_date,openField: open,closeField: close,lowField: low,highField: high(数据来自 daily_quote_hist,fields 至少取这五个字段) |
| 折线(趋势) | goal: "trend",xField 为日期字段,series 为指标字段列表 |
| 柱状(对比) | goal: "comparison",categoryField 为分类字段,valueField 为数值字段 |
| 饼图(构成) | goal: "composition",一个分类字段 + 一个数值字段(如收入构成 rev_by_product) |
复杂需求可用 rawOption 透传任意 ECharts 配置。
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 2mo ago
- Current version
- v1.0.2
- License
- MIT-0
