How do I install the Openmm skill?

Run npx skillmds@latest add modbender/openmm in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Openmm skill do?

Open-source market making for AI agents. Multi-exchange trading, grid strategies, and real-time market data. CLI + MCP + Skills. It is listed under AI & ML on SkillMD.

Is Openmm safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openmm?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openmm free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openmm?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openmm by modbender — Agent Skill

Name: Openmm
Rating: 4.2 (5 reviews)
Author: modbender

OpenMM — Open-Source Market Making for AI Agents

OpenMM is an open-source market making framework — multi-exchange support, grid strategies, real-time market data, and automated trading. One CLI for everything.

GitHub: https://github.com/3rd-Eye-Labs/OpenMM MCP Server: https://github.com/QBT-Labs/OpenMM-MCP Docs: https://deepwiki.com/3rd-Eye-Labs/OpenMM

What is OpenMM?

Multi-Exchange — MEXC, Gate.io, Kraken, Bitget
Grid Trading — Automated grid strategies with dynamic spacing, sizing, and volatility adjustment
Market Data — Tickers, orderbooks, recent trades across all exchanges
Order Management — Limit/market orders, cancel, list open orders
Cardano DEX — Pool discovery, aggregated prices via Iris Protocol
CLI + MCP — Use via command line or as MCP server for AI agents
Open Source — MIT licensed, fully customizable

Quick Start

Option A: CLI

# Install
npm install -g @3rd-eye-labs/openmm

# Set exchange credentials as environment variables
export MEXC_API_KEY="your_api_key"
export MEXC_SECRET="your_secret_key"

# Check balances
openmm balance --exchange mexc

# Get ticker price
openmm ticker --exchange mexc --symbol BTC/USDT

# Start grid trading (dry run first)
openmm trade --strategy grid --exchange mexc --symbol INDY/USDT --dry-run

Option B: MCP Server

Run npx @qbtlabs/openmm-mcp to start a local MCP server over stdio. This exposes all 13 tools to any MCP-compatible client.

{
  "mcpServers": {
    "openmm": {
      "command": "npx",
      "args": ["@qbtlabs/openmm-mcp"],
      "env": {
        "MEXC_API_KEY": "your_key",
        "MEXC_SECRET": "your_secret"
      }
    }
  }
}

Only include env vars for exchanges you want to use.

Option C: As Library

import { OpenMM } from '@3rd-eye-labs/openmm';

const mm = new OpenMM({
  exchange: 'mexc',
  apiKey: process.env.MEXC_API_KEY,
  secret: process.env.MEXC_SECRET
});

const orderbook = await mm.getOrderbook('BTC/USDT');

Environment Setup

Exchange credentials are configured via environment variables — keys are stored locally and never sent to the server. Add them to your .env file or export them in your shell:

# MEXC (API key + secret)
MEXC_API_KEY=your_mexc_api_key
MEXC_SECRET=your_mexc_secret_key

# Gate.io (API key + secret)
GATEIO_API_KEY=your_gateio_api_key
GATEIO_SECRET=your_gateio_secret_key

# Bitget (API key + secret + passphrase set when creating the API key)
BITGET_API_KEY=your_bitget_api_key
BITGET_SECRET=your_bitget_secret_key
BITGET_PASSPHRASE=your_bitget_passphrase

# Kraken (API key + secret)
KRAKEN_API_KEY=your_kraken_api_key
KRAKEN_SECRET=your_kraken_secret_key

Symbol Format

Use standard format: BTC/USDT, ETH/USDT, INDY/USDT, ADA/EUR, BTC/USD
The CLI automatically converts to exchange-specific format
Kraken supports both USD/EUR fiat pairs and USDT pairs

Core Tools

Balance & Portfolio

Check account balances on any connected exchange. Query each exchange separately — there is no cross-exchange aggregate command.

# Get all balances
openmm balance --exchange mexc
openmm balance --exchange gateio
openmm balance --exchange bitget
openmm balance --exchange kraken

# Get specific asset balance
openmm balance --exchange mexc --asset BTC
openmm balance --exchange mexc --asset USDT
openmm balance --exchange kraken --asset ADA
openmm balance --exchange kraken --asset EUR

# JSON output (useful for scripting)
openmm balance --exchange mexc --json
openmm balance --exchange bitget --json

Options:

-e, --exchange <exchange> — Exchange to query (required)
-a, --asset <asset> — Specific asset to query (optional)
--json — Output in JSON format

Market Data

Real-time prices, orderbooks, and trade history. Use --symbol with the standard BASE/QUOTE format. Kraken uses fiat pairs like ADA/EUR and BTC/USD alongside crypto pairs.

Ticker — current price, bid/ask, spread, volume:

# MEXC
openmm ticker --exchange mexc --symbol BTC/USDT
openmm ticker --exchange mexc --symbol ETH/USDT --json

# Bitget (Cardano tokens)
openmm ticker --exchange bitget --symbol SNEK/USDT
openmm ticker --exchange bitget --symbol BTC/USDT --json

# Kraken (fiat pairs)
openmm ticker --exchange kraken --symbol ADA/EUR
openmm ticker --exchange kraken --symbol BTC/USD --json

Order Book — bid/ask depth:

# MEXC - BTC/USDT with default 10 levels
openmm orderbook --exchange mexc --symbol BTC/USDT

# Bitget - top 5 levels for SNEK
openmm orderbook --exchange bitget --symbol SNEK/USDT --limit 5

# Kraken - ADA/EUR with 10 levels
openmm orderbook --exchange kraken --symbol ADA/EUR --limit 10

# Gate.io - JSON output
openmm orderbook --exchange gateio --symbol BTC/USDT --json

Recent Trades — latest executions with buy/sell breakdown:

# MEXC - default 20 trades
openmm trades --exchange mexc --symbol BTC/USDT

# Bitget - 50 trades for SNEK
openmm trades --exchange bitget --symbol SNEK/USDT --limit 50

# Kraken - ADA/EUR trades
openmm trades --exchange kraken --symbol ADA/EUR

# Gate.io - JSON output
openmm trades --exchange gateio --symbol ETH/USDT --json

Options (shared across ticker, orderbook, trades):

-e, --exchange <exchange> — Exchange to query (required)
-s, --symbol <symbol> — Trading pair symbol (required)
-l, --limit <limit> — Number of levels/trades (orderbook default: 10, trades default: 20)
--json — Output in JSON format

Order Management

Place and manage orders on any supported exchange. Orders use your exchange API credentials configured via environment variables.

# List all open orders
openmm orders list --exchange mexc
openmm orders list --exchange gateio
openmm orders list --exchange bitget

# List open orders for a specific pair
openmm orders list --exchange bitget --symbol SNEK/USDT
openmm orders list --exchange kraken --symbol ADA/EUR --limit 5

# Get specific order by ID
openmm orders get --exchange mexc --id 123456 --symbol BTC/USDT
openmm orders get --exchange bitget --id 1385288398060044291 --symbol SNEK/USDT
openmm orders get --exchange kraken --id OQN3UE-LRH6U-MPLZ5I --symbol ADA/EUR

# Create limit buy order
openmm orders create --exchange mexc --symbol BTC/USDT --side buy --type limit --amount 0.001 --price 50000
openmm orders create --exchange bitget --symbol SNEK/USDT --side buy --type limit --amount 10000 --price 0.00001
openmm orders create --exchange kraken --symbol ADA/EUR --side buy --type limit --amount 50 --price 0.45

# Create market sell order
openmm orders create --exchange mexc --symbol BTC/USDT --side sell --type market --amount 0.001
openmm orders create --exchange bitget --symbol SNEK/USDT --side sell --type market --amount 5000

# Cancel order by ID (symbol is required)
openmm orders cancel --exchange mexc --id C02__626091255599874048060 --symbol INDY/USDT
openmm orders cancel --exchange bitget --id 1385288398060044291 --symbol SNEK/USDT
openmm orders cancel --exchange kraken --id OQN3UE-LRH6U-MPLZ5I --symbol ADA/EUR

Create Options:

-e, --exchange <exchange> — Exchange to use (required)
-s, --symbol <symbol> — Trading pair (required)
--side <side> — Order side: buy/sell (required)
--type <type> — Order type: market/limit (required)
--amount <amount> — Order amount in base currency (required)
--price <price> — Order price (required for limit orders, ignored for market)
--json — Output in JSON format

Exchange notes:

Bitget — 6 decimal price precision for SNEK/NIGHT pairs, 2 decimal quantity precision. Requires passphrase.
Kraken — Minimum order value 5 EUR/USD. Supports major fiat pairs (EUR, USD, GBP).
MEXC/Gate.io — Minimum order value 1 USDT per order.

Grid Trading

The grid strategy places buy and sell orders at intervals around the current center price. As price oscillates, orders fill and the grid automatically recreates — capturing the spread on each cycle. Total orders = levels x 2.

# Start grid with defaults (5 levels, 2% spacing, $50 per order)
openmm trade --strategy grid --exchange mexc --symbol INDY/USDT

# Dry run — preview the grid without placing real orders
openmm trade --strategy grid --exchange bitget --symbol SNEK/USDT --dry-run

# Custom grid 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

# Geometric spacing — tighter near center, wider at edges
openmm trade --strategy grid --exchange kraken --symbol BTC/USD \
  --levels 10 \
  --spacing 0.005 \
  --spacing-model geometric \
  --spacing-factor 1.5 \
  --size-model pyramidal \
  --size 50

# Volatility-based spread adjustment — grid widens in volatile markets
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

# Volatility with custom thresholds (tighter sensitivity)
openmm trade --strategy grid --exchange kraken --symbol SNEK/EUR \
  --levels 5 \
  --spacing 0.01 \
  --size 5 \
  --volatility \
  --volatility-low 0.01 \
  --volatility-high 0.03

# Load configuration from a JSON profile
openmm trade --strategy grid --exchange gateio --symbol SNEK/USDT \
  --grid-profile ./profiles/balanced-geometric.json

Strategy output on startup:

Starting Trading Strategy
Strategy: GRID
Exchange: KRAKEN
Symbol: BTC/USD
Grid Levels: 10 per side (20 total)
Grid Spacing: 0.3%
Spacing Model: geometric
Spacing Factor: 1.3
Size Model: pyramidal
Order Size: $50
Max Position: 80%
Safety Reserve: 20%

Strategy initialized successfully
Grid Configuration:
  Levels: 10 per side (20 total orders)
  Spacing Model: geometric
  Base Spacing: 0.30%
  Spacing Factor: 1.3
  Size Model: pyramidal
  Base Size: $50
Strategy is now running!
Press Ctrl+C to stop the strategy gracefully

Graceful shutdown: Press Ctrl+C. The system cancels all open orders, disconnects from the exchange, and displays 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:

--levels <number> — Grid levels each side (default: 5, max: 10, total orders = levels x 2)
--spacing <decimal> — Base price spacing between levels (default: 0.02 = 2%)
--size <number> — Base order size in quote currency (default: 50)
--confidence <decimal> — Minimum price confidence to trade (default: 0.6)
--deviation <decimal> — Price deviation to trigger grid recreation (default: 0.015)
--debounce <ms> — Delay between grid adjustments (default: 2000ms)
--max-position <decimal> — Maximum position size as % of balance (default: 0.8)
--safety-reserve <decimal> — Safety reserve as % of balance (default: 0.2)
--dry-run — Simulate trading without placing real orders

Dynamic Grid Parameters:

--spacing-model <model> — linear, geometric, or custom (default: linear)
--spacing-factor <number> — Geometric spacing multiplier per level (default: 1.3)
--size-model <model> — flat, pyramidal, or custom (default: flat)
--grid-profile <path> — Load complete grid configuration from a JSON profile

Volatility Parameters:

--volatility — Enable volatility-based dynamic spread adjustment
--volatility-low <decimal> — Low volatility threshold (default: 0.02). Below this, spacing stays normal.
--volatility-high <decimal> — High volatility threshold (default: 0.05). Above this, spacing is widened maximally.

Exchange notes for grid:

MEXC/Gate.io — Minimum 1 USDT per order. Ensure --size / --levels >= 1.
Bitget — Minimum 1 USDT per order. Price precision: 6 decimals for SNEK/NIGHT. Requires passphrase.
Kraken — Minimum 5 EUR/USD per order. Ensure --size / --levels >= 5.

Cardano DEX Integration

OpenMM integrates with Cardano DEX liquidity pools via the Iris Protocol. Supported tokens: INDY (Indigo Protocol), SNEK (Snek Token), NIGHT (Midnight), MIN (Minswap).

Prices are calculated by fetching TOKEN/ADA from on-chain DEX pools (weighted by TVL), then multiplying by ADA/USDT from CEX price feeds (MEXC, Coingecko) to produce a TOKEN/USDT price.

Discover liquidity pools:

# Find all pools for a token
openmm pool-discovery discover INDY

# Top 5 pools for SNEK
openmm pool-discovery discover SNEK --limit 5

# Filter by minimum TVL
openmm pool-discovery discover INDY --min-liquidity 50000

# Show all pools (ignore limit)
openmm pool-discovery discover NIGHT --show-all

Get live prices from pools:

openmm pool-discovery prices NIGHT
openmm pool-discovery prices SNEK
openmm pool-discovery prices INDY

List supported tokens:

openmm pool-discovery supported

Compare DEX vs CEX prices:

openmm price-comparison --symbol SNEK
openmm price-comparison --symbol INDY

Safety Rules

Always dry-run first

Before executing any grid strategy, preview the grid to see what orders will be placed:

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

Confirm before execution

For AI agents using MCP:

Always show the trade plan — display what will be executed
Get explicit confirmation — never auto-execute without user approval
Use dryRun: true — the MCP start_grid_strategy tool defaults to dry-run mode

Risk management

Grid strategy has built-in risk controls:

--max-position 0.6 — Use max 60% of balance for trading (default: 80%)
--safety-reserve 0.3 — Keep 30% as safety reserve (default: 20%)
--confidence 0.8 — Require 80% price confidence before trading (default: 60%)

Total allocation is automatically capped regardless of the size model used. The grid recreates when orders are filled and adjusts to significant price movements (configurable via --deviation).

CLI Reference

Balance & Market Data

Command	Description
`balance`	Get balances for an exchange
`ticker`	Get current price, bid/ask, spread, volume
`orderbook`	Get orderbook depth (bids/asks)
`trades`	Get recent trades
`price-comparison`	Compare DEX vs CEX prices for Cardano tokens

Orders

Command	Description
`orders list`	List open orders (all or by symbol)
`orders get`	Get specific order by ID
`orders create`	Place a limit or market order
`orders cancel`	Cancel an order by ID

Trading

Command	Description
`trade --strategy grid`	Start grid trading strategy

Cardano

Command	Description
`pool-discovery discover`	Discover DEX liquidity pools for a token
`pool-discovery supported`	List supported Cardano tokens (INDY, SNEK, NIGHT, MIN)
`pool-discovery prices`	Get live aggregated pool prices

Supported Exchanges

Exchange	Trading	Grid	Market Data	Min Order	Notes
MEXC	✅	✅	✅	1 USDT	API key + secret
Gate.io	✅	✅	✅	1 USDT	API key + secret
Bitget	✅	✅	✅	1 USDT	API key + secret + passphrase
Kraken	✅	✅	✅	5 EUR/USD	API key + secret, fiat pairs supported
Binance	🔜	🔜	🔜	—	Coming soon
Coinbase	🔜	🔜	🔜	—	Coming soon
OKX	🔜	🔜	🔜	—	Coming soon

Tips for Agents

Check balances first — always run openmm balance --exchange <ex> before trading
Use --dry-run — preview grid strategies before placing real orders
Use BASE/QUOTE format — e.g. BTC/USDT, ADA/EUR, SNEK/USDT
Query each exchange separately — there is no cross-exchange aggregate command
Handle rate limits — exchanges have API limits, space out requests
Store credentials securely — use environment variables, never commit .env files
Respect minimum order values — MEXC/Gate.io/Bitget: 1 USDT, Kraken: 5 EUR/USD
Use --max-position and --safety-reserve — built-in risk controls for grid strategies
Bitget requires passphrase — set via BITGET_PASSPHRASE env var (created when generating the API key)
Use --json for parsing — all commands support --json for structured output

MCP Tools (via OpenMM-MCP)

When using OpenMM as an MCP server, these 13 tools are available:

Market Data

Tool	Description	Parameters
`get_ticker`	Real-time price, bid/ask, spread, volume	`exchange`, `symbol`
`get_orderbook`	Order book depth (bids/asks)	`exchange`, `symbol`, `limit?`
`get_trades`	Recent trades with buy/sell summary	`exchange`, `symbol`, `limit?`

Account

Tool	Description	Parameters
`get_balance`	Account balances (all or filtered by asset)	`exchange`, `asset?`
`list_orders`	Open orders (all or by symbol)	`exchange`, `symbol?`

Trading

Tool	Description	Parameters
`create_order`	Place limit or market order	`exchange`, `symbol`, `type`, `side`, `amount`, `price?`
`cancel_order`	Cancel order by ID	`exchange`, `symbol`, `orderId`
`cancel_all_orders`	Cancel all open orders for a pair	`exchange`, `symbol`

Strategy

Tool	Description	Parameters
`start_grid_strategy`	Calculate and place grid orders (defaults to dry-run)	`exchange`, `symbol`, `levels?`, `spacing?`, `orderSize?`, `spacingModel?`, `sizeModel?`, `dryRun?`
`stop_strategy`	Cancel all orders for a pair, stopping the grid	`exchange`, `symbol`
`get_strategy_status`	Grid status with open orders, price, and spread	`exchange`, `symbol`

Cardano

Tool	Description	Parameters
`get_cardano_price`	Aggregated token price from DEX pools (TOKEN/USDT via ADA bridge)	`symbol`
`discover_pools`	Discover Cardano DEX liquidity pools for a token	`symbol`

MCP Resources

URI	Description
`exchanges://list`	Supported exchanges with credential requirements
`strategies://grid`	Grid trading strategy documentation
`strategies://grid/profiles`	Example grid profiles (conservative/moderate/aggressive)

MCP Prompts

Prompt	Description
`market_analysis`	Analyze ticker + orderbook + trades for a trading pair
`portfolio_overview`	Summarize balances and open orders across an exchange
`grid_setup_advisor`	Recommend grid config based on market analysis and balance

Sub-Skills

For specific workflows, load these sub-skills:

Skill	Description
`openmm-exchange-setup`	Configure exchange API credentials step-by-step
`openmm-grid-trading`	Grid strategy creation and management
`openmm-portfolio`	Balance tracking and order overview across exchanges

About

OpenMM is built by 3rd Eye Labs and QBT Labs.

License: MIT

Openmm

File contents

OpenMM — Open-Source Market Making for AI Agents

What is OpenMM?

Quick Start

Option A: CLI

Option B: MCP Server

Option C: As Library

Environment Setup

Symbol Format

Core Tools

Balance & Portfolio

Market Data

Order Management

Grid Trading

Cardano DEX Integration

Safety Rules

Always dry-run first

Confirm before execution

Risk management

CLI Reference

Balance & Market Data

Orders

Trading

Cardano

Supported Exchanges

Tips for Agents

MCP Tools (via OpenMM-MCP)

Market Data

Account

Trading

Strategy

Cardano

MCP Resources

MCP Prompts

Sub-Skills

Links

About

Frequently asked questions

Openmm

File contents

OpenMM — Open-Source Market Making for AI Agents

What is OpenMM?

Quick Start

Option A: CLI

Option B: MCP Server

Option C: As Library

Environment Setup

Symbol Format

Core Tools

Balance & Portfolio

Market Data

Order Management

Grid Trading

Cardano DEX Integration

Safety Rules

Always dry-run first

Confirm before execution

Risk management

CLI Reference

Balance & Market Data

Orders

Trading

Cardano

Supported Exchanges

Tips for Agents

MCP Tools (via OpenMM-MCP)

Market Data

Account

Trading

Strategy

Cardano

MCP Resources

MCP Prompts

Sub-Skills

Links

About

Related skills

Frequently asked questions

How do I install the Openmm skill?

What does the Openmm skill do?

Is Openmm safe to use?

Which AI agents work with Openmm?

Is Openmm free to use?

Who published Openmm?