Nado

Setup Instructions

1. Check if CLI is Installed

which nado

If not found, install it:

bun install -g @nadohq/nado-cli
# or
npm install -g @nadohq/nado-cli

Or run without installing:

bunx @nadohq/nado-cli --help
# or
npx @nadohq/nado-cli --help

2. Verify Installation

nado --version
nado --help

3. Configure Credentials

Nado CLI resolves settings with this precedence: CLI flags > environment variables > config file > defaults.

Option A: Config file (recommended)

Create ~/.config/nado/config.toml:

[default]
data_env = "nadoMainnet"        # nadoMainnet | nadoTestnet
subaccount_name = "default"

[credentials]
private_key = "0x..."
subaccount_owner = "0x..."      # only needed when using a linked signer

Or use the interactive configurator:

nado auth set

Option B: Environment variables

export PRIVATE_KEY=0x...your_private_key...
export DATA_ENV=nadoMainnet

4. Set Up 1-Click Trading (Recommended)

For the best trading experience, set up a linked signer so the CLI can sign transactions without your main wallet key:

nado setup

The wizard offers two methods:

1. Generate new — creates a fresh hot key; you link it via the web app
2. Deterministic — derives the same key the web app uses (requires your main private key once, which is NOT saved)

The hot signer key is saved to ~/.config/nado/config.toml and used for all future signing.

Product IDs

Spot products have even IDs (0, 2, 4…). Perp products have odd IDs (1, 3, 5…). Product 0 is USDT0 (the quote token).

Markets can be referenced by symbol (BTC, ETH), full name (BTC-PERP, ETH), or numeric product ID. The long/short commands auto-resolve to perp markets; buy/sell auto-resolve to spot markets.

nado market list       # List all product IDs and names

Quick Command Reference

Auth & Configuration

nado auth set                        # Interactive credential setup
nado auth set private-key 0x...      # Set a single credential
nado auth set owner 0x...            # Set subaccount owner
nado auth set network nadoTestnet    # Switch network
nado auth whoami                     # Show current identity and config
nado auth link-signer <address>      # Link a signer for 1-click trading
nado setup                           # 1-click trading setup wizard

Market Data

nado market list                             # List all available markets
nado market price BTC                        # Best bid/ask for one market
nado market prices BTC ETH SOL               # Bid/ask for multiple markets
nado market orderbook BTC --depth 20         # Orderbook depth
nado market orderbook BTC --depth 20 -w      # Watch orderbook in real-time (WebSocket)
nado market candles BTC --period 3600 --limit 10  # 1h OHLCV candles
nado market funding BTC                      # Current funding rate
nado market tickers                          # 24h tickers for all markets
nado market tickers --market perp            # Perp tickers only

Account

All account commands use your configured wallet. Override with --owner <address>.

nado account summary                         # Balances, health, positions
nado account positions                       # Open perp positions (cross + isolated)
nado account orders                          # Open orders across all markets
nado account orders BTC ETH                  # Open orders filtered by market (matches both spot and perp)
nado account history --limit 50              # Recent filled/cancelled orders
nado account history --product-ids BTC,ETH   # Filter history by market
nado account fees                            # Maker/taker fee rates
nado account stats                           # 30-day trading statistics
nado account stats --days 7                  # Weekly stats

Trading — Perps (long / short)

nado trade long BTC 0.01                          # Market long BTC-PERP
nado trade short ETH 0.5 -p 2500                  # Limit short ETH-PERP @ $2500
nado trade long SOL 10 -m isolated --leverage 5   # 5x isolated long
nado trade short BTC 0.01 --tif post_only -p 70000  # Post-only limit
nado trade long BTC 0.01 --tp 75000 --sl 60000    # Long with inline TP/SL

Trading — Spot (buy / sell)

nado trade buy BTC 0.1                        # Market buy BTC spot
nado trade sell ETH 1.0                       # Market sell ETH spot
nado trade buy BTC 0.05 -p 65000              # Limit buy BTC spot @ $65000
nado trade sell ETH 2.0 --no-borrow           # Sell without borrowing

Trading — TP/SL on Existing Positions

nado trade tp BTC 75000                       # Take-profit on BTC position (full close)
nado trade sl BTC 60000                       # Stop-loss on BTC position (full close)
nado trade tp BTC 75000 0.005                 # TP on partial amount
nado trade sl BTC 60000 0.005 -p 59500        # SL with stop-limit price

Trading — Close, Cancel, TWAP, Trigger

# Close positions
nado trade close BTC                          # Close a position
nado trade close-all                          # Close all positions
nado trade close-all --side long              # Close only long positions
nado trade close-all --product-ids BTC,ETH    # Close specific markets

# Cancel orders
nado trade cancel BTC <digest>                # Cancel specific order by digest
nado trade cancel-all BTC                     # Cancel all orders on a market

# Cancel trigger orders
nado trade cancel-trigger BTC <digest>        # Cancel specific trigger order
nado trade cancel-trigger-all BTC             # Cancel all trigger orders on a market

# Atomic cancel + place
nado trade cancel-and-place BTC long 0.01 --cancel-digests <digest> --cancel-market BTC -p 65000

# TWAP execution
nado trade twap BTC long 0.1 10               # TWAP long 0.1 BTC over 10 minutes
nado trade twap ETH short 1.0 30 --interval 60  # TWAP short with 60s intervals

# Trigger orders (stop-loss / take-profit)
nado trade trigger BTC long 0.01 --trigger-price 60000 --trigger-type oracle_price_below
nado trade trigger ETH short 0.5 --trigger-price 4000 --trigger-type oracle_price_above -p 3990

Funds

nado funds deposit 1000                       # Deposit 1000 USDT0 into subaccount
nado funds withdraw 500                       # Withdraw 500 USDT0 to wallet
nado funds transfer 200 --from default --to sub2  # Transfer between subaccounts

NLP Vault

nado nlp info                                 # Vault pool info and current state
nado nlp balance                              # Your locked/unlocked NLP balances
nado nlp mint 1000                            # Deposit 1000 USDT0 to mint NLP tokens
nado nlp burn 500                             # Burn 500 NLP to withdraw USDT0
nado nlp snapshots                            # Historical vault snapshots (daily)
nado nlp snapshots -g 3600 -l 24              # Hourly snapshots, last 24

Interactive Shell

nado shell

Starts an interactive REPL with tab completion and persistent history. Commands are the same as the CLI but without the nado prefix:

nado> market price BTC
nado> account summary
nado> trade long ETH 0.1
nado> help
nado> exit

Shell-specific commands: help, clear, exit/quit.

Global Options

Output Formats

Output defaults to table when running in a terminal (TTY) and json when piped. Override explicitly:

nado market price BTC                          # Table (default in terminal)
nado market price BTC --format json            # Force JSON
nado market price BTC --format json | jq .bid  # Pipe-friendly

Prompting for Credentials

When a user needs to set up trading, guide them through this process:

1. Check current setup: Run nado auth whoami to see current configuration
2. If not configured: Guide them through nado setup for the full 1-click trading wizard, or nado auth set for manual configuration
3. Explain signer types:
   • Direct wallet key: Set PRIVATE_KEY to your wallet's private key (simple but stores main key)
   • Linked signer (recommended): Use nado setup to create a hot signer key linked to your subaccount — your main wallet key is never stored
4. Security reminder: Never share private keys; the config file at ~/.config/nado/config.toml contains sensitive credentials

Example prompt to user:

To trade on Nado, you need to configure a signing key. The recommended approach:

1. Run nado setup and follow the interactive wizard
2. Choose "Deterministic" to derive the same signer the web app uses, or "Generate new" to create a fresh key
3. Verify with nado auth whoami

Would you like me to walk you through this?

Trigger Types

Run nado trade trigger --help to see all valid --trigger-type values (e.g. oracle_price_above, oracle_price_below). The CLI validates the choice automatically.

Common Workflows

Check portfolio and risk

nado account summary        # Overall health, balances, margin
nado account positions      # All open perp positions with PnL
nado account orders         # All resting limit orders
nado account fees           # Current fee tier

Enter a leveraged perp position with stop-loss

# Open 5x isolated long with inline TP/SL (single command)
nado trade long BTC 0.01 -m isolated --leverage 5 --tp 75000 --sl 58000

# Or set TP/SL separately on an existing position
nado trade long BTC 0.01 -m isolated --leverage 5
nado trade sl BTC 58000
nado trade tp BTC 75000

Provide liquidity via NLP vault

nado nlp info               # Check current vault state
nado nlp mint 5000          # Deposit 5000 USDT0
nado nlp balance            # Verify your NLP balance and lock status
nado nlp snapshots          # Track vault performance over time