{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openmm-grid-trading",
    "name": "OpenMM Grid Trading",
    "source": "tencent",
    "type": "skill",
    "category": "金融交易",
    "sourceUrl": "https://clawhub.ai/adacapo21/openmm-grid-trading",
    "canonicalUrl": "https://clawhub.ai/adacapo21/openmm-grid-trading",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openmm-grid-trading",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openmm-grid-trading",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "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. 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. 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-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/openmm-grid-trading"
    },
    "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/openmm-grid-trading",
    "agentPageUrl": "https://openagent3.xyz/skills/openmm-grid-trading/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openmm-grid-trading/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openmm-grid-trading/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OpenMM Grid Trading",
        "body": "Create automated grid trading strategies that profit from market volatility."
      },
      {
        "title": "What is Grid Trading?",
        "body": "Grid trading places multiple buy and sell orders at preset price intervals around the current center price. As price oscillates, the bot automatically:\n\nBuys low — places buy orders below the center price\nSells high — places sell orders above the center price\nProfits from volatility — each complete cycle captures the spread\n\nThe grid uses levels per side and spacing to distribute orders. With 5 levels and 2% spacing (linear), orders are placed at 2%, 4%, 6%, 8%, 10% from center on both sides (10 total orders)."
      },
      {
        "title": "When to Use",
        "body": "Good for:\n\nSideways/ranging markets\nHigh volatility pairs\nPassive income generation\n24/7 automated trading\n\nAvoid when:\n\nStrong trending markets (risk of holding losing positions)\nLow liquidity pairs\nHigh fee environments"
      },
      {
        "title": "1. Dry Run First (Always!)",
        "body": "openmm trade --strategy grid --exchange mexc --symbol INDY/USDT --dry-run"
      },
      {
        "title": "2. Start Grid with Defaults",
        "body": "openmm trade --strategy grid --exchange mexc --symbol INDY/USDT"
      },
      {
        "title": "3. Custom Configuration",
        "body": "openmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\\n  --levels 5 \\\n  --spacing 0.02 \\\n  --size 50 \\\n  --max-position 0.6 \\\n  --safety-reserve 0.3"
      },
      {
        "title": "4. Stop the Strategy",
        "body": "Press Ctrl+C to gracefully stop. The system will:\n\nCancel all open orders\nDisconnect from exchange\nDisplay final status"
      },
      {
        "title": "Required Parameters",
        "body": "--strategy grid — Specifies grid trading strategy\n--exchange <exchange> — Exchange to trade on (mexc, bitget, gateio, kraken)\n--symbol <symbol> — Trading pair (e.g., INDY/USDT, SNEK/USDT, ADA/EUR)"
      },
      {
        "title": "Grid Parameters",
        "body": "ParameterDescriptionDefault--levels <number>Grid levels each side (max: 10, total = levels x 2)5--spacing <decimal>Base price spacing between levels (0.02 = 2%)0.02--size <number>Base order size in quote currency50--confidence <decimal>Minimum price confidence to trade0.6--deviation <decimal>Price deviation to trigger grid recreation0.015--debounce <ms>Delay between grid adjustments2000--max-position <decimal>Max position size as % of balance0.8--safety-reserve <decimal>Safety reserve as % of balance0.2--dry-runSimulate without placing real orders—"
      },
      {
        "title": "Dynamic Grid Parameters",
        "body": "ParameterDescriptionDefault--spacing-model <model>linear, geometric, or customlinear--spacing-factor <number>Geometric spacing multiplier per level1.3--size-model <model>flat, pyramidal, or customflat--grid-profile <path>Load grid config from a JSON profile file—"
      },
      {
        "title": "Volatility Parameters",
        "body": "ParameterDescriptionDefault--volatilityEnable volatility-based spread adjustmentoff--volatility-low <decimal>Low volatility threshold0.02--volatility-high <decimal>High volatility threshold0.05"
      },
      {
        "title": "Spacing Models",
        "body": "Linear (default): Equal spacing between all levels.\n\nWith --spacing 0.02 and 5 levels:\nLevel 1:  2% from center\nLevel 2:  4% from center\nLevel 3:  6% from center\nLevel 4:  8% from center\nLevel 5: 10% from center\n\nGeometric: Tighter spacing near center, wider gaps at outer levels.\n\nopenmm trade --strategy grid --exchange kraken --symbol BTC/USD \\\n  --levels 5 --spacing 0.005 --spacing-model geometric --spacing-factor 1.5\n\nLevel 1: 0.50% from center\nLevel 2: 1.25% from center\nLevel 3: 2.38% from center\nLevel 4: 4.06% from center\nLevel 5: 6.59% from center\n\nCustom: Define exact spacing offsets per level using a grid profile JSON file."
      },
      {
        "title": "Size Models",
        "body": "Flat (default): All levels get equal order sizes.\n\nPyramidal: Larger orders near center price where fills are more likely, tapering at outer levels.\n\nopenmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\\n  --levels 5 --size 50 --size-model pyramidal"
      },
      {
        "title": "Grid Profiles",
        "body": "JSON files for complete grid configuration:\n\n{\n  \"name\": \"balanced-geometric\",\n  \"description\": \"Geometric spacing with pyramidal sizing\",\n  \"levels\": 10,\n  \"spacingModel\": \"geometric\",\n  \"baseSpacing\": 0.005,\n  \"spacingFactor\": 1.3,\n  \"sizeModel\": \"pyramidal\",\n  \"baseSize\": 50\n}\n\nopenmm trade --strategy grid --exchange gateio --symbol SNEK/USDT \\\n  --grid-profile ./profiles/balanced-geometric.json"
      },
      {
        "title": "Volatility-Based Spread Adjustment",
        "body": "When enabled, the grid automatically widens during volatile conditions and tightens when the market calms. Tracks price changes over a 5-minute rolling window.\n\nBelow low threshold (default 2%): Normal spacing (1.0x)\nBetween thresholds: Elevated spacing (1.5x)\nAbove high threshold (default 5%): Wide spacing (2.0x)\n\nopenmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\\n  --levels 10 \\\n  --spacing 0.005 \\\n  --spacing-model geometric \\\n  --spacing-factor 1.3 \\\n  --size-model pyramidal \\\n  --size 5 \\\n  --volatility"
      },
      {
        "title": "Conservative",
        "body": "openmm trade --strategy grid --exchange bitget --symbol SNEK/USDT \\\n  --levels 2 \\\n  --spacing 0.02 \\\n  --size 20"
      },
      {
        "title": "Active",
        "body": "openmm trade --strategy grid --exchange mexc --symbol BTC/USDT \\\n  --levels 7 \\\n  --spacing 0.005 \\\n  --size 25"
      },
      {
        "title": "Dynamic (Geometric + Pyramidal)",
        "body": "openmm trade --strategy grid --exchange kraken --symbol SNEK/EUR \\\n  --levels 10 \\\n  --spacing 0.005 \\\n  --spacing-model geometric \\\n  --spacing-factor 1.5 \\\n  --size-model pyramidal \\\n  --size 5"
      },
      {
        "title": "Risk Management",
        "body": "--max-position — Maximum % of balance used for trading (default: 80%)\n--safety-reserve — % of balance kept as reserve (default: 20%)\n--confidence — Minimum price confidence required (default: 60%)\nGrid is automatically recreated when orders are filled\nAdjusts to significant price movements (configurable via --deviation)"
      },
      {
        "title": "Exchange-Specific Notes",
        "body": "MEXC/Gate.io: Minimum order value 1 USDT per order\nBitget: Minimum 1 USDT. Requires API key, secret, and passphrase. 6 decimal price precision for SNEK/NIGHT pairs.\nKraken: Minimum 5 EUR/USD per order. Supports major fiat pairs (EUR, USD, GBP)."
      },
      {
        "title": "Tips for Agents",
        "body": "Always dry-run first — show user the plan before executing\nCheck balance — verify sufficient funds with openmm balance --exchange <ex>\nCheck current price — use openmm ticker --exchange <ex> --symbol <sym>\nRespect minimum order values — ensure --size divided by --levels meets exchange minimums\nUse Ctrl+C to stop — graceful shutdown cancels all open orders"
      }
    ],
    "body": "OpenMM Grid Trading\n\nCreate automated grid trading strategies that profit from market volatility.\n\nWhat is Grid Trading?\n\nGrid trading places multiple buy and sell orders at preset price intervals around the current center price. As price oscillates, the bot automatically:\n\nBuys low — places buy orders below the center price\nSells high — places sell orders above the center price\nProfits from volatility — each complete cycle captures the spread\n\nThe grid uses levels per side and spacing to distribute orders. With 5 levels and 2% spacing (linear), orders are placed at 2%, 4%, 6%, 8%, 10% from center on both sides (10 total orders).\n\nWhen to Use\n\nGood for:\n\nSideways/ranging markets\nHigh volatility pairs\nPassive income generation\n24/7 automated trading\n\nAvoid when:\n\nStrong trending markets (risk of holding losing positions)\nLow liquidity pairs\nHigh fee environments\nQuick Start\n1. Dry Run First (Always!)\nopenmm trade --strategy grid --exchange mexc --symbol INDY/USDT --dry-run\n\n2. Start Grid with Defaults\nopenmm trade --strategy grid --exchange mexc --symbol INDY/USDT\n\n3. Custom Configuration\nopenmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\\n  --levels 5 \\\n  --spacing 0.02 \\\n  --size 50 \\\n  --max-position 0.6 \\\n  --safety-reserve 0.3\n\n4. Stop the Strategy\n\nPress Ctrl+C to gracefully stop. The system will:\n\nCancel all open orders\nDisconnect from exchange\nDisplay final status\nCommand Options\nRequired Parameters\n--strategy grid — Specifies grid trading strategy\n--exchange <exchange> — Exchange to trade on (mexc, bitget, gateio, kraken)\n--symbol <symbol> — Trading pair (e.g., INDY/USDT, SNEK/USDT, ADA/EUR)\nGrid Parameters\nParameter\tDescription\tDefault\n--levels <number>\tGrid levels each side (max: 10, total = levels x 2)\t5\n--spacing <decimal>\tBase price spacing between levels (0.02 = 2%)\t0.02\n--size <number>\tBase order size in quote currency\t50\n--confidence <decimal>\tMinimum price confidence to trade\t0.6\n--deviation <decimal>\tPrice deviation to trigger grid recreation\t0.015\n--debounce <ms>\tDelay between grid adjustments\t2000\n--max-position <decimal>\tMax position size as % of balance\t0.8\n--safety-reserve <decimal>\tSafety reserve as % of balance\t0.2\n--dry-run\tSimulate without placing real orders\t—\nDynamic Grid Parameters\nParameter\tDescription\tDefault\n--spacing-model <model>\tlinear, geometric, or custom\tlinear\n--spacing-factor <number>\tGeometric spacing multiplier per level\t1.3\n--size-model <model>\tflat, pyramidal, or custom\tflat\n--grid-profile <path>\tLoad grid config from a JSON profile file\t—\nVolatility Parameters\nParameter\tDescription\tDefault\n--volatility\tEnable volatility-based spread adjustment\toff\n--volatility-low <decimal>\tLow volatility threshold\t0.02\n--volatility-high <decimal>\tHigh volatility threshold\t0.05\nSpacing Models\n\nLinear (default): Equal spacing between all levels.\n\nWith --spacing 0.02 and 5 levels:\nLevel 1:  2% from center\nLevel 2:  4% from center\nLevel 3:  6% from center\nLevel 4:  8% from center\nLevel 5: 10% from center\n\n\nGeometric: Tighter spacing near center, wider gaps at outer levels.\n\nopenmm trade --strategy grid --exchange kraken --symbol BTC/USD \\\n  --levels 5 --spacing 0.005 --spacing-model geometric --spacing-factor 1.5\n\nLevel 1: 0.50% from center\nLevel 2: 1.25% from center\nLevel 3: 2.38% from center\nLevel 4: 4.06% from center\nLevel 5: 6.59% from center\n\n\nCustom: Define exact spacing offsets per level using a grid profile JSON file.\n\nSize Models\n\nFlat (default): All levels get equal order sizes.\n\nPyramidal: Larger orders near center price where fills are more likely, tapering at outer levels.\n\nopenmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\\n  --levels 5 --size 50 --size-model pyramidal\n\nGrid Profiles\n\nJSON files for complete grid configuration:\n\n{\n  \"name\": \"balanced-geometric\",\n  \"description\": \"Geometric spacing with pyramidal sizing\",\n  \"levels\": 10,\n  \"spacingModel\": \"geometric\",\n  \"baseSpacing\": 0.005,\n  \"spacingFactor\": 1.3,\n  \"sizeModel\": \"pyramidal\",\n  \"baseSize\": 50\n}\n\nopenmm trade --strategy grid --exchange gateio --symbol SNEK/USDT \\\n  --grid-profile ./profiles/balanced-geometric.json\n\nVolatility-Based Spread Adjustment\n\nWhen enabled, the grid automatically widens during volatile conditions and tightens when the market calms. Tracks price changes over a 5-minute rolling window.\n\nBelow low threshold (default 2%): Normal spacing (1.0x)\nBetween thresholds: Elevated spacing (1.5x)\nAbove high threshold (default 5%): Wide spacing (2.0x)\nopenmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\\n  --levels 10 \\\n  --spacing 0.005 \\\n  --spacing-model geometric \\\n  --spacing-factor 1.3 \\\n  --size-model pyramidal \\\n  --size 5 \\\n  --volatility\n\nTrading Examples\nConservative\nopenmm trade --strategy grid --exchange bitget --symbol SNEK/USDT \\\n  --levels 2 \\\n  --spacing 0.02 \\\n  --size 20\n\nActive\nopenmm trade --strategy grid --exchange mexc --symbol BTC/USDT \\\n  --levels 7 \\\n  --spacing 0.005 \\\n  --size 25\n\nDynamic (Geometric + Pyramidal)\nopenmm trade --strategy grid --exchange kraken --symbol SNEK/EUR \\\n  --levels 10 \\\n  --spacing 0.005 \\\n  --spacing-model geometric \\\n  --spacing-factor 1.5 \\\n  --size-model pyramidal \\\n  --size 5\n\nRisk Management\n--max-position — Maximum % of balance used for trading (default: 80%)\n--safety-reserve — % of balance kept as reserve (default: 20%)\n--confidence — Minimum price confidence required (default: 60%)\nGrid is automatically recreated when orders are filled\nAdjusts to significant price movements (configurable via --deviation)\nExchange-Specific Notes\n\nMEXC/Gate.io: Minimum order value 1 USDT per order Bitget: Minimum 1 USDT. Requires API key, secret, and passphrase. 6 decimal price precision for SNEK/NIGHT pairs. Kraken: Minimum 5 EUR/USD per order. Supports major fiat pairs (EUR, USD, GBP).\n\nTips for Agents\nAlways dry-run first — show user the plan before executing\nCheck balance — verify sufficient funds with openmm balance --exchange <ex>\nCheck current price — use openmm ticker --exchange <ex> --symbol <sym>\nRespect minimum order values — ensure --size divided by --levels meets exchange minimums\nUse Ctrl+C to stop — graceful shutdown cancels all open orders"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/adacapo21/openmm-grid-trading",
    "publisherUrl": "https://clawhub.ai/adacapo21/openmm-grid-trading",
    "owner": "adacapo21",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openmm-grid-trading",
    "downloadUrl": "https://openagent3.xyz/downloads/openmm-grid-trading",
    "agentUrl": "https://openagent3.xyz/skills/openmm-grid-trading/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openmm-grid-trading/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openmm-grid-trading/agent.md"
  }
}