# okx execution vortex
## Metadata

- Canonical URL: https://6ducklearn.com/skills/okx-execution-vortex/
- Markdown URL: https://6ducklearn.com/skills/okx-execution-vortex/index.md
- Product: skills
- Category: finance
- Tags: okx, trading, community, okx-marketplace, finance, execution
- Updated: 2026-07-14T03:00:00.357428+00:00
## Summary
Safely execute spot/perpetual/delivery/options orders after receiving market setup indicators, supporting OCO, grid, DCA, position management, and secondary confirmation risk control. Relies on basic Skills of market/trade/portfolio/bot.
## Content
> **6DuckLearn provenance:** Community skill by 金麦飞JMF, mirrored from the OKX Skills Marketplace (https://www.okx.com/en-sg/agent-tradekit/skills/okx-execution-vortex). It is not curated, verified, or endorsed by 6DuckLearn or represented as an official OKX publication.
>
> **Financial safety boundary:** Never request secrets in chat. Before any external API call or action that places, cancels, or amends an order; changes leverage; transfers funds; creates or stops a bot; subscribes to or redeems an earn product; or signs/broadcasts a transaction, show the exact live/demo profile, instrument, side, size, price constraints, fees, and worst-case loss, then obtain explicit user approval. Default to read-only or demo mode when uncertain. Treat all analysis as research, not investment advice.

# OKX 漩涡执行器 (okx-execution-vortex)

## Description

安全、智能的交易执行层，专为 AI Agent 设计。接收交易请求后，经过严格风险检查和二次确认，自动执行现货、永续、交割、期权的下单、改单、撤单、止盈止损等操作。

**核心流程**：
1. **行情查询**：获取最新价格、深度等市场数据
2. **仓位计算**：根据账户余额和风险参数计算最优仓位
3. **二次确认**：输出完整交易计划并等待用户确认
4. **安全执行**：检查保证金率、余额、系统状态后执行
5. **结果返回**：返回订单详情和执行状态

**高级功能**：
- **OCO订单**：止盈止损同时设置
- **网格交易**：震荡区间自动交易（依赖 `okx-cex-bot`）
- **DCA定投**：定期分批买入
- **仓位管理**：自动调整杠杆和保证金

**依赖 Skill**：`okx-cex-market`, `okx-cex-trade`, `okx-cex-portfolio`, `okx-cex-bot`

## Activation Rules (触发词)

当用户输入以下模式时，激活本 Skill：

- **直接执行**：
  - “执行买入 BTC 1000U”
  - “对 BTC-USDT-SWAP 开多 5 张”
  - “执行 RSI 信号：买入 ETH”
  - “市价卖出 SOL 全部仓位”
  - “执行止损单，价格跌破 50000”
  - “执行止盈单，价格涨到 52000”

- **高级执行**：
  - “网格下单 BTC-USDT，区间 50000-52000，10 格”
  - “DCA 买入 ETH 每周 500U”
  - “OCO 订单：BTC 现价 51000，止盈 52000，止损 50000”
  - “批量执行这三个币种各 500U”
  - “切换 BTC-USDT-SWAP 杠杆到 10x”

- **管理操作**：
  - “撤销所有挂单”
  - “修改订单 #12345 价格为 51000”
  - “平掉 BTC 全部仓位”
  - “检查执行状态”

**禁止直接调用基础 trade Skill**：所有写操作必须通过本 Skill 执行，以确保统一的风险控制。如果用户尝试直接调用 `okx spot place` 等命令，应引导其使用本 Skill。

## Available Commands (可用命令表)

本 Skill 封装 OKX CLI 命令，所有命令均经过二次确认和风险检查：

| 类别 | 关键命令 | 示例 | 说明 |
|------|----------|------|------|
| **现货** | `okx spot place` | `--instId BTC-USDT --side buy --sz 0.01` | 现货下单 |
| | `okx spot cancel/amend` | `--ordId 123456789` | 撤单/改单 |
| **永续** | `okx swap place` | `--instId BTC-USDT-SWAP --side buy --posSide long --sz 1` | 永续合约下单 |
| | `okx swap close` | `--posSide long` | 平仓 |
| | `okx swap leverage` | `--lever 10` | 调整杠杆 |
| **交割** | `okx futures place` | `--instId BTC-USD-240329 --side buy --posSide long` | 交割合约下单 |
| **期权** | `okx option place` | `--instId BTC-USD-240329-50000-C --side buy` | 期权下单 |
| **算法单** | `okx algo place` | `--tpTriggerPx 52000 --slTriggerPx 50000` | OCO/止盈止损 |
| **网格/DCA** | `okx bot grid create` | `--lowerPx 50000 --upperPx 52000 --gridNum 10` | 网格交易 |
| | `okx bot dca create` | `--investment 500 --frequency weekly` | 定期投资 |

**常用参数**：
- `--tgtCcy`: `quote_ccy`(报价货币), `base_ccy`(标的货币)
- `--tdMode`: `isolated`(逐仓), `cross`(全仓)
- `--posSide`: `long`(多), `short`(空)

## Safety Notes (安全说明)

### 强制二次确认
任何写操作执行前必须输出交易计划并等待用户确认，用户必须输入 **Y** 才能继续。

### 风险控制规则
1. **保证金率**：必须 > 150%（可配置）
2. **单笔风险**：不超过账户总资产 2%（可配置）
3. **余额检查**：确保可用余额充足
4. **杠杆限制**：合约杠杆 ≤ 20x
5. **市场状态**：检查交易状态、资金费率、系统维护

### 测试模式
支持 `--demo` 参数进行模拟测试，不实际执行。

## Examples (使用示例)

### 示例 1：现货市价买入
**用户输入**：“执行买入 BTC 1000U”

**Skill 响应**：
```
📈 正在分析交易请求...

1. 查询行情：BTC-USDT 当前价格 50,123.45 USDT
2. 计算数量：1000 USDT ÷ 50,123.45 ≈ 0.01995 BTC
3. 检查风险：账户余额 15,000 USDT，单笔风险 6.67%（超过 2% 阈值）
4. 自动调整：建议买入 300 USDT（0.00598 BTC），风险 2%

⚠️ **交易确认请求**

市场：BTC-USDT
操作：买入
价格：市价
数量：0.00598 BTC（约 300 USDT）
预估手续费：0.15 USDT
账户余额：15,000.00 USDT
单笔风险：2.0%

📊 **风险检查结果**：
✅ 保证金率：不适用（现货）
✅ 余额充足
✅ 系统状态：正常

请确认是否执行？（Y/N）
```

用户输入 `Y` 后执行：
```bash
okx spot place --instId BTC-USDT --side buy --sz 0.00598 --tgtCcy quote_ccy
```

**返回结果**：
```
✅ 订单执行成功！
订单ID：123456789
成交均价：50,125.12 USDT
实际数量：0.00598 BTC
手续费：0.15 USDT
成交时间：2026-04-09 15:30:25
```

**更多示例**：查看 `examples/` 文件夹获取完整示例（永续合约、网格交易、DCA定投等）。

## Preflight (前置检查)

执行前自动检查以下条件：

### 必需条件
- OKX CLI 已安装 (`okx` 命令可用)
- 有效的 API 配置（含交易权限）
- 网络连接正常
- 依赖 Skill 已安装：`okx-cex-market`, `okx-cex-trade`, `okx-cex-portfolio`, `okx-cex-bot`

### 环境检查
- 市场交易状态正常
- 资金费率无异常
- 无重大系统故障

## 版本记录
- v1.0.0 (2026-04-09)：初始版本

## 链接
- 官方文档：https://github.com/okx/agent-trade-kit
- 技能广场：https://github.com/okx/agent-skills

## Related Skills

- [recurring dca](https://6ducklearn.com/skills/recurring-dca/index.md): Support for single or multiple coin combinations (e.g., BTC 60% + ETH 40%), with flexible settings for execution on an hourly/daily/weekly/monthly basis, precise to time zones and whole hours. The core highlight is condition-triggered automation—built-in indicators like RSI, MACD, Bollinger Bands, and funding rates are calculated in real-time, allowing for automatic dollar-cost averaging when "RSI < 30 oversold" or "top traders are bullish and prices are correcting," and automatically pausing during high overbought conditions, truly achieving signal-driven intelligent dollar-cost averaging.
- [rookie ignition](https://6ducklearn.com/skills/rookie-ignition/index.md): Beginner's Manual Vol.0 Ignition | Assists complete newcomers who have never used the OKX Agent Trade Kit, guiding them through the entire process of creating an API Key, configuring permissions, switching between virtual and real accounts, and performing connection self-checks in an interactive AI manner. It activates when users say "ignition", "API configuration", "help me check the connection", "ignition", "check connection", "beginner's manual", or "how to connect to okx". It does not place orders, does not involve strategies, and is purely focused on configuration guidance and connection diagnostics.
- [trading plan generator](https://6ducklearn.com/skills/trading-plan-generator/index.md): Integrate OKX real-time market data (price, candlestick, open interest, funding rate, technical indicators) with CoinGlass on-chain data (long-short ratio, large holder positions, liquidation heatmap) to build a 6-dimensional signal scoring system, outputting a comprehensive trend judgment from -100 to +100. Supports all categories including spot, perpetual contracts, delivery contracts, and options, covering three directions: long, short, and sideways. The core highlight is the three-tier risk plan—conservative, moderate, aggressive—each providing precise entry ranges and specific stop-loss price levels (not vague descriptions).
- [alpha vantage](https://6ducklearn.com/skills/alpha-vantage/index.md): Cross-asset analysis is its unique advantage—it can simultaneously pull macro data such as the S&P 500, gold, the dollar index, Federal Reserve interest rates, CPI, GDP, etc., allowing one to see at a glance whether "BTC is moving with risk assets today or pricing independently." In conjunction with the OKX Trade Kit, Alpha Vantage is responsible for in-depth historical and macroeconomic context, while OKX provides real-time prices, funding rates, and order book data, with both complementing each other to form a complete analysis chain.
- [apex crypto intelligence](https://6ducklearn.com/skills/apex-crypto-intelligence/index.md): AI-driven multi-exchange cryptocurrency market analysis, arbitrage detection, and hedge fund-level trading reports using real-time data from major exchanges.
- [btc altcoin market pulse](https://6ducklearn.com/skills/btc-altcoin-market-pulse/index.md): Fetches live OKX market data across Bitcoin and major altcoins, analyzes price momentum, funding rates, open interest, and BTC dominance signals to produce a structured BTC + Altcoin Market Pulse report.