Bullpen CLI Quickstart¶

Bullpen CLI lets you authenticate, view portfolio balances, discover prediction markets, and trade from the terminal.

System Requirements¶

Requirement	Details
Operating systems	macOS 12+, Ubuntu 20.04+/Debian 10+, or Windows 11 via WSL2

Install¶

Homebrew (macOS / Linux)¶

brew install BullpenFi/tap/bullpen

npm¶

npm install -g @bullpenfi/cli

Shell Script¶

curl -fsSL https://bullpenfi.github.io/bullpen-cli/install.sh | sh

Manual Download¶

Download the latest binary from Releases.

If bullpen is not found after install, ensure the install location is on your PATH.

Getting Started¶

Login (Google OAuth):
```
bullpen auth login
```
Open the printed URL in your browser.
After Google login, copy the full redirect URL (it contains oauthLoginResponse).
Paste the URL into the CLI prompt.
Check your balances:
```
bullpen portfolio balances
```

Optional: X OAuth

bullpen auth login --method x

Expected output (example):

Total USD (All): 1234.56

[Solana] Address: ...  Chain: Solana (0)
Total USD: 345.67
Symbol          Balance        Value USD
SOL            1.2345            123.45
USDC          10.0000            10.00

[Hyperliquid Spot] Address: ...  Chain: HyperCore Spot (6)
Total USD: 456.78
Symbol          Balance        Value USD
USDC          100.0000          100.00

[Polymarket] Address: ...  Chain: Polygon (10)
Total USD: 432.11
Symbol          Balance        Value USD
USDC.e         432.1100         432.11

Paste Tips¶

If pasting the redirect URL hangs, use one of:

bullpen auth login --oauth-login-response-clipboard
bullpen auth login --oauth-login-response-file /path/to/response.txt
cat /path/to/response.txt | bullpen auth login --oauth-login-response-stdin

Email OTP (Legacy)¶

bullpen auth request-otp --identifier you@example.com
bullpen auth login --method email --identifier you@example.com --otp 123456

What Balances Are Included¶

The CLI fetches balances via usergate for: - Solana - Hyperliquid (HyperCore Spot + Perps) - Polymarket (via Polygon proxy)

Configuration¶

Config lives at ~/.bullpen/config.toml (or $BULLPEN_HOME/config.toml). To generate a default config:

bullpen config init

To force a different environment:

bullpen --env staging portfolio balances

Update notifications: The CLI automatically checks for updates in the background and prints a notice to stderr when a newer version is available. This check is non-blocking and does not slow down commands. To disable, add check_for_updates = false to your config.toml.

Logging¶

Set RUST_LOG to enable log output:

RUST_LOG=info bullpen auth status

Uninstall¶

Remove the binary using the same method you used to install:

HomebrewnpmShell Script / Manual

brew uninstall bullpen

npm uninstall -g @bullpenfi/cli

rm "$(which bullpen)"

Then clean up configuration and credentials:

rm -rf ~/.bullpen

Next Steps¶

Prediction Markets — discover, search, and analyze markets (event details, price history, trades, holders, leaderboard, smart money, social & community)
Trading — buy, sell, redeem shares, and place limit orders
Orders and Watchlist — manage orders and watchlist
CLI Reference — complete flag-by-flag reference for all commands

Other useful commands:

bullpen portfolio pnl                                          # view profit & loss
bullpen points                                                 # view your points
bullpen rewards                                                # view and claim rewards
bullpen notifications                                          # view notifications
bullpen wallet track <addr> --chain solana                     # track a wallet
bullpen wallet tracked                                         # list tracked wallets
bullpen prediction polymarket comments <slug>                  # view market comments
bullpen prediction polymarket feed trades --min-pnl 10000      # filtered trade feed
bullpen prediction polymarket track --list                     # list tracked addresses