OKX Trader Skill

A professional-grade automated trading agent skill for OKX. This skill enables the AI agent to manage grid trading strategies, monitor account performance, and handle market execution with built-in safety protocols.

System Capabilities

1. Dual-Grid Execution

The agent operates two concurrent strategies:

• Macro Grid (Main): Heavy positions for capturing major trend movements.
• Micro Grid: High-frequency scalp positions for extracting profit from minor volatility.

Supports multiple instruments (e.g., BTC-USDT, ETH-USDT) via named configurations in grid_settings.json.

2. Auto-Trailing (Rescale) Logic

The skill automatically detects when the market price drifts outside the active grid range. It performs a "Rescale" operation:

• Cancels all legacy orders associated with the bot.
• Recalculates and re-centers the grid layout based on the current market ticker.
• Persists new range settings to grid_settings.json.

3. Risk Management & Protection

• Cost Basis Guard: Prevents the agent from placing sell orders below the average entry price (including a minimum profit buffer).
• Inventory Control: Respects maxPosition limits to prevent over-leveraging during extended downtrends.
• Order Throttling: Built-in delays and batch execution to prevent rate-limiting and improve efficiency.

Available Tools

okx_report

Generates a highly condensed PnL and status report. Automatically detects all configured instruments from grid_settings.json and reports per-grid statistics.

okx_grid_maintain

The core execution tool that maintains the grid structure. Supports any number of grid configurations (e.g., main, micro, eth_micro).

okx_snapshot

Records a daily account snapshot including balances, prices, 24h trading summary, and day-over-day equity comparison. Data is saved to okx_data/snapshots/YYYY-MM-DD.json.

Internal Dependencies

Requires the following local files in /root/.openclaw/workspace/okx_data/:

• config.json: API credentials.
• grid_settings.json: Strategy parameters.

⚠️ RISK WARNING

Trading cryptocurrencies involves significant risk. This skill is provided "as is" without warranties.

• Simulation First: Always test with OKX_IS_SIMULATION=true before using real funds.
• Permissions: Use API keys with "Trade" permissions only. Disable "Withdrawal" permissions.

---

OKX Trader Skill (中文说明)

一个专为 OKX 交易所设计的专业级自动化交易技能。该技能使 AI 代理能够管理网格交易策略、监控账户表现，并具备内置安全协议的行情执行能力。

系统功能

1. 双层网格执行

代理同时运行两种策略：

• 大网格 (Main): 使用较大仓位，旨在捕捉主要的市场趋势运动。
• 小网格 (Micro): 高频剥头皮仓位，旨在从微小的波动中提取利润。

支持多交易对（如 BTC-USDT、ETH-USDT），通过 grid_settings.json 中的命名配置管理。

2. 自动跟随 (Rescale) 逻辑

技能会自动检测市场价格何时偏离活跃网格区间。它执行“Rescale”操作：

• 取消与该机器人相关的所有旧订单。
• 根据当前市场价格重新计算并居中网格布局。
• 将新的区间设置持久化到 grid_settings.json。

3. 风险管理与保护

• 成本基准保护: 防止代理以低于平均入场价的价格下达卖单（包括最小利润缓冲）。
• 库存控制: 遵守 maxPosition 限制，防止在持续下跌趋势中过度加仓。
• 订单节流: 内置延迟和批量执行，防止 API 频率限制并提高效率。

可用工具

okx_report

生成高度压缩的损益（PnL）和状态报告。自动从 grid_settings.json 检测所有已配置的交易对，按网格分别统计。

okx_grid_maintain

维护网格结构的核心执行工具。支持任意数量的网格配置（如 main、micro、eth_micro）。

okx_snapshot

记录每日账户快照，包括余额、价格、24h 交易汇总及逐日权益对比。数据保存至 okx_data/snapshots/YYYY-MM-DD.json。

内部依赖

需要在 /root/.openclaw/workspace/okx_data/ 中存在以下本地文件：

• config.json: API 凭据。
• grid_settings.json: 策略参数。

⚠️ 风险提示

加密货币交易涉及巨大风险。本技能按“原样”提供，不作任何保证。

• 模拟优先: 在使用真实资金之前，务必先开启模拟盘测试 (OKX_IS_SIMULATION=true)。
• 权限控制: 仅使用具备“交易”权限的 API 密钥。务必禁用“提现”权限。