Getting Started

Go from zero to logging your first trade in under five minutes. Install the CLI, subscribe for an API key, register your trader profile, and start building your trading journal.

On this page

  1. Install the CLI
  2. Subscribe & get your API key
  3. Log in
  4. Register your trader profile
  5. Log your first trade
  6. Query token context
  7. Connect Telegram
  8. Command reference (30+ commands)

1 Install the CLI

Trading Boy is a globally-installed npm package. You need Node.js 20 or later.

$ npm install -g @trading-boy/cli

Verify the installation:

$ trading-boy --version
1.7.0

2 Subscribe & get your API key

The subscribe command opens Stripe checkout in your browser. Once payment completes, your API key is provisioned instantly and saved to your local credential store.

$ trading-boy subscribe --plan starter -e you@email.com

Opening Stripe checkout...
Waiting for payment confirmation...
API Key: tb_live_abc123...
⚠️ Copy this key now — it will not be shown again.
API key saved. You're logged in.

Available plans: starter ($20/mo), pro ($40/mo), edge ($75/mo). See the pricing page for feature comparison.

Already have an API key? If you received a key through another channel, use trading-boy login to store it directly.

3 Log in

If you already subscribed, your key is saved automatically. To log in on another machine or with an existing key:

$ trading-boy login

Enter your API key: tb_live_...
Authenticated. Key saved to ~/.config/trading-boy/credentials.json

Once logged in, all CLI commands route securely through the hosted API. No database credentials needed on your machine.

4 Register your trader profile

Create a trader profile to link trades, wallets, and preferences to your identity.

$ trading-boy trader register --name "MyTrader"

Trader Profile
──────────────────────────────────────────────────
Name: MyTrader
ID: trd_8f2a...
Max Drawdown: 20%
Trader registered successfully.

Optionally link a Solana wallet:

$ trading-boy trader link-wallet MyTrader YOUR_WALLET_ADDRESS

5 Log your first trade

The journal is the core of Trading Boy. Every entry captures your decision alongside the full market context at that moment.

Log an entry (opening a position):

$ trading-boy journal log entry SOL \
  --trader MyTrader \
  --direction long \
  --price 148.50 \
  --size 500 \
  --thesis "Funding negative, whale accumulation, support holding"

Entry logged: id=dec_7f3a... hash=a8b2c1...

Log an exit (closing a position):

$ trading-boy journal log exit SOL \
  --trader MyTrader \
  --direction long \
  --price 162.30 \
  --size 500

Exit logged: id=dec_9c1f... hash=f4e3d2...

View your decision history:

$ trading-boy decisions --trader MyTrader

Decision History
──────────────────────────────────────────────────────────────────────
Date Token Type Dir Price Size Confidence
2026-03-09 SOL ENTRY LONG $148.50 500.00 0.75
2026-03-09 SOL EXIT LONG $162.30 500.00 —

6 Query token context

Pull the full context package for any Solana token. This is the same data your agent uses to make decisions.

$ trading-boy context SOL

SOL Context Package
──────────────────────────────────────────────────
Price: $148.32 | 24h: +2.3%
Funding: -0.028% | OI: $2.1B
Regime: ACCUMULATION
Signals: DISBELIEF_RALLY, CAPITULATION_BOTTOM
Risk Score: 24/100 (Low)

Other useful queries:

# Quick price and funding summary
$ trading-boy query SOL

# Upcoming catalysts and events
$ trading-boy catalysts

# DeFi protocol risk assessment
$ trading-boy risk marinade

# Live watch mode with auto-refresh
$ trading-boy watch SOL

7 Connect Telegram

Get daily summaries and trade notifications delivered to your Telegram. The bot verifies your identity using your API key.

# 1. Get your API key
$ trading-boy whoami --show-key

# 2. Open the bot in Telegram
Click: https://t.me/TradingBoy1_Bot

# 3. Start and paste your key
Send: /start
Then paste your tb_live_... key when prompted.

# 4. Done!
You'll receive daily summaries and trade alerts.

Daily summaries are sent at 08:00 UTC by default. Use Telegram commands like /summary, /context SOL, /entry, /exit, /stats, and /review for mobile-friendly trading.

8 Command reference

Full list of available commands. Run trading-boy --help for details on any command.

# Context & data
trading-boy context <token>       # Full context package
trading-boy query <token>        # Quick price/funding summary
trading-boy watch <token>        # Live watch mode
trading-boy catalysts           # Upcoming events
trading-boy risk <protocol>     # DeFi risk assessment
trading-boy narrative list       # Active narratives

# Trading journal
trading-boy journal log entry <token> # Log a trade entry
trading-boy journal log exit <token> # Log a trade exit
trading-boy journal review daily  # Daily performance review
trading-boy decisions           # View decision history
trading-boy behavioral          # Behavioral analysis
trading-boy audit verify         # Journal integrity check

# Edge & coaching
trading-boy edge <traderId>      # Edge ratio & efficiency
trading-boy edge-guard check     # Trade safety guardrails
trading-boy coaching pre-trade   # AI coaching (requires LLM key)
trading-boy thesis extract       # AI thesis extraction

# Strategy & agents
trading-boy strategy create      # Create a strategy
trading-boy agent create         # Create autonomous agent
trading-boy agent list           # List your agents
trading-boy agent exit <id>      # Close a position
trading-boy cron create          # Schedule a recurring job
trading-boy benchmark           # Performance leaderboard
trading-boy suggestions          # Strategy optimization

# Account & config
trading-boy subscribe           # Subscribe via Stripe
trading-boy login               # Store API key
trading-boy whoami --show-key    # Show full API key
trading-boy trader register      # Create trader profile
trading-boy trader soul-wizard   # Interactive identity wizard
trading-boy billing manage       # Manage subscription
trading-boy config show          # View configuration
trading-boy config set-llm-key   # Set LLM key (with model routing)
trading-boy infra status         # Check infrastructure health

Need help? Run trading-boy --help or trading-boy <command> --help for detailed usage on any command. Contact support.