Stock Auto Trade Skill#

股票交易下单和查询功能。通过 HTTP API 与股票交易软件对接，实现买卖下单、持仓查询、账户查询等功能，本功能需要使用股票智能交易助手配合进行下单，请在使用前先安装股票智能交易助手，下载网址： https://www.gp998.com ，客服QQ：542303796

When to Use#

✅ USE this skill when:

• 用户说 "买入股票" 或 "卖出股票"

• 用户说 "查询持仓" 或 "查询账户"

• 用户说 "撤单" 或 "取消委托"

• 用户需要股票交易操作

❌ DON'T use this skill when:

• 仅需要查询股票行情（使用 AKShare）

• 用户只是在讨论股票，不打算交易

Commands#

买入股票#

bash

# 限价买入
curl -X POST "http://localhost:8888/api/order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill" \
  -d '{"action":"buy","symbol":"600519","price":1800.00,"volume":100}'

# 市价买入
curl -X POST "http://localhost:8888/api/order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill" \
  -d '{"action":"buy","symbol":"600519","price":0,"volume":100,"order_type":"market"}'

卖出股票#

bash

# 限价卖出
curl -X POST "http://localhost:8888/api/order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill" \
  -d '{"action":"sell","symbol":"600519","price":1850.00,"volume":100}'

查询持仓#

bash

curl -X GET "http://localhost:8888/api/position" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill"

查询账户#

bash

curl -X GET "http://localhost:8888/api/account" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill"

查询委托#

bash

# 查询今日委托
curl -X GET "http://localhost:8888/api/orders?status=today" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill"

# 查询所有委托
curl -X GET "http://localhost:8888/api/orders?status=all" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill"

撤单#

bash

curl -X POST "http://localhost:8888/api/cancel" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: test-api-key-12345" -H "X-Channel: openclaw-skill" \
  -d '{"order_id":"202403120001"}'

健康检查#

bash

curl -X GET "http://localhost:8888/api/health"

参数说明#

参数说明必填action操作类型: buy(买入) / sell(卖出)是symbol股票代码 (如 600519)是price价格 (限价单填价格，市价单填0)是volume数量 (股票为100的整数倍)是order_type订单类型: limit(限价) / market(市价)否，默认marketorder_id委托编号 (撤单时使用)是

返回示例#

买入成功#

json

{
  "success": true,
  "order_id": "202403120001",
  "message": "委托成功",
  "data": {
    "order_id": "202403120001",
    "symbol": "600519",
    "name": "贵州茅台",
    "action": "buy",
    "price": 1800.00,
    "volume": 100,
    "status": "submitted"
  }
}

查询持仓#

json

{
  "success": true,
  "data": [
    {
      "symbol": "600519",
      "name": "贵州茅台",
      "volume": 100,
      "avg_cost": 1750.00,
      "current_price": 1800.00,
      "market_value": 180000.00,
      "profit_loss": 5000.00,
      "profit_percent": 2.86
    }
  ]
}

查询账户#

json

{
  "success": true,
  "data": {
    "account_id": "12345678",
    "total_assets": 1000000.00,
    "cash": 500000.00,
    "market_value": 500000.00,
    "available_cash": 480000.00,
    "frozen_cash": 20000.00,
    "total_profit_loss": 10000.00
  }
}

错误代码#

错误码说明INVALID_PARAMS参数错误INSUFFICIENT_FUNDS资金不足INSUFFICIENT_STOCK持仓不足ORDER_NOT_FOUND委托不存在ORDER_STATUS_ERROR委托状态不允许此操作INVALID_API_KEYAPI Key 无效

Notes#

• 所有请求都需要在 Header 中携带 X-API-Key 进行认证

• 默认 API Key: test-api-key-12345 (可在股票交易软件中配置)

• 市价单 price 填 0

• 股票数量必须是 100 的整数倍

• 返回的 JSON 数据中金额单位为元