Skill: adacapo21/openmm-portfolio (version 0.1.1)

--- name: openmm-portfolio description: "Balance tracking, order overview, and market data across exchanges using OpenMM." allowed-tools: Read, Glob, Grep, Bash(openmm:*) license: MIT metadata: author: qbtlabs version: '0.1.1' openclaw: emoji: "💼" requires: bins: [openmm] env: [MEXC_API_KEY, GATEIO_API_KEY, BITGET_API_KEY, KRAKEN_API_KEY] install: - kind: node package: "@3rd-eye-labs/openmm" bins: [openmm] --- # OpenMM Portfolio Management Track balances, review open orders, and monitor market data across exchanges. ## Required Credentials At least one exchange must be configured via environment variables. Set the credentials for each exchange you want to query: ```bash # MEXC MEXC_API_KEY=your-mexc-api-key MEXC_SECRET=your-mexc-secret MEXC_UID=your-mexc-uid-for-whitelisted-access # Gate.io GATEIO_API_KEY=your-gateio-api-key GATEIO_SECRET=your-gateio-secret # Bitget (requires passphrase) BITGET_API_KEY=your-bitget-api-key BITGET_SECRET=your-bitget-secret BITGET_PASSPHRASE=your-bitget-passphrase # Kraken KRAKEN_API_KEY=your-kraken-api-key KRAKEN_SECRET=your-kraken-secret ``` See the **openmm-exchange-setup** skill for detailed configuration instructions. ## View Balances ```bash # All assets on an exchange openmm balance --exchange mexc openmm balance --exchange kraken # Specific asset openmm balance --exchange mexc --asset BTC openmm balance --exchange kraken --asset ADA openmm balance --exchange bitget --asset USDT # JSON output openmm balance --exchange mexc --json ``` To see balances across all exchanges, query each one: ```bash openmm balance --exchange mexc openmm balance --exchange gateio openmm balance --exchange bitget openmm balance --exchange kraken ``` ## Review Open Orders ```bash # All open orders on an exchange openmm orders list --exchange mexc # Filter by trading pair openmm orders list --exchange bitget --symbol SNEK/USDT # Limit results openmm orders list --exchange kraken --limit 5 ``` ## Check Market Prices ```bash # Current price openmm ticker --exchange mexc --symbol BTC/USDT openmm ticker --exchange kraken --symbol ADA/EUR # Order book depth openmm orderbook --exchange bitget --symbol SNEK/USDT --limit 10 # Recent trades openmm trades --exchange mexc --symbol ETH/USDT --limit 50 ``` ## Compare Prices Across Exchanges ```bash # Compare DEX and CEX prices for Cardano tokens openmm price-comparison --symbol SNEK openmm price-comparison --symbol INDY ``` ## Cardano Token Prices ```bash # Aggregated price from DEX pools openmm pool-discovery prices NIGHT openmm pool-discovery prices SNEK # Discover liquidity pools openmm pool-discovery discover INDY openmm pool-discovery discover SNEK --min-liquidity 50000 ``` ## MCP Tools for Portfolio Overview When using the MCP server, these tools are relevant for portfolio management: | Tool | Description | |------|-------------| | `get_balance` | Get balances for an exchange (all or specific asset) | | `list_orders` | List open orders on an exchange | | `get_ticker` | Current price for a trading pair | | `get_orderbook` | Order book depth (bids/asks) | | `get_trades` | Recent trades with buy/sell summary | | `get_cardano_price` | Aggregated Cardano token price | | `discover_pools` | Discover Cardano DEX liquidity pools | ## Tips for Agents 1. **Check balances before trading** — always verify available funds 2. **Query each exchange separately** — there is no cross-exchange aggregate command 3. **Use `--json` for parsing** — structured output for programmatic use 4. **Use `BASE/QUOTE` format** — e.g. `BTC/USDT`, `ADA/EUR`, `SNEK/USDT` 5. **Respect minimum order values** — MEXC/Gate.io/Bitget: 1 USDT, Kraken: 5 EUR/USD

path: references/exchange-data.md
content: # Exchange Data Reference

Exchange-specific notes for market data queries and portfolio tracking.

## MEXC

- **Minimum order:** 1 USDT
- **Credentials:** `MEXC_API_KEY`, `MEXC_SECRET`
- **Supported Cardano tokens:** SNEK/USDT, INDY/USDT, NIGHT/USDT
- **Symbol format:** `BASE/QUOTE` (e.g., `BTC/USDT`, `ETH/USDT`)
- **Notes:** Most Cardano native tokens are listed here. Good source for CEX price comparison against DEX.

## Gate.io

- **Minimum order:** 1 USDT
- **Credentials:** `GATEIO_API_KEY`, `GATEIO_SECRET`
- **Symbol format:** `BASE/QUOTE` (e.g., `BTC/USDT`, `ETH/USDT`)
- **Notes:** Wide range of altcoin listings. Standard USDT pairs.

## Kraken

- **Minimum order:** 5 EUR/USD
- **Credentials:** `KRAKEN_API_KEY`, `KRAKEN_SECRET`
- **Supported fiat pairs:** EUR, USD, GBP
- **Notable pairs:** ADA/EUR, BTC/USD, ETH/EUR
- **Symbol format:** `BASE/QUOTE` (e.g., `ADA/EUR`, `BTC/USD`)
- **Notes:** Supports major fiat currency pairs. Higher minimum order value compared to other exchanges. Useful for fiat on/off ramp pricing and ADA/EUR quotes.

## Bitget

- **Minimum order:** 1 USDT
- **Credentials:** `BITGET_API_KEY`, `BITGET_SECRET`, `BITGET_PASSPHRASE`
- **Price precision:** 6 decimal places for SNEK/USDT and NIGHT/USDT pairs
- **Symbol format:** `BASE/QUOTE` (e.g., `SNEK/USDT`, `BTC/USDT`)
- **Notes:** Requires a passphrase in addition to API key and secret (set when creating the API key on Bitget). The 6 decimal price precision for SNEK and NIGHT is important for accurate orderbook and ticker data interpretation.

## Common Notes

- All exchanges use `BASE/QUOTE` symbol format (e.g., `BTC/USDT`, `ADA/EUR`)
- The CLI automatically converts to exchange-specific internal formats
- Query each exchange separately — there is no cross-exchange aggregate command
- Use `--json` flag for structured output on all commands
- Credentials are set via environment variables and stored locally


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)