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.

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 (4 steps)

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

# 2. Install AI skills
bullpen skill install

# 3. Log in
bullpen login

# 4. 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. Buy shares on a market outcome
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 and withdraw funds via the Polymarket bridge. Check supported chains/tokens and track deposit status.

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.

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)
  • 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