---
title: "Commands"
url: https://docs.truemarkets.co/cli/commands
description: "Every tm command, its flags, defaults and output."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Commands

Every `tm` command, its flags and what it prints. Run `tm <command> --help` for the authoritative flags on any command.

## Global flags

| Flag | Default | Description |
| --- | --- | --- |
| `-o`, `--output` | `table` | Output format: `json` or `table` |

Pass `-o json` to any command to script against its output.

## Trading

### `tm buy <token> <amount>` · `tm sell <token> <amount>`

The CLI resolves the chain from the token symbol unless you pass `--chain`.

| Flag | Default | Description |
| --- | --- | --- |
| `--chain` | `solana` | Blockchain network: `solana` or `base` |
| `--qty-unit` | `quote` | Whether `<amount>` is in `base` (token) or `quote` (USD) units |
| `--dry-run` | `false` | Print the quote without executing |
| `--force` | `false` | Execute without the confirmation prompt |

Dry run first, then buy without the prompt

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

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

`--qty-unit base` reads `<amount>` as a token quantity instead of dollars, so `tm buy SOL 0.5 --qty-unit base` buys half a SOL.

> **`--force` skips confirmation**
> 
> Without `--force` the CLI prompts before spending. Scripts and agents that pass `--force` execute immediately, so pair it with `--dry-run` on a first pass.

### `tm transfer <to> <token> <amount>`

Transfer tokens to an external address.

| Flag | Default | Description |
| --- | --- | --- |
| `--chain` | `solana` | Blockchain network: `solana` or `base` |
| `--qty-unit` | `base` | `base` (token) or `quote` (USD) units. This defaults to `base`, unlike buy and sell |
| `--dry-run` | `false` | Print transfer details without executing |
| `--force` | `false` | Execute without the confirmation prompt |

## Account

### `tm balances`

Show your token balances.

Balances as JSON

```console
$ tm balances -o json
  [{"asset":"SOL","balance":"0.7024","chain":"solana"}, ...]
```

### `tm whoami`

Show your account and wallet info.

## Discovery

### `tm assets`

List the assets in the catalog. See [What you can trade](https://docs.truemarkets.co/trading-api/what-you-can-trade).

| Flag | Default | Description |
| --- | --- | --- |
| `--chain` | _(all)_ | Filter by chain: `solana` or `base` |

## Auth and config

| Command | Description |
| --- | --- |
| `tm signup [email]` | Create an account with email verification |
| `tm login [email]` | Log in with an email verification code |
| `tm logout` | Log out and clear stored tokens |
| `tm config show` | Show current configuration (secrets masked) |
| `tm config set <key> <value>` | Set a configuration value |

[Authentication](https://docs.truemarkets.co/cli/authentication) covers the login flow and environment variables.

* * *

**[Next: AI agents](https://docs.truemarkets.co/cli/ai-agents)**