Skip to main content

True Markets CLI

tm is a terminal-native interface for non-custodial DeFi trading on Solana and Base, built for developers, strategy builders, and AI agents. Buy, sell, transfer, and check balances with JSON output and dry-run simulation.

Private keys are secured via Turnkey and never leave your device.

  • No gas fees. No bridge fees. A flat 20 bp fee per trade, reflected in the quote before you confirm.
  • 150 assets across Solana and Base. The CLI auto-resolves the chain from the token symbol.
  • JSON output on every command (-o json), so it composes with jq and scripts.
  • Dry-run first — simulate any trade or transfer before it spends anything.
This is the DeFi surface

The CLI trades non-custodially on Solana and Base. That's a different product from the custodial Retail Gateway and the Trading Firms CeFi venue, which use their own credentials and account models. A True Markets login is not interchangeable across them.

Get going

  1. Install — one-liner, Homebrew, or a pre-built binary.
  2. Authenticatetm signup or tm login, verified by emailed code.
  3. Run a commandtm assets, tm balances, tm buy.
  4. Wire it to an agent — skills for local agents, MCP for hosted clients.

First trade

Simulate before committing. --dry-run prices the trade and shows the fee without executing:

$ tm buy SOL 100 --dry-run
Chain: Solana
Asset: SOL
Amount: $100.00
Price: $142.38
Qty: 0.7024 SOL
Fee: $0.20

When the quote looks right, --force skips the confirmation prompt:

$ tm buy SOL 100 --force
✓ Order filled — 0.7024 SOL @ $142.38

Everything speaks JSON:

$ tm balances -o json
[{"asset":"SOL","balance":"0.7024","chain":"solana"}, ...]
  • MCP — per-client setup for the hosted MCP server.
  • SDKs — typed TypeScript and Python clients for the custodial Retail API.