openmm-portfolio

Balance tracking, order overview, and market data across exchanges using OpenMM.

# OpenMM Portfolio Management

Track balances, review open orders, and monitor market data across exchanges.

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

# Get specific order details
openmm orders get --exchange mexc --id 123456 --symbol BTC/USDT
```

## 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_strategy_status` | Grid status with open orders and spread |
| `get_cardano_price` | Aggregated Cardano token price |

The MCP server also provides a `portfolio_overview` prompt that automatically summarizes balances and open orders for an exchange.

## 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. **Monitor grid strategies** — use `get_strategy_status` MCP tool to check active grids