@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 you@email.com

# 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

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