# Send OpenMM Grid Trading to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/openmm-grid-trading",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openmm-grid-trading",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### OpenMM Grid Trading

Create automated grid trading strategies that profit from market volatility.

### What is Grid Trading?

Grid trading places multiple buy and sell orders at preset price intervals around the current center price. As price oscillates, the bot automatically:

Buys low — places buy orders below the center price
Sells high — places sell orders above the center price
Profits from volatility — each complete cycle captures the spread

The 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).

### When to Use

Good for:

Sideways/ranging markets
High volatility pairs
Passive income generation
24/7 automated trading

Avoid when:

Strong trending markets (risk of holding losing positions)
Low liquidity pairs
High fee environments

### 1. Dry Run First (Always!)

openmm trade --strategy grid --exchange mexc --symbol INDY/USDT --dry-run

### 2. Start Grid with Defaults

openmm trade --strategy grid --exchange mexc --symbol INDY/USDT

### 3. Custom Configuration

openmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\
  --levels 5 \\
  --spacing 0.02 \\
  --size 50 \\
  --max-position 0.6 \\
  --safety-reserve 0.3

### 4. Stop the Strategy

Press Ctrl+C to gracefully stop. The system will:

Cancel all open orders
Disconnect from exchange
Display final status

### Required Parameters

--strategy grid — Specifies grid trading strategy
--exchange <exchange> — Exchange to trade on (mexc, bitget, gateio, kraken)
--symbol <symbol> — Trading pair (e.g., INDY/USDT, SNEK/USDT, ADA/EUR)

### Grid Parameters

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—

### Dynamic Grid Parameters

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—

### Volatility Parameters

ParameterDescriptionDefault--volatilityEnable volatility-based spread adjustmentoff--volatility-low <decimal>Low volatility threshold0.02--volatility-high <decimal>High volatility threshold0.05

### Spacing Models

Linear (default): Equal spacing between all levels.

With --spacing 0.02 and 5 levels:
Level 1:  2% from center
Level 2:  4% from center
Level 3:  6% from center
Level 4:  8% from center
Level 5: 10% from center

Geometric: Tighter spacing near center, wider gaps at outer levels.

openmm trade --strategy grid --exchange kraken --symbol BTC/USD \\
  --levels 5 --spacing 0.005 --spacing-model geometric --spacing-factor 1.5

Level 1: 0.50% from center
Level 2: 1.25% from center
Level 3: 2.38% from center
Level 4: 4.06% from center
Level 5: 6.59% from center

Custom: Define exact spacing offsets per level using a grid profile JSON file.

### Size Models

Flat (default): All levels get equal order sizes.

Pyramidal: Larger orders near center price where fills are more likely, tapering at outer levels.

openmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\
  --levels 5 --size 50 --size-model pyramidal

### Grid Profiles

JSON files for complete grid configuration:

{
  "name": "balanced-geometric",
  "description": "Geometric spacing with pyramidal sizing",
  "levels": 10,
  "spacingModel": "geometric",
  "baseSpacing": 0.005,
  "spacingFactor": 1.3,
  "sizeModel": "pyramidal",
  "baseSize": 50
}

openmm trade --strategy grid --exchange gateio --symbol SNEK/USDT \\
  --grid-profile ./profiles/balanced-geometric.json

### Volatility-Based Spread Adjustment

When enabled, the grid automatically widens during volatile conditions and tightens when the market calms. Tracks price changes over a 5-minute rolling window.

Below low threshold (default 2%): Normal spacing (1.0x)
Between thresholds: Elevated spacing (1.5x)
Above high threshold (default 5%): Wide spacing (2.0x)

openmm trade --strategy grid --exchange mexc --symbol INDY/USDT \\
  --levels 10 \\
  --spacing 0.005 \\
  --spacing-model geometric \\
  --spacing-factor 1.3 \\
  --size-model pyramidal \\
  --size 5 \\
  --volatility

### Conservative

openmm trade --strategy grid --exchange bitget --symbol SNEK/USDT \\
  --levels 2 \\
  --spacing 0.02 \\
  --size 20

### Active

openmm trade --strategy grid --exchange mexc --symbol BTC/USDT \\
  --levels 7 \\
  --spacing 0.005 \\
  --size 25

### Dynamic (Geometric + Pyramidal)

openmm trade --strategy grid --exchange kraken --symbol SNEK/EUR \\
  --levels 10 \\
  --spacing 0.005 \\
  --spacing-model geometric \\
  --spacing-factor 1.5 \\
  --size-model pyramidal \\
  --size 5

### Risk Management

--max-position — Maximum % of balance used for trading (default: 80%)
--safety-reserve — % of balance kept as reserve (default: 20%)
--confidence — Minimum price confidence required (default: 60%)
Grid is automatically recreated when orders are filled
Adjusts to significant price movements (configurable via --deviation)

### Exchange-Specific Notes

MEXC/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).

### Tips for Agents

Always dry-run first — show user the plan before executing
Check balance — verify sufficient funds with openmm balance --exchange <ex>
Check current price — use openmm ticker --exchange <ex> --symbol <sym>
Respect minimum order values — ensure --size divided by --levels meets exchange minimums
Use Ctrl+C to stop — graceful shutdown cancels all open orders
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: adacapo21
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openmm-grid-trading)
- [Send to Agent page](https://openagent3.xyz/skills/openmm-grid-trading/agent)
- [JSON manifest](https://openagent3.xyz/skills/openmm-grid-trading/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openmm-grid-trading/agent.md)
- [Download page](https://openagent3.xyz/downloads/openmm-grid-trading)