@trading-boy/cli

Remote trading intelligence for traders and AI agents. Real-time market data, on-chain analytics, DeFi risk scoring, and adaptive learning outcomes — all from the command line.

Website: cabal.ventures | Docs: cabal.ventures/docs

Install

npm install -g @trading-boy/cli

Requires Node.js 20+.

Quick Start

# 1. Subscribe (Starter is free; paid plans open checkout)
trading-boy subscribe --plan starter -e [email protected]

# 2. Onboarding stores your Trading Boy API key locally.
# Power agents with ChatGPT or your own LLM provider API key:
trading-boy connect-chatgpt
# or
trading-boy config set-llm-key <your-llm-provider-api-key>

# 3. Create your first agent
trading-boy agent create --trader-id <id> --scan-interval-human 30m

# 4. Query a token
trading-boy context SOL

# 5. Log a trade
trading-boy journal log entry SOL --direction LONG --price 148.50 --size 500

What You Get

• Real-time prices for 100+ Solana SPL tokens and 229 Hyperliquid perpetuals
• Funding rates & open interest from Binance perp markets
• On-chain analytics — whale transactions, exchange flows, smart money tracking
• DeFi risk scoring — protocol dependency trees, contagion risk, concentration analysis
• Trading journal — context-linked decisions with outcome tracking and confidence calibration
• Behavioral guardrails — bias detection, overtrading alerts, pattern analysis
• Adaptive learning — signals improve based on your personal trading outcomes
• Edge analytics — win rate, best/worst setups, confidence calibration scores
• Agent integration — MCP server for Claude, GPT, and other AI agents

Commands

Core
  trading-boy context <token>       # Full 6-layer context package
  trading-boy query <token>         # Quick price + funding summary
  trading-boy watch <token>         # Live watch mode

Data & Analysis
  trading-boy catalysts             # Upcoming events
  trading-boy risk <protocol>       # DeFi risk assessment
  trading-boy narrative list        # Active market narratives
  trading-boy events list           # Event management

Trading Journal
  trading-boy journal log entry <token>  # Log a trade entry
  trading-boy journal log exit <token>   # Log a trade exit
  trading-boy decisions             # View decision history
  trading-boy stats                 # Aggregate trading statistics

Edge & Safety
  trading-boy edge <traderId>       # Edge profile analytics
  trading-boy edge-guard check <id> # Negative edge detection
  trading-boy behavioral            # Behavioral pattern analysis
  trading-boy coaching pre-trade    # AI-powered trade coaching
  trading-boy thesis <id>           # Thesis extraction (LLM)

Strategy & Benchmarking
  trading-boy strategy list         # Manage agent strategies
  trading-boy replay                # Backtest strategies
  trading-boy benchmark             # Performance leaderboard
  trading-boy suggestions list      # Optimization suggestions

Account
  trading-boy subscribe             # Subscribe via Stripe
  trading-boy login                 # Store your Trading Boy API key
  trading-boy connect-chatgpt       # Connect ChatGPT after Trading Boy login
  trading-boy whoami                # Check auth status + key expiration
  trading-boy rotate-key            # Rotate your Trading Boy API key
  trading-boy forgot-key            # Recover key via email
  trading-boy billing manage        # Manage subscription

System
  trading-boy trader register       # Create trader profile
  trading-boy config show           # View API + LLM configuration
  trading-boy config set-llm-key    # Store your LLM provider API key
  trading-boy cron list             # Manage scheduled jobs
  trading-boy agent create          # Create a hosted trading agent
  trading-boy agent list            # Manage agents

Run trading-boy --help for the full command list.

Public Package Scope

The published npm package is a public, remote-only CLI. End users can manage API/LLM settings and runtime model selection, but internal infrastructure management and server environment editing are intentionally not part of the npm release surface.

Pricing

| Plan | Price | Tokens | Trades/mo | |------|-------|--------|-----------| | Starter | Free | 5 | 50 | | Pro | $29/mo | 25 | 500 | | Edge | $99/mo | 100 | Unlimited |

All plans include every feature. Limits apply to traded tokens and logged trades only — queries are unlimited.

API & Agent Integration

Trading Boy exposes an MCP server for AI agent integration and a REST API for programmatic access.

# REST API is hosted at https://api.cabal.ventures
# MCP server: npx @trading-boy/mcp-server
# CLI onboarding and first-agent setup: see docs/getting-started.md

License

MIT