{
  "schemaVersion": "1.0",
  "item": {
    "slug": "okx-trader",
    "name": "OKX Trader",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/esojourn/okx-trader",
    "canonicalUrl": "https://clawhub.ai/esojourn/okx-trader",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/okx-trader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=okx-trader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "lib/okx-client.js",
      "scripts/grid-bot.js",
      "scripts/report.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/okx-trader"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/okx-trader",
    "agentPageUrl": "https://openagent3.xyz/skills/okx-trader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/okx-trader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/okx-trader/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OKX Trader Skill",
        "body": "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."
      },
      {
        "title": "1. Dual-Grid Execution",
        "body": "The agent operates two concurrent strategies:\n\nMacro Grid (Main): Heavy positions for capturing major trend movements.\nMicro Grid: High-frequency scalp positions for extracting profit from minor volatility.\n\nSupports multiple instruments (e.g., BTC-USDT, ETH-USDT) via named configurations in grid_settings.json."
      },
      {
        "title": "2. Auto-Trailing (Rescale) Logic",
        "body": "The skill automatically detects when the market price drifts outside the active grid range. It performs a \"Rescale\" operation:\n\nCancels all legacy orders associated with the bot.\nRecalculates and re-centers the grid layout based on the current market ticker.\nPersists new range settings to grid_settings.json."
      },
      {
        "title": "3. Risk Management & Protection",
        "body": "Cost Basis Guard: Prevents the agent from placing sell orders below the average entry price (including a minimum profit buffer).\nInventory Control: Respects maxPosition limits to prevent over-leveraging during extended downtrends.\nOrder Throttling: Built-in delays and batch execution to prevent rate-limiting and improve efficiency."
      },
      {
        "title": "okx_report",
        "body": "Generates a highly condensed PnL and status report. Automatically detects all configured instruments from grid_settings.json and reports per-grid statistics."
      },
      {
        "title": "okx_grid_maintain",
        "body": "The core execution tool that maintains the grid structure. Supports any number of grid configurations (e.g., main, micro, eth_micro)."
      },
      {
        "title": "okx_snapshot",
        "body": "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."
      },
      {
        "title": "Internal Dependencies",
        "body": "Requires the following local files in /root/.openclaw/workspace/okx_data/:\n\nconfig.json: API credentials.\ngrid_settings.json: Strategy parameters."
      },
      {
        "title": "⚠️ RISK WARNING",
        "body": "Trading cryptocurrencies involves significant risk. This skill is provided \"as is\" without warranties.\n\nSimulation First: Always test with OKX_IS_SIMULATION=true before using real funds.\nPermissions: Use API keys with \"Trade\" permissions only. Disable \"Withdrawal\" permissions."
      },
      {
        "title": "OKX Trader Skill (中文说明)",
        "body": "一个专为 OKX 交易所设计的专业级自动化交易技能。该技能使 AI 代理能够管理网格交易策略、监控账户表现，并具备内置安全协议的行情执行能力。"
      },
      {
        "title": "1. 双层网格执行",
        "body": "代理同时运行两种策略：\n\n大网格 (Main): 使用较大仓位，旨在捕捉主要的市场趋势运动。\n小网格 (Micro): 高频剥头皮仓位，旨在从微小的波动中提取利润。\n\n支持多交易对（如 BTC-USDT、ETH-USDT），通过 grid_settings.json 中的命名配置管理。"
      },
      {
        "title": "2. 自动跟随 (Rescale) 逻辑",
        "body": "技能会自动检测市场价格何时偏离活跃网格区间。它执行“Rescale”操作：\n\n取消与该机器人相关的所有旧订单。\n根据当前市场价格重新计算并居中网格布局。\n将新的区间设置持久化到 grid_settings.json。"
      },
      {
        "title": "3. 风险管理与保护",
        "body": "成本基准保护: 防止代理以低于平均入场价的价格下达卖单（包括最小利润缓冲）。\n库存控制: 遵守 maxPosition 限制，防止在持续下跌趋势中过度加仓。\n订单节流: 内置延迟和批量执行，防止 API 频率限制并提高效率。"
      },
      {
        "title": "okx_report",
        "body": "生成高度压缩的损益（PnL）和状态报告。自动从 grid_settings.json 检测所有已配置的交易对，按网格分别统计。"
      },
      {
        "title": "okx_grid_maintain",
        "body": "维护网格结构的核心执行工具。支持任意数量的网格配置（如 main、micro、eth_micro）。"
      },
      {
        "title": "okx_snapshot",
        "body": "记录每日账户快照，包括余额、价格、24h 交易汇总及逐日权益对比。数据保存至 okx_data/snapshots/YYYY-MM-DD.json。"
      },
      {
        "title": "内部依赖",
        "body": "需要在 /root/.openclaw/workspace/okx_data/ 中存在以下本地文件：\n\nconfig.json: API 凭据。\ngrid_settings.json: 策略参数。"
      },
      {
        "title": "⚠️ 风险提示",
        "body": "加密货币交易涉及巨大风险。本技能按“原样”提供，不作任何保证。\n\n模拟优先: 在使用真实资金之前，务必先开启模拟盘测试 (OKX_IS_SIMULATION=true)。\n权限控制: 仅使用具备“交易”权限的 API 密钥。务必禁用“提现”权限。"
      }
    ],
    "body": "OKX Trader Skill\n\nA 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.\n\nSystem Capabilities\n1. Dual-Grid Execution\n\nThe agent operates two concurrent strategies:\n\nMacro Grid (Main): Heavy positions for capturing major trend movements.\nMicro Grid: High-frequency scalp positions for extracting profit from minor volatility.\n\nSupports multiple instruments (e.g., BTC-USDT, ETH-USDT) via named configurations in grid_settings.json.\n\n2. Auto-Trailing (Rescale) Logic\n\nThe skill automatically detects when the market price drifts outside the active grid range. It performs a \"Rescale\" operation:\n\nCancels all legacy orders associated with the bot.\nRecalculates and re-centers the grid layout based on the current market ticker.\nPersists new range settings to grid_settings.json.\n3. Risk Management & Protection\nCost Basis Guard: Prevents the agent from placing sell orders below the average entry price (including a minimum profit buffer).\nInventory Control: Respects maxPosition limits to prevent over-leveraging during extended downtrends.\nOrder Throttling: Built-in delays and batch execution to prevent rate-limiting and improve efficiency.\nAvailable Tools\nokx_report\n\nGenerates a highly condensed PnL and status report. Automatically detects all configured instruments from grid_settings.json and reports per-grid statistics.\n\nokx_grid_maintain\n\nThe core execution tool that maintains the grid structure. Supports any number of grid configurations (e.g., main, micro, eth_micro).\n\nokx_snapshot\n\nRecords 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.\n\nInternal Dependencies\n\nRequires the following local files in /root/.openclaw/workspace/okx_data/:\n\nconfig.json: API credentials.\ngrid_settings.json: Strategy parameters.\n⚠️ RISK WARNING\n\nTrading cryptocurrencies involves significant risk. This skill is provided \"as is\" without warranties.\n\nSimulation First: Always test with OKX_IS_SIMULATION=true before using real funds.\nPermissions: Use API keys with \"Trade\" permissions only. Disable \"Withdrawal\" permissions.\nOKX Trader Skill (中文说明)\n\n一个专为 OKX 交易所设计的专业级自动化交易技能。该技能使 AI 代理能够管理网格交易策略、监控账户表现，并具备内置安全协议的行情执行能力。\n\n系统功能\n1. 双层网格执行\n\n代理同时运行两种策略：\n\n大网格 (Main): 使用较大仓位，旨在捕捉主要的市场趋势运动。\n小网格 (Micro): 高频剥头皮仓位，旨在从微小的波动中提取利润。\n\n支持多交易对（如 BTC-USDT、ETH-USDT），通过 grid_settings.json 中的命名配置管理。\n\n2. 自动跟随 (Rescale) 逻辑\n\n技能会自动检测市场价格何时偏离活跃网格区间。它执行“Rescale”操作：\n\n取消与该机器人相关的所有旧订单。\n根据当前市场价格重新计算并居中网格布局。\n将新的区间设置持久化到 grid_settings.json。\n3. 风险管理与保护\n成本基准保护: 防止代理以低于平均入场价的价格下达卖单（包括最小利润缓冲）。\n库存控制: 遵守 maxPosition 限制，防止在持续下跌趋势中过度加仓。\n订单节流: 内置延迟和批量执行，防止 API 频率限制并提高效率。\n可用工具\nokx_report\n\n生成高度压缩的损益（PnL）和状态报告。自动从 grid_settings.json 检测所有已配置的交易对，按网格分别统计。\n\nokx_grid_maintain\n\n维护网格结构的核心执行工具。支持任意数量的网格配置（如 main、micro、eth_micro）。\n\nokx_snapshot\n\n记录每日账户快照，包括余额、价格、24h 交易汇总及逐日权益对比。数据保存至 okx_data/snapshots/YYYY-MM-DD.json。\n\n内部依赖\n\n需要在 /root/.openclaw/workspace/okx_data/ 中存在以下本地文件：\n\nconfig.json: API 凭据。\ngrid_settings.json: 策略参数。\n⚠️ 风险提示\n\n加密货币交易涉及巨大风险。本技能按“原样”提供，不作任何保证。\n\n模拟优先: 在使用真实资金之前，务必先开启模拟盘测试 (OKX_IS_SIMULATION=true)。\n权限控制: 仅使用具备“交易”权限的 API 密钥。务必禁用“提现”权限。"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/esojourn/okx-trader",
    "publisherUrl": "https://clawhub.ai/esojourn/okx-trader",
    "owner": "esojourn",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/okx-trader",
    "downloadUrl": "https://openagent3.xyz/downloads/okx-trader",
    "agentUrl": "https://openagent3.xyz/skills/okx-trader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/okx-trader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/okx-trader/agent.md"
  }
}