核心用法
okx-trading-exe 是一个专注于 OKX 交易所 的标准化执行网关 Skill，采用无状态设计，仅负责交易动作的投递与资产数据的拉取，不包含策略分析或跨交易所能力。
功能矩阵
| 动作 | 说明 |
|------|------|
| `get_balance` | 查询账户总余额与可用资金 |
| `get_positions` | 获取当前真实持仓明细 |
| `place_market_order` | 发起市价单（买单按 USDT 金额，卖单按币数量）|
| `place_limit_order` | 发起限价单，需指定目标价格 |
| `get_recent_trades` | 拉取近期成交历史 |
调用范式
通过统一入口脚本执行：
python scripts/execute.py --action [ACTION] --provider [ENV] [OPTIONS]
支持 okx_demo（模拟盘）和 okx_live（实盘）两种环境切换。
显著优点
1. 环境隔离清晰：模拟盘与实盘通过 --provider 参数显式区分，降低误操作风险
2. 标准化输出：返回 JSON 或结构化文本，便于上层 Agent 解析与链式调用
3. Prompt-driven 鉴权流程：当检测到密钥缺失时，明确中断并引导用户配置 .env 文件，避免暴力猜测
4. 格式强制约束：交易对统一使用 BTC-USDT 格式，减少因符号歧义导致的失败
潜在局限
- 交易所锁定：仅支持 OKX，无法无缝迁移至 Binance、Coinbase 等平台
- 零策略内嵌：纯执行层，需外层 Skill（如量化策略 Agent）驱动，无法独立决策
- API 密钥依赖：完全依赖用户自行申请并安全保管 OKX API 密钥，无托管或 OAuth 替代方案
- 无实时流数据：仅支持主动查询与下单，不含 WebSocket 行情推送能力
适合人群
- 已持有 OKX 账户并熟悉 API 申请的进阶交易者
- 需要为自动化策略（TAS/量化 Agent）嫁接执行通道的开发者
- 希望在零资金风险环境下测试交易逻辑的用户（模拟盘模式）
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | `.env` 文件若被误提交至 Git 或暴露在日志中，可能导致资产被盗 |
| 环境误切 | 脚本参数错误将模拟盘指令发送至实盘，可能造成真实资金损失 |
| 交易所风险 | OKX 平台自身的宕机、插针、API 延迟等问题会直接影响执行可靠性 |
| 网络钓鱼 | 用户需在官方渠道申请 API，警惕伪造的密钥索取页面 |
建议启用 OKX API 的 IP 白名单与提现白名单功能，进一步限制密钥权限范围。