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