1018466411/openclaw-stock-skill
/SKILL.md
使用 data.diemeng.chat 提供的接口查询股票日线、分钟线、财务指标等数据，支持 A 股等市场。
$ install --global
skillsauthnpx skillsauth add 1018466411/openclaw-stock-data-skill openclaw-stock-skillInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Error
VirusTotalMulti-engine malware detection
70%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 21, 2026, 4:15 AM144.8s9 files scanned
SKILL.md
- name:
- openclaw-stock-skill
- description:
- 使用 data.diemeng.chat 提供的接口查询股票日线、分钟线、财务指标等数据，支持 A 股等市场。
- user-invocable:
- true
- metadata:
- {
- "openclaw":
- {
- "emoji":
- 📈",
- "skillKey":
- openclaw-stock-skill",
- "requires":
- { "env": ["STOCK_API_KEY"] },
- "primaryEnv":
- STOCK_API_KEY
� 核心能力
本技能提供强大的股票数据查询与分析能力，主要包含：
- 实时数据：提供实时股票快照、实时分时行情。
- 历史数据：支持查询股票、可转债、ETF、指数等品种的历史数据（日线、分钟线、财务指标等）。
- 自定义通知（开发中）：支持涨停、炸板、放量大涨、涨停大额成交等异动信号的自定义消息通知。
�📥 安装方法
npx skills add https://github.com/1018466411/openclaw-stock-data-skill
安装时按提示选择：
- 选择 openclaw
- 选择 global 应用于所有 Agent
- Copy to all agents: yes
本技能教会代理如何使用你自建的股票数据服务（注册账号 https://data.diemeng.chat），通过 API Key 进行鉴权，查询股票的日线、分钟线、财务指标等数据。
⚙️ API Key 配置约定
- OpenClaw 会按照
skills.entries.<key>配置 把 API Key 和自定义配置注入到进程环境变量中。- 本技能约定使用环境变量
STOCK_API_KEY作为主密钥，并在metadata.openclaw.primaryEnv中声明，以便通过skills.entries.openclaw-stock-skill.apiKey统一配置。- 推荐的 OpenClaw 配置示例（
~/.openclaw/openclaw.json）：{ skills: { entries: { "openclaw-stock-skill": { enabled: true, // 建议在 OpenClaw UI 的 Skill 参数面板里填写 apiKey， // Gateway 会自动将其写入 STOCK_API_KEY 环境变量 apiKey: { source: "env", provider: "default", id: "STOCK_API_KEY" }, env: { // 可在这里直接写死，或通过系统环境变量覆盖 STOCK_API_KEY: "YOUR_REAL_STOCK_API_KEY" }, config: { // 可选：覆盖默认域名 baseUrl: "https://data.diemeng.chat" } } } } }参考文档：Skills Config、Skills
⚠️ 重要说明
1. 权限开通与 403 错误
如果 API 返回 403 错误，说明您的账号没有开通对应接口的权限。
请务必访问官网 https://data.diemeng.chat/（海外请访问 https://mg.diemeng.chat/），在个人中心开通所需权限（如股票行情、实时快照、可转债等）。
2. 接口类型区分
- 实时接口：
get_stock_snapshot_daily（不传日期或传今日）：获取最新实时快照（价格、成交量、五档盘口等）。get_stock_snapshot_push_history：获取实时推送的历史记录。get_call_auction：获取集合竞价数据。
- 历史接口：
get_daily_data：获取历史日 K 线。get_kline_data：获取历史周期K线（周K、月K）。get_kline_adj_data：获取复权历史周期K线（周K、月K）。get_history_data：获取历史分钟线。get_finance_data：获取历史财务指标。get_financial_indicator：获取财务指标报表数据（stock_financial_indicator）。get_income_statement：获取利润表数据（stock_income）。get_balancesheet：获取资产负债表数据（stock_balancesheet）。get_cashflow_statement：获取现金流量表数据（stock_cashflow）。get_main_fund_flow：获取大小单资金金流向。get_main_fund_flow_overview：获取主力资金流向总览。get_cyq_chips：获取筹码峰分布。get_holder_number：获取股东人数数据。get_pledge_stat：获取股票质押统计数据。get_margin_detail：获取融资融券明细数据。get_stock_snapshot_daily（传历史日期）：获取历史快照。
- 指数与板块接口：
get_index_history：获取指数分钟级历史数据。get_index_realtime_history：获取指数当天实时 1 分钟级别分时数据。get_index_weight：获取指数月度成分和权重数据（index_code 必传，可按 stock_code 和 trade_date 筛选）。get_ths_sector_categories：获取同花顺板块分类数据。get_ths_constituent_stocks：获取同花顺成分股数据。get_dc_blocks：获取东方财富板块列表。get_dc_daily：获取东方财富板块日K（按交易日或板块代码）。get_dc_block_stocks：获取东方财富板块成分股（支持板块/日期/股票筛选，空参默认最新日期）。get_tdx_block_stocks：获取通达信板块成分股，返回分页结构data.total/page/page_size/list，其中list项包含block_code、block_name、block_type、stock_code。
总体说明
- 获取正确的 API Key 并验证：
- 一定要获取到正确的 apiKey 才可以调用接口。
- 获取途径：优先从环境变量
STOCK_API_KEY读取，或从当前目录的config.json获取。如果在 Skill 面板配置了也会注入到环境变量中。
- 基础域名：默认接口的域名是
data.diemeng.chat，如果是海外 IP 则访问mg.diemeng.chat。 - 鉴权方式：所有需要权限的接口都必须带上 API Key，并且必须放到 HTTP Header 里面：
apiKey: <STOCK_API_KEY>（强制要求）Content-Type: application/json
- 返回结构：
- 大多数接口返回：
{ "code": 200, "msg": "成功", "data": { ... } } - 少数列表类接口直接返回数组或简单结构，实际响应以 JSON 为准。
- 大多数接口返回：
- 限流与黑名单：
- API Key 及 IP 都有严格限流与黑名单逻辑：
- 无效 API Key 多次尝试会触发封禁（参见后端
DataAccessVerifier实现）。 - 需优先缓存和复用同一 API Key，不要在循环中频繁切换。
- 无效 API Key 多次尝试会触发封禁（参见后端
- API Key 及 IP 都有严格限流与黑名单逻辑：
- ⚠️ 数据量限制：除特别说明外，大多数列表类接口单次请求最多返回 10000 条数据。如需获取更多数据，请使用分页参数。
能力概览（建议的工具意图）
代理应将本技能视作一组 HTTP 能力，而不是单一接口：
- get_stock_daily_bars：查询指定股票在某一时间区间内的日线 K 线数据。
- get_stock_intraday_bars：查询分钟级（1/5/15/30/60 分钟）历史数据。
- get_stock_finance_factors：查询日度财务因子（PE、PB、换手率等）。
- get_stock_main_fund_flow：查询主力资金流向明细（按时间范围/股票代码，支持仅传其一）。
- get_stock_main_fund_flow_overview：查询主力资金流向总览（净流入率与分档统计）。
- get_stock_limit_up：查询涨停明细数据（封单、连板、涨停原因等）。
- get_stock_list：查询股票基础信息列表，用于代码／名称搜索。
- get_stock_calendar_and_snapshot：查询交易日历和当日快照。
- get_stock_search：使用自然语言条件搜索符合条件的股票（如"PE<20 且换手率>3%"）。
- get_stock_call_auction：查询集合竞价数据。
- get_stock_closing_snapshot：查询收盘快照数据。
- get_stock_snapshot_daily：查询实时或历史股票快照（含 Redis 缓存加速）。
- get_stock_suspension：查询股票停牌信息。
- get_stock_adj_factor：查询复权因子。
- get_bond_daily：查询可转债日线数据。
- get_bond_indicator_daily：查询可转债日指标数据。
- get_bond_list：查询可转债列表信息。
- get_index_realtime_history：查询指数当天实时 1 分钟级别分时数据。
- get_index_weight：查询指数月度成分和权重数据（可选按成分股过滤）。
代理在规划调用时，应根据用户自然语言意图，选择以上能力并组合使用。
接口详情与调用规范
1. 日线数据：POST /api/stock/daily
- URL：
{baseUrl}/api/stock/daily - 方法：
POST - Headers：
Content-Type: application/jsonapiKey: <STOCK_API_KEY>
- 请求体 JSON（后端
DailyDataRequest）：
{
"stock_code": "000001.SZ",
"start_time": "2024-01-01",
"end_time": "2024-01-31",
"volType": "share",
"page": 0,
"page_size": 1000
}
- 说明：
stock_code可以是单个字符串，也可以是字符串数组。start_time、end_time格式为YYYY-MM-DD。volType可选：share（默认，按股返回）或lot（按手返回，1手=100股）。- 支持分页，
page从 0 开始。
- 响应字段：
data.total：总记录数data.list：每条记录包含stock_code,stock_name,trade_date,open,high,low,close,vol,amount等字段，价格与成交量已在后端统一保留 2 位小数，vol单位由volType决定。
- 响应主体（简化）：
data.total：总记录数data.list：每条记录包含stock_code,trade_date,open,high,low,close,vol,amount等字段，价格与成交量已在后端统一保留 2 位小数。
1.1 复权日线：POST /api/stock/daily_adj
- 请求参数与
POST /api/stock/daily基本一致，额外支持algo（recursive/factor）。 - 新增
volType可选参数：share（默认，按股）或lot（按手）。 - 为兼容历史调用，未传
volType时保持旧行为（按股返回）。
代理在需要“某股某段时间的日 K 线”时，应优先选择该接口。
2. 分钟级历史数据：POST /api/stock/history
- URL：
{baseUrl}/api/stock/history - 方法：
POST - Headers：同上
- 请求体 JSON（后端
HistoryDataRequest）：
{
"stock_code": "000001.SZ",
"level": "5min",
"start_time": "2024-01-01 09:30:00",
"end_time": "2024-01-01 15:00:00",
"page": 0,
"page_size": 1000
}
- 字段说明：
stock_code：仅支持单个股票代码字符串（不支持数组）level："1min" | "5min" | "15min" | "30min" | "60min"start_time/end_time：- 允许仅日期（自动补全 00:00:00 和 23:59:59）
- 或完整时间戳
YYYY-MM-DD HH:MM:SS
- 响应主体（简化）单位手：
data.list中每条包含：stock_code,trade_time,open,high,low,close,vol,amount。
用于用户询问“某天/某段时间内的分钟级行情、分时数据”等场景。
3. 实时分时数据(支持最近7天内)：POST /api/realtime/history 及 /api/index/realtime/history
- URL：
{baseUrl}/api/realtime/history或{baseUrl}/api/index/realtime/history - 方法：
POST - Headers：同上
- 请求体 JSON：
{
"stock_code": "000001.SZ",
"trade_time": "2026-03-15 09:31:00",
"date": "2026-03-15"
}
(对于指数接口，参数名为 index_code)
- 说明：
- 获取实时 1 分钟级别分时数据，支持最近7天内，支持全市场或指定股票/指数。
stock_code/index_code或trade_time至少提供一个。- 返回数据会根据代码 +
trade_time进行去重。
调用建议（定时任务拉取全市场数据）：
- 建议使用时间 (
trade_time) 来获取实时分时，一次可以获取某一分钟的全市场数据。- 使用定时任务来获取数据，每分钟获取上一分钟的数据。
- 建议在每分钟的 2 到 5 秒后开始获取。
- 如果获取不到，建议暂停 1 秒后继续获取，最多重试不要超过 60 次，避免陷入死循环。
- 建议在每分钟 15 秒之后再调用接口更新一次数据，确保数据的准确性。
3.1 指数成分与权重：POST /api/index/weight
- URL：
{baseUrl}/api/index/weight - 方法：
POST - Headers：同上
- 请求体 JSON：
{
"index_code": "000300.SH",
"stock_code": "600519.SH",
"trade_date": "2026-03-31",
"page": 0,
"page_size": 2000
}
- 字段说明：
index_code（必填）：指数代码stock_code（可选）：成分股代码，支持字符串或数组（后端按con_code过滤）trade_date（可选）：支持YYYY-MM或YYYY-MM-DD，查询时仅按年和月过滤trade_date不传时默认返回该指数最新月份数据
- 返回字段：
index_code,stock_code,trade_date,weight
4. 财务与因子（行情因子）：POST /api/stock/finance
- URL：
{baseUrl}/api/stock/finance - 方法：
POST - 请求体 JSON（后端
FinanceDataRequest）：
{
"stock_code": "000001.SZ",
"start_time": "2024-01-01",
"end_time": "2024-03-31",
"page": 0,
"page_size": 1000
}
- 主要返回字段（列表中每条）：
stock_code,stock_name,trade_date,close,turnover_rate,turnover_rate_f,volume_ratio,pe,pe_ttm,pb,ps,ps_ttm,dv_ratio,dv_ttm,total_share,float_share,free_share,total_mv,circ_mv等。
适合估值分析、换手率、成交金额、市值等相关问题。
4.0 财务指标报表数据：POST /api/stock/financial_indicator
- URL：
{baseUrl}/api/stock/financial_indicator - 方法：
POST - 请求体 JSON：
{
"stock_code": "600000.SH",
"end_date": "2025-12-31",
"ann_date": "2026-03-28",
"page": 0,
"page_size": 1000
}
- 字段说明：
stock_code：股票代码，支持字符串或数组end_date：报告期最后日期，格式YYYY-MM-DDann_date：公告日期，格式YYYY-MM-DDstock_code/end_date/ann_date三选一至少提供一个page从 0 开始，page_size最大 10000
- 主要返回字段（实际会返回
stock_financial_indicator全字段）：- 基础标识：
stock_code,ann_date,end_date,update_flag,create_time - 盈利能力：
eps,dt_eps,profit_dedt,op_income,ebit,ebitda,gross_margin,grossprofit_margin,netprofit_margin - 资产收益：
roe,roe_dt,roe_yearly,roa,roa_yearly,roic,roic_yearly - 现金与每股：
bps,ocfps,cfps - 偿债能力：
current_ratio,quick_ratio,debt_to_assets - 增长能力：
basic_eps_yoy,netprofit_yoy,dt_netprofit_yoy,tr_yoy,or_yoy,q_sales_yoy,q_netprofit_yoy - 研发投入：
rd_exp
- 基础标识：
- 完整返回字段：返回
stock_financial_indicator全字段（除update_flag、create_time）。
4.0.1 利润表数据：POST /api/stock/income
- URL：
{baseUrl}/api/stock/income - 方法：
POST - 请求体 JSON：
{
"stock_code": "600000.SH",
"end_date": "2025-12-31",
"ann_date": "2026-03-28",
"page": 0,
"page_size": 1000
}
- 字段说明：
stock_code：股票代码，支持字符串或数组end_date：报告期最后日期，格式YYYY-MM-DDann_date：公告日期，格式YYYY-MM-DDstock_code/end_date/ann_date三选一至少提供一个page从 0 开始，page_size最大 10000
- 完整返回字段：返回
stock_income全字段（除update_flag、create_time）。
4.0.2 资产负债表数据：POST /api/stock/balancesheet
- URL：
{baseUrl}/api/stock/balancesheet - 方法：
POST - 请求参数与
/api/stock/income完全一致（stock_code/end_date/ann_date三选一至少传一个）。 - 完整返回字段：返回
stock_balancesheet全字段（除update_flag、create_time）。
4.0.3 现金流量表数据：POST /api/stock/cashflow
- URL：
{baseUrl}/api/stock/cashflow - 方法：
POST - 请求参数与
/api/stock/income完全一致（stock_code/end_date/ann_date三选一至少传一个）。 - 完整返回字段：返回
stock_cashflow全字段（除update_flag、create_time）。
4.1 主力资金流向明细：POST /api/stock/main_fund_flow
- URL：
{baseUrl}/api/stock/main_fund_flow - 方法：
POST - 请求体 JSON：
{
"start_time": "2026-04-03",
"end_time": "2026-04-03",
"stock_code": ["600000.SH", "000001.SZ"],
"page": 0,
"page_size": 1000
}
- 字段说明：
start_time/end_time：交易日期范围，格式YYYY-MM-DD，闭区间；当start_time = end_time时可查询当天数据stock_code：股票代码，支持字符串或数组stock_code和 (start_time+end_time) 至少提供其一page从 0 开始，page_size最大 10000
- 分档口径：
- 小单：成交额 < 5万
- 中单：成交额 5万 ~ 20万
- 大单：成交额 20万 ~ 100万
- 特大单：成交额 >= 100万
- 主要返回字段：
trade_date,stock_codebuy_sm_vol,buy_sm_amount,sell_sm_vol,sell_sm_amountbuy_md_vol,buy_md_amount,sell_md_vol,sell_md_amountbuy_lg_vol,buy_lg_amount,sell_lg_vol,sell_lg_amountbuy_elg_vol,buy_elg_amount,sell_elg_vol,sell_elg_amountnet_mf_vol,net_mf_amount
4.2 主力资金流向总览：POST /api/stock/main_fund_flow_overview
- URL：
{baseUrl}/api/stock/main_fund_flow_overview - 方法：
POST - 请求体 JSON：
{
"start_time": "2026-04-03",
"end_time": "2026-04-03",
"stock_code": "600000.SH",
"page": 0,
"page_size": 1000
}
- 字段说明：
start_time/end_time：交易日期范围，格式YYYY-MM-DD，闭区间；当start_time = end_time时可查询当天数据stock_code：股票代码，支持字符串或数组stock_code和 (start_time+end_time) 至少提供其一page从 0 开始，page_size最大 10000
- 分档口径：
- 小单：成交额 < 5万
- 中单：成交额 5万 ~ 20万
- 大单：成交额 20万 ~ 100万
- 特大单：成交额 >= 100万
- 主要返回字段：
trade_date,stock_code,name,close,pct_changenet_amount,net_amount_ratebuy_elg_amount,buy_elg_amount_ratebuy_lg_amount,buy_lg_amount_ratebuy_md_amount,buy_md_amount_ratebuy_sm_amount,buy_sm_amount_rate
4.3 筹码峰分布：POST /api/stock/cyq_chips
- URL：
{baseUrl}/api/stock/cyq_chips - 方法：
POST - 请求体 JSON：
{
"start_time": "2026-04-03",
"end_time": "2026-04-03",
"stock_code": "600000.SH",
"page": 0,
"page_size": 1000
}
- 字段说明：
start_time/end_time：交易日期范围，格式YYYY-MM-DD，闭区间；当start_time = end_time时可查询当天数据stock_code：股票代码，支持字符串或数组stock_code和 (start_time+end_time) 至少提供其一page从 0 开始，page_size最大 10000
- 主要返回字段：
trade_date,stock_code,price,percent
4.4 股票基础信息列表：GET /api/stock/list
- URL：
{baseUrl}/api/stock/list - 方法：
GET - Query 参数：
stock_code（可选）：精确股票代码筛选page：默认 0page_size：默认 20000
- 响应（封装在统一
success结构中）：data.totaldata.list：包含stock_code,name,area,industry,list_date,symbol,list_status,delist_date,is_hs等。
当用户只给出股票名称、地区、行业等描述时，可先通过该接口获取匹配列表，再提示用户选择具体代码。
5. 交易日历：GET/POST /api/basic/calendar
- URL：
{baseUrl}/api/basic/calendar - 方法：
GET/POST - 请求参数：
start_time:YYYY-MM-DDend_time:YYYY-MM-DD
- 响应：
data为数组，每条含date,is_open（1 为交易日，0 为休市）。
当用户问“某段时间哪些是交易日”“下一个交易日是什么时候”等，可使用此接口。
6. 股票条件搜索：POST /api/stock/search
- URL：
{baseUrl}/api/stock/search - 方法：
POST - Headers：
Content-Type: application/jsonapiKey: <STOCK_API_KEY>
- 请求体 JSON：
{
"query": "pe_ttm < 20 且 turnover_rate > 3%",
"stock_code": "000001.SZ",
"date": "2024-01-01",
"page": 0,
"page_size": 100,
"sort_by": "pe_ttm",
"sort_order": "asc"
}
- 字段说明：
query（必填）：搜索条件，支持自然语言或表达式- 支持格式：
pe_ttm < 20、turnover_rate > 3%、pe_ttm < 20 且 turnover_rate > 3% - 支持中文：
市盈率小于20、换手率大于3% - 支持单位：
circ_mv > 100亿、volume > 1000万
- 支持格式：
stock_code（可选）：精确股票代码筛选date（可选）：日期，格式YYYY-MM-DD或MM-DD（默认为当年）- 不提供日期：查询
stock_snapshot_daily（最新实时数据） - 提供日期：查询
stock_finance_daily（历史财务数据）
- 不提供日期：查询
page：页码，从 0 开始page_size：每页数量，最大 1000sort_by（可选）：排序字段，如pe_ttm、turnover_ratesort_order（可选）：排序方向asc或desc（默认 desc）
- 支持的字段：
price/close：股价/收盘价pct_chg：涨跌幅turnover_rate：换手率pe/pe_ttm：市盈率pb：市净率total_mv/circ_mv：总市值/流通市值total_share/float_share：总股本/流通股本volume/turnover：成交量/成交额dividend_ratio：股息率
- 响应主体：
data.total：总记录数data.list：符合条件的股票列表
重要提醒：该接口单次请求最多返回 1000 条数据。如需获取更多结果，请使用分页功能。
适用场景：用户需要根据财务指标筛选股票，如"帮我找出 PE<20 的股票"、"换手率大于 5% 的股票有哪些"。
7. 期货数据
- 获取合约基础信息 (
get_future_basic)：获取期货合约的基础信息数据，包括乘数、交割方式、上市日期等。 - 获取主连合约映射 (
get_future_mapping)：获取期货主连或连续合约与实际月合约的映射关系。 - 获取分钟K线数据 (
get_future_minute)：获取期货合约的历史分钟K线数据。
8. 集合竞价数据：POST /api/stock/call_auction
- URL：
{baseUrl}/api/stock/call_auction - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"stock_code": "000001.SZ",
"start_time": "2024-01-01 09:15:00",
"end_time": "2024-01-01 09:25:00",
"page": 0,
"page_size": 100
}
- 字段说明：
start_time/end_time：时间范围，支持仅日期（自动补全时间）page_size：最大 10000
- 返回字段：
stock_code,name,trade_time,close,open,high,low,pre_close,vol,amount,turnover_rate,pe,pb,pe_ttm,dv_ttm等
重要提醒：单次请求最多返回 10000 条数据。
9. 收盘快照数据：POST /api/stock/closing_snapshot
- URL：
{baseUrl}/api/stock/closing_snapshot - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"stock_code": "000001.SZ",
"start_time": "2024-01-01 15:00:00",
"end_time": "2024-01-01 15:05:00",
"page": 0,
"page_size": 100
}
- 返回字段：包含价格、成交量、买卖盘、涨跌幅等完整快照数据
重要提醒：单次请求最多返回 10000 条数据。
10. 股票快照数据（实时/历史）：POST /api/stock/snapshot_daily
- URL：
{baseUrl}/api/stock/snapshot_daily - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"stock_code": "000001.SZ",
"date": "2024-01-01",
"page": 0,
"page_size": 10000
}
- 特性：
- 实时快照：如果不提供
date或提供今日日期，系统优先从 Redis 缓存读取最新的实时快照数据。 - 历史快照：如果提供历史日期，系统返回当天的历史快照数据。
- 返回字段包含 40+ 个指标：价格、成交量、市值、PE、PB、买卖盘等。
page_size：最大 10000。
- 实时快照：如果不提供
重要提醒：这是获取实时行情快照的主要接口。
11. 推送历史数据：POST /api/stock/snapshot_push_history
- URL：
{baseUrl}/api/stock/snapshot_push_history - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 说明：查询 WebSocket 推送历史，返回快照数组
12. 停牌信息：GET /api/stock/suspension
- URL：
{baseUrl}/api/stock/suspension - 方法：
GET - Headers：
apiKey: <STOCK_API_KEY> - Query 参数：
stock_code（可选）trade_date（可选）page,page_size
13. 复权因子：POST /api/stock/adj_factor
- URL：
{baseUrl}/api/stock/adj_factor - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"stock_code": "000001.SZ",
"start_time": "2024-01-01",
"end_time": "2024-01-31",
"page": 0,
"page_size": 10000
}
- 返回字段：
stock_code,stock_name,trade_date,factor_a,factor_b（自定义复权因子）
重要提醒：单次请求最多返回 10000 条数据。
14. 数据下载（整日行情）：POST /api/stock/daily_dump
- URL：
{baseUrl}/api/stock/daily_dump - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"date": "2024-01-01",
"level": "daily"
}
level参数：daily|1min|5min|15min|30min|60min- 返回：gzip 压缩的 JSON 文件（通过 Nginx 高性能下载）
- 限制：
- 只能下载最近 90 天的数据
- 数据量较大，每个用户每个日期每天最多下载 10 次，超过后会被禁止下载该日期三天，请联系客服解封
- 当日数据需收盘后（15:05 后）才能下载
15. 可转债日线数据：POST /api/bond/daily
- URL：
{baseUrl}/api/bond/daily - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"stock_code": "128136.SZ",
"start_time": "2024-01-01",
"end_time": "2024-01-31",
"page": 0,
"page_size": 10000
}
- 字段说明：
stock_code（可选）：可转债代码，如128136.SZ，支持数组start_time、end_time：格式为YYYY-MM-DD
- 返回字段：
stock_code,stock_name,trade_date,open,high,low,close,prev_close,change,pct_chg,factor,vol,amount
单次请求最多返回 10000 条数据。
16. 可转债日指标数据：POST /api/bond/indicator_daily
- URL：
{baseUrl}/api/bond/indicator_daily - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"stock_code": "128136.SZ",
"start_date": "2024-01-01",
"end_date": "2024-01-31",
"page": 0,
"page_size": 10000
}
- 字段说明：
stock_code（可选）：可转债代码，支持数组start_date、end_date（可选）：日期范围，至少提供一个
- 返回字段：
stock_code,stock_name,trade_date,name,pre_close,open,high,low,close,change,pct_chg,vol,amount,remain_size,pure_bond,pure_premium,conv_value,conv_premium等
单次请求最多返回 10000 条数据。
17. 可转债列表：POST /api/bond/list
- URL：
{baseUrl}/api/bond/list - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"bond_code": "128136.SZ",
"stock_code": "000001.SZ",
"exchange": "SZSE",
"page": 0,
"page_size": 10000
}
- 字段说明：
bond_code（可选）：可转债代码筛选stock_code（可选）：正股代码筛选exchange（可选）：交易所筛选（SZSE/SSE）
- 返回字段：包含
bond_code,bond_name,bond_short_name,conv_code,stock_code,stock_name等完整可转债信息
18. 涨停明细数据：POST /api/stock/limit_up
- URL：
{baseUrl}/api/stock/limit_up - 方法：
POST - Headers：
apiKey: <STOCK_API_KEY> - 请求体 JSON：
{
"stock_code": ["603716.SH", "000001.SZ"],
"start_time": "2026-04-10",
"end_time": "2026-04-10",
"page": 0,
"page_size": 10000
}
- 字段说明：
stock_code（可选）：股票代码，支持字符串或数组start_time、end_time（必填）：日期范围，格式YYYY-MM-DDpage：页码，从 0 开始page_size：每页数量，最大 10000
- 返回字段：
- 基础信息：
trade_date,stock_code,stock_name,price,change_percent - 封单信息：
sealed_volume,sealed_amount,sealed_turnover_ratio,sealed_flow_ratio - 涨停过程：
first_limit_time,final_limit_time,open_count,consecutive_days,boards - 业务标签：
limit_type,is_limit_up,reason_text
- 基础信息：
19. 同花顺热度榜：GET /api/ths/hot / POST /api/ths/hot
- URL：
{baseUrl}/api/ths/hot - 方法：
GET/POST - Headers：
apiKey: <STOCK_API_KEY> - 参数：
market（可选）：热榜类型 (默认：热股)。可选值：热股,ETF,可转债,行业板块,概念板块,期货trade_date（可选）：指定交易日期，支持YYYY-MM-DD或YYYYMMDD；不传默认返回最新交易日GET使用 Query 参数，POST使用 JSON Body
- 返回字段：
trade_date: 交易日期update_time: 排行榜更新时间list: 热榜数据列表，包含name(名称),code(代码),rank(排名),pct_change(涨跌幅%),hot(热度值)
20. 涨跌停推送 WS 订阅：GET {{WS_BASE_URL}}/ws/stream
-
URL：
{{WS_BASE_URL}}/ws/stream?token=<STOCK_API_KEY>&types=... -
协议：WebSocket
-
鉴权：Query 参数
token（使用 API Key） -
订阅参数：
types（逗号分隔，支持多选） -
六类推送与订阅值：
- 涨停推送：
limit_up - 涨停炸板：
limit_up_broken - 涨停股数据推送（聚合）：
stock_limit_up（包含limit_up+limit_up_broken） - 跌停推送：
limit_down - 跌停炸板：
limit_down_broken - 跌停股数据推送（聚合）：
stock_limit_down（包含limit_down+limit_down_broken）
- 涨停推送：
-
连接示例：
{{WS_BASE_URL}}/ws/stream?token=<STOCK_API_KEY>&types=stock_limit_up,stock_limit_down
-
动态订阅示例：
{"action":"subscribe","types":["stock_limit_up","stock_limit_down"]}
- 推送消息示例：
{
"type": "stock_limit_event",
"data": {
"type": "limit_up",
"stock_code": "600000.SH",
"stock_name": "浦发银行",
"change_rate": 10.0,
"source": "fast",
"timestamp": "2026-04-17 11:23:45"
}
}
- 字段说明：
- 外层
type固定为stock_limit_event data.type可能值：limit_up/limit_up_broken/limit_down/limit_down_broken- 常见字段：
stock_code,stock_name,change_rate,source,timestamp
- 外层
调用策略与最佳实践
- API Key 获取与使用
- 优先从环境变量
STOCK_API_KEY读取（由 OpenClaw 按skills.entries.openclaw-stock-skill.apiKey注入）。 - 若环境变量缺失，可根据用户在 Skill 配置面板中输入的值（通常同样会映射到该环境变量）进行调用。
- 不要在 URL Query 中传递
apiKey或api_key，后端会视为安全风险。
- 优先从环境变量
- 错误处理
code = 401：API Key 无效或缺失，应提示用户检查在 OpenClaw Skill 配置中的 API Key。code = 403：权限不足或下载次数/访问次数限制，应向用户说明权限/限流约束。code = 429：请求过于频繁，需减少调用频率或提示用户稍后再试。
- 分页与大数据量
- 若
data.total很大，代理应分批分页请求，并在回答中做汇总，而不是一次性获取全部数据。 - 对于分钟级或 tick 级大数据量，应在对话中与用户确认时间范围和精度，避免无谓的海量下载。
- 若
- 单位与精度
- 价格、成交量等字段在后端已经统一保留 2 位小数；如需展示给用户，可直接使用或再格式化。
- 分红相关字段在估值接口中已做 10 年平均等处理，解释时注意说明口径（年化、近 10 年等）。
使用示例（给代理的思路）
- 当用户说：“帮我查一下 000001.SZ 在 2024 年 1 月份的日 K 线”
- 调用
POST /api/stock/daily，stock_code = "000001.SZ"，时间区间为2024-01-01至2024-01-31。 - 对返回的
data.list进行整理，总结涨跌幅、最大回撤、平均成交额等。
- 调用
- 当用户说：“这周哪些天是交易日？”
- 根据当前日期计算一周范围，调用
GET/POST /api/basic/calendar。 - 将
is_open = 1的日期列出，说明哪些是交易日。
- 根据当前日期计算一周范围，调用
本技能不包含额外可执行脚本，完全通过指导代理调用现有 HTTP 接口工作。所有请求都应优先使用 STOCK_API_KEY 环境变量，并遵守上述限流与安全约定。
Related Skills
openclaw/taskflow-inbox-triage
data-ai
VerifiedTrustedCommunity
Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some waiting on outside answers, and others rolling into a later summary.
357,764SKILL.mdUpdated Apr 10, 2026
steipete/taskflow-inbox-triage
data-ai
VerifiedTrustedCommunity
Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some waiting on outside answers, and others rolling into a later summary.
356,423SKILL.mdUpdated Apr 13, 2026
steipete/prose
data-ai
VerifiedTrustedCommunity
OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.
356,423SKILL.mdUpdated Apr 13, 2026
openclaw/prose
data-ai
VerifiedTrustedCommunity
OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.
353,662SKILL.mdUpdated Apr 10, 2026