Skip to content

Bullpen CLI

Alpha

Bullpen CLI is in Alpha. Commands, APIs, and behavior may change between releases. Report bugs at github.com/BullpenFi/bullpen-cli-releases/issues.

For private security reports, see Responsible Disclosure.

Trade prediction markets with AI agents — or from your terminal.

Bullpen CLI is a command-line tool for Polymarket prediction markets. Use it directly, or let AI agents (Claude Code, Codex CLI) trade, research, and manage your portfolio through natural language.

Use with AI Agents

Bullpen CLI ships with AI skills that teach Claude Code and Codex CLI how to trade prediction markets. After setup, just ask in natural language:

  • "Buy $10 of Yes on will-bitcoin-hit-100k"
  • "Show me trending prediction markets about crypto"
  • "Fill my March Madness bracket with chalk picks"
  • "What are my open positions and P&L?"
  • "Set up a limit order to sell my Trump shares at 65 cents"

Setup

Canonical setup order: install -> login -> status -> skill install -> restart your AI assistant. See the Quickstart Guide for the full setup flow.

# 1. Install the CLI
brew install BullpenFi/tap/bullpen

# 2. Log in
bullpen login

# 3. Verify your session
bullpen status

# 4. Install AI skills
bullpen skill install

# 5. Restart Claude Code / Codex CLI, then ask it anything

Already installed? Run bullpen upgrade to update to the latest version.

After installing skills and restarting your AI assistant, it has full access to discover markets, execute trades, manage positions, fill brackets, and automate workflows — all through conversation.

Quick Install

brew install BullpenFi/tap/bullpen

npm install -g @bullpenfi/cli

curl -fsSL https://cli.bullpen.fi/install.sh | sh

Download the latest binary from Releases.

Get Started in 30 Seconds

# 1. Log in
bullpen login

# 2. Check your balances across all chains
bullpen portfolio balances

# 3. Discover trending prediction markets
bullpen polymarket discover

# 4. Preview a buy (no execution, no money moved)
bullpen polymarket buy "will-btc-hit-150k" "Yes" 10 --preview

# When you're ready, drop --preview and add --yes:
# bullpen polymarket buy "will-btc-hit-150k" "Yes" 10 --yes

See the Quickstart Guide for full setup instructions.

Key Features

Prediction Markets Discover, search, and filter Polymarket events. View event details, real-time prices (bid/ask/mid/spread), price history, recent trades, top holders, and leaderboard rankings. Browse markets by tags and series.

Trading Buy and sell shares, place limit orders (GTC/GTD/FOK/FAK), redeem resolved positions, and manage open orders (including bulk cancel) -- all via the CLI.

Bridge & Funds Deposit funds via the Polymarket bridge. The CLI supports Polygon Deposit Wallet USDC.e withdrawals; use the Bullpen web app for other withdrawal routes.

Smart Money Signals Follow top traders and new wallets. Filter trade and comment feeds by PnL, volume, category, and more. Set up trade and comment alerts.

Portfolio & Wallet Tracking View balances and PnL across Solana, Hyperliquid (Spot + Perps), and Polymarket. Track external wallet addresses with nicknames.

Social & Community Read and filter market comments, view trader profiles, browse the leaderboard, and manage your watchlist.

Points & Rewards Check your Bullpen points, view distribution history, and claim rewards.

Interactive TUI Run bullpen with no arguments for a full-screen interactive terminal interface. Browse markets, manage positions, and execute trades without memorizing commands. See the TUI Guide for layout, key bindings, slash commands, and exit shortcuts.

AI Agent Skills Install skills that teach Claude Code and Codex CLI to trade on your behalf. Discover markets, place orders, manage positions, and fill brackets through natural language.

Scriptable Output

Most read commands support --output json for piping into scripts, dashboards, or other tools:

bullpen portfolio balances --output json | jq '.totals'
bullpen polymarket discover --output json

Some interactive and state-changing commands still print plain-text prompts/messages even when --output json is set. For strict automation, test the exact command path first.

Guides

Reference

  • Command Reference -- Per-command documentation generated from live CLI help (100+ command pages)
  • Sentinel Format -- How validated command-hint markers are stripped and how agents should handle leaks
  • Responsible Disclosure -- Private security-reporting policy
  • LLM Bundle -- Single-file concatenation of public docs for LLM ingestion (auto-generated)

Configuration

Config lives at ~/.bullpen/config.toml (or $BULLPEN_HOME/config.toml).

bullpen config init