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

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.2.9

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 provisioned and saved.

Available plans: starter (free), pro ($29/mo), edge ($99/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 entry SOL \
  --trader MyTrader \
  --direction long \
  --size 500 \
  --thesis "Funding negative, whale accumulation, support holding"

Entry logged at live price $148.32
id=dec_7f3a... hash=a8b2c1...

Log an exit (closing a position):

$ trading-boy journal exit SOL \
  --trader MyTrader

Exit logged at live price $162.30 | PnL: +9.4%
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 supported token — 100+ Solana SPL tokens and 229 Hyperliquid perpetuals. 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: 2 active (bullish confluence)
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. Open the bot in Telegram
New bot handle coming soon — will match the Cabal Ventures brand.

# 2. Start the bot
Send: /start

# 3. Verify with your API key
Send: /verify tb_live_your_api_key_here

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

Daily summaries are sent at your configured time (default: 08:00 UTC). Change it with trading-boy config set summaryTime 09:00.

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 social              # Social signals
trading-boy narrative list       # Active narratives

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

# Account
trading-boy subscribe           # Subscribe via Stripe
trading-boy login               # Store API key
trading-boy trader register      # Create trader profile
trading-boy trader show <name>   # View trader profile
trading-boy trader list          # List all traders
trading-boy billing manage       # Manage subscription
trading-boy config              # View/set preferences

Need help? Run trading-boy --help or trading-boy <command> --help for detailed usage on any command. Contact us at support@cabal.ventures.