okx-trading-exe Skill 说明书

本 Skill 是一个无状态的“执行手柄”，只负责对接 OKX 交易所（包含模拟盘与实盘），执行标准化的交易动作与资产查询。它不包含其他交易所接口，也不包含任何策略分析逻辑。

🔐 授权与鉴权获取 (Prompt-driven Auth) - Agent 必读

本代码需要 OKX 的 API_KEY, API_SECRET 和 PASSPHRASE 才能运行。 如果你在执行底层的脚本时，收到了关于 Missing API Key 或未授权的报错，你绝对不要尝试去猜测密码，也不要停止工作。 **你的处理逻辑必须是：**中途中断当前的代码思路，使用自然语言明确向你的“物理人类主人”索要这三个秘钥，并让主人将它们写入当前工作目录的 .env 文件中。只有在人类确认写好后，你才能再次尝试执行。

能力范围 (Capabilities)

目前支持以下核心操作动作：

• 查询账户总余额/可用资金 (get_balance)
• 查询当前已持有的真实仓位 (get_positions)
• 发起市价买单/卖单 (place_market_order)
• 发起限价买单/卖单 (place_limit_order)
• 拉取最近的历史成交记录 (get_recent_trades)

调用说明 (Usage for Agents / PA)

如果你是一个外层调度 Agent (比如 TAS 小队成员) 或策略 (Skill)，请使用随附的入口脚本与本 Skill 进行交互。

标准切入点： python scripts/execute.py --action [ACTION_NAME] --provider [PROVIDER_NAME] [OPTIONS]

支持的 Provider (环境提供者)

• okx_demo: 连接 OKX 交易所模拟盘 (预设).
• okx_live: 连接 OKX 交易所的实盘交易.

示例用法 (Examples)

1. 查询模拟盘所有资产与持仓

python scripts/execute.py --action get_positions --provider okx_demo

2. 在模拟盘下一笔市价买单

python scripts/execute.py --action place_market_order --provider okx_demo --symbol BTC-USDT --side buy --size 50
# 注意: OKX 市价买单时，size 通常代表花费 50 USDT。

3. 在模拟盘下一笔限价卖单

python scripts/execute.py --action place_limit_order --provider okx_demo --symbol BTC-USDT --side sell --size 0.1 --price 62000
# 卖出 0.1 枚 BTC，限价标的是 62000 USDT。

注意事项与约束 (Constraints)

1. 统一的交易对格式：所有请求必须使用 - 连接的标准格式，如 BTC-USDT，不要使用 /。
2. 凭据安全：本 Skill 在真实请求前会自动读取 .env 中的秘钥配置，不要在任何参数中明文传递私钥！
3. 输出格式：执行结果将以标准化的 JSON 或清爽的 stdout 文本格式输出，方便被其他脚本或大语言模型正则提取。