StockEarning

name: stockearning-助手 description: StockEarning OpenClaw 插件入口：安装后可查询行情、管理持仓、记录交易，并支持“一键刷新持仓现价”。 metadata: {"OpenClaw": {"requires": {"env": ["STOCK_API_KEY"]}}} user-invocable: true StockEarning 插件入口 (StockEarning 助手)

这是 StockEarning 的 OpenClaw 技能插件入口说明。安装本目录后，你将获得一组可组合使用的技能，用于：

查询A股行情、股票信息、股票搜索 查询与管理持仓、计算盈亏、刷新持仓现价 记录买入/卖出交易 开始之前：

您需要去https://www.mystockearning.cn注册一个账号，并等待审核通过后获取API key。

认证与基础配置 环境变量: STOCK_API_KEY Base URL: 从 config.sh 中读取 $STOCK_BASE_URL（默认 https://www.mystockearning.cn，也可通过环境变量 STOCK_BASE_URL 覆盖）

所有请求均使用 HTTP Header：

X-API-Key: $STOCK_API_KEY

推荐使用方式

通常直接使用主入口技能：

/stock-master：主入口，覆盖最常用的查询/记账/刷新场景

若你希望更可控、更聚焦的行为，可以按需调用下列技能：

技能名称 功能 目录 stock-master 主入口：综合查询、刷新现价、记录交易 ./stock-master/ portfolio-助手 仅查询持仓/收益摘要/历史交易 ./portfolio-助手/ market-data 仅查询实时价格、股票信息、搜索代码 ./market-data/ trade-execution 仅用于记录买入/卖出交易 ./trade-execution/ 常用 API 速查 刷新持仓现价

用于在查询“总盈亏/账户表现”等问题前，先拉取最新市价：

curl -s -H "X-API-Key: $STOCK_API_KEY" "${STOCK_BASE_URL}/API/positions/更新-all-prices"

说明：

该接口兼容 获取 与 POST，推荐新客户端使用 POST，旧客户端可继续使用 获取。 获取收益摘要 curl -s -H "X-API-Key: $STOCK_API_KEY" "${STOCK_BASE_URL}/API/分析/summary"

查询持仓 curl -s -H "X-API-Key: $STOCK_API_KEY" "${STOCK_BASE_URL}/API/positions/?market={市场代码}&排序_by=profit_loss_percent&order=desc"

查询实时价格 curl -s -H "X-API-Key: $STOCK_API_KEY" "${STOCK_BASE_URL}/API/markets/stocks/{symbol}/price?market={市场代码}"

执行规则 涉及“总盈亏/账户表现/整体收益”的问题：优先执行 更新-all-prices 刷新市价，再请求 分析/summary。 金额展示必须带正确货币单位： cn_a (A股): ¥ 或 元 (CNY) hk (港股): HK$ 或 港元 (HKD) us (美股): $ 或 美元 (USD) 不在输出中泄露 STOCK_API_KEY。