Getting Started
Go from zero to your first Trading Boy workflow in minutes. Claim a starter key, install the CLI, register your trader profile, and start pulling market context and decision data through the hosted API.
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
2.1.0
2 Claim a starter key
Open the starter signup page, enter your email, and copy the API key when it appears. Trading Boy only shows the plaintext key once.
$ open https://cabal.ventures/signup/traders
API Key: tb_live_abc123...
⚠️ Copy this key now — it will not be shown again.
Then store it locally with trading-boy login.
Current public plans: Starter ($0/mo), Pro ($29/mo), and Operator ($99/mo). See the pricing page for the current offer.
Already signed up? Use the key you saved earlier, or run trading-boy forgot-key -e you@example.com after installing the CLI.
3 Log in
Store your Trading Boy API key locally. 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 through the hosted API. No database credentials are 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%
Public Board: private
Trader registered successfully.
Public leaderboard visibility is private by default. Opt in later with trading-boy trader leaderboard opt-in <name> <alias>.
Optionally link a Solana wallet:
$ trading-boy trader link-wallet MyTrader YOUR_WALLET_ADDRESS
5 Log your first trade
The journal captures your decisions alongside market context at that moment. You can use the CLI for quick review, or pull the underlying data through the API for your own workflows.
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:
$ trading-boy query SOL
$ trading-boy catalysts
$ trading-boy risk marinade
$ 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.
$ trading-boy whoami --show-key
Click: https://t.me/TradingBoy1_Bot
Send: /start
Then paste your tb_live_... key when prompted.
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.
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-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
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
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 suggestions
trading-boy login
# Store API key
trading-boy whoami --show-key
# Show full API key
trading-boy forgot-key -e email
# Recover an existing key
trading-boy trader register
# Create trader profile
trading-boy trader leaderboard opt-in <name> <alias>
# Make a trader public
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.