Introduction: Live Demo Walkthrough¶
A step-by-step guide for demoing the Bullpen CLI on a fresh macOS machine. Every command is pre-filled and ready to copy-paste. Example output is shown below each command.
1. Install¶
Verify:
2. First-Time Setup¶
Run the guided wizard — it initializes config, opens login, and checks Polymarket approvals in one flow:
Or do it manually:
A code and URL are displayed. Open the URL in your browser, enter the code, and login completes automatically.
Confirm you're logged in:
Logged in.
Token store: file
Access token: present
JWT expires: 2026-02-27 17:40:15 UTC
Refresh token: present
Session expires: 2026-03-07 17:57:24 UTC
Turnkey bundle: present (decryptable)
Turnkey org: present
3. Install AI Agent Skills (Optional)¶
Install skills so Claude Code or Codex CLI can trade on your behalf through natural language:
Installed 34 skill files to 1 location(s):
[Claude Code (personal)] /Users/you/.claude/skills/bullpen-cli
After installing, restart Claude Code or Codex CLI. Then just ask:
- "Buy $10 of Yes on will-bitcoin-hit-100k"
- "Show me trending crypto prediction markets"
- "What are my open positions?"
4. Check Your Account¶
Bullpen CLI vX.Y.Z
Environment: production
Credentials: file (~/.bullpen/credentials.json.enc)
Update: up to date
Account
Status: Logged in
Address: 0x31Ea...B40e
JWT expires: 2026-02-27 17:40:15 UTC
Session expires: 2026-03-07 17:57:24 UTC
Polymarket
Status: UP
Incidents: none
Maintenances: none
╭──────────────────────────────────╮
│ Total Portfolio Value +$337.30 │
│ $372.72 │
├──────────────────────────────────┤
│ Solana -$15.66 │
│ $19.75 │
├──────────────────────────────────┤
│ Hyperliquid $0.00 │
│ $0.00 │
├──────────────────────────────────┤
│ Polymarket +$352.96 │
│ $352.96 │
╰──────────────────────────────────╯
5. Discover Markets¶
Browse trending markets:
Market Odds Vol 24h Liquidity Ends
-----------------------------------------------------------------------------------------------------
US strikes Iran by February 28, 2026? Yes 14¢ / No 86¢ $9.6M $664.1K Jan 14
... and 62 more markets
Will Elon Musk post 80-99 tweets from Feb... Yes 0¢ / No 100¢ $7.6M $62.4K Mar 03
... and 27 more markets
Will the Fed decrease interest rates by 50+... Yes 0¢ / No 100¢ $7.0M $6.0M Mar 18
... and 3 more markets
Will LeBron James win the 2025–2026 NBA MVP? Yes 0¢ / No 100¢ $3.6M $143.3K Jun 10
... and 30 more markets
Will Richard Grenell be the leader of Venez... Yes 0¢ / No 100¢ $5.0M $143.4K Dec 31
... and 54 more markets
Filter by category:
Market Odds Vol 24h Liquidity Ends
-----------------------------------------------------------------------------------------------------
Will the price of Bitcoin be above $70,000... Yes 0¢ / No 100¢ $846.8K $478.2K Feb 27
... and 8 more markets
Will Bitcoin reach $75,000 in February? Yes 0¢ / No 100¢ $807.0K $128.0K Mar 01
... and 20 more markets
Will the price of Ethereum be above $1,700... Yes 100¢ / No 0¢ $212.9K $403.3K Feb 27
... and 8 more markets
Search for a specific topic:
Markets (10 results)
Market Odds Vol 24h Liquidity
-----------------------------------------------------------------------------------------
Will the price of Bitcoin be above $58,000... Yes 100¢ / No 0¢ $4.5M $4.9M
Will the price of Bitcoin be above $60,000... Yes 100¢ / No 0¢ $4.5M $4.9M
Will the price of Bitcoin be above $64,000... Yes 100¢ / No 0¢ $4.5M $4.9M
Will the price of Bitcoin be above $66,000... Yes 0¢ / No 100¢ $4.5M $4.9M
Will Bitcoin reach $150,000 in February? Yes 0¢ / No 100¢ $3.1M $7.0M
Will Bitcoin dip to $55,000 in February? Yes 1¢ / No 99¢ $3.1M $7.0M
...
6. Research a Market¶
Pick a slug from discover/search results and drill in. We'll use the Fed March rate decision:
Fed decision in March?
======================
The FED interest rates are defined in this market by the upper bound of the
target federal funds range...
Status: Active | Volume: $181.6M | 24h Vol: $7.0M | Liquidity: $6.0M
Tags: Economy, Fed Rates, Jerome Powell, Economic Policy, Politics, Fed
Markets (4)
Question Outcomes Volume Spread
-------------------------------------------------------------------------------------
Will the Fed decrease interest rates by 50… Yes 0¢ / No 100¢ $74.4M 0.1¢
Will the Fed decrease interest rates by 25… Yes 2¢ / No 98¢ $21.8M 0.2¢
Will there be no change in Fed interest ra… Yes 97¢ / No 3¢ $21.5M 0.1¢
Will the Fed increase interest rates by 25… Yes 0¢ / No 100¢ $63.8M 0.1¢
Check the current price:
bullpen polymarket price will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting
Will the Fed decrease interest rates by 25 bps after the March 2026 meeting?
─────────────────────────────────────────────────────────────────────────────
Outcome Mid Last Bid Ask Spread
────────────────────────────────────────────────────────
Yes 1.7¢ 1.6¢ 1.6¢ 1.8¢ 0.2¢
No 98.3¢ 98.2¢ 98.2¢ 98.4¢ 0.2¢
Tick size: 0.0010
Fee: 0 bps
See recent trades:
bullpen polymarket trades will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting
Time Side Outcome Price Shares USD
------------------------------------------------------------------------
2026-02-27T18:44:03 Sell No 98¢ 1.39 1.36
2026-02-27T18:43:47 Buy No 98¢ 1.39 1.37
2026-02-27T18:41:03 Sell No 98¢ 1.30 1.28
2026-02-27T18:40:59 Buy Yes 2¢ 425.56 7.66
2026-02-27T18:30:09 Buy No 98¢ 120.80 118.87
2026-02-27T18:25:13 Buy Yes 2¢ 55.56 1.00
...
See who holds positions:
bullpen polymarket holders will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting
# Address/User Shares USD Value
----------------------------------------------------------------------
1 Vitalbrother 687244.53 -
2 blurp5185188 399242.74 -
3 scratattack 330075.28 -
4 Economancy 265646.61 -
5 risk-manager 251068.70 -
6 surf 199999.47 -
7 gloriafoster 179999.32 -
8 Cacctus 168650.98 -
9 Magamyman 120000.00 -
10 debased 115590.41 -
7. Place a Trade¶
Preview first (no execution):
bullpen polymarket buy will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting Yes 5 --preview
Order Preview
───────────────────────────────────
Action: Buy Yes
Market: Will the Fed decrease interest rates by 25 bps after the March 2026 meeting?
Amount: $5.00
Price: 1.7¢
Est. Shares: 294.11
Potential: $294.11
Trading Fee: $0.01
Network Fee: ~$0.01
Total Cost: $5.02
Spread: 99.8¢
───────────────────────────────────
Execute:
bullpen polymarket buy will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting Yes 5 --yes
Place a limit order:
bullpen polymarket limit-buy --price 0.01 --shares 100 will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting Yes --yes
8. Manage Positions & Orders¶
View your positions:
Portfolio Value: $89.80 | Cash: $0.00 | Unrealized P&L: +$4.37
Market Outcome Shares Avg Price Value P&L P&L %
------------------------------------------------------------------------------------------------------
Will the New York Knicks win the NBA … Yes 36.0 14¢ 14¢ 5.22 +$0.17 3.5%
Will the Denver Nuggets win the NBA W… Yes 33.0 15¢ 16¢ 5.11 +$0.16 3.3%
US recession by end of 2026? Yes 28.9 23¢ 22¢ 6.21 -$0.56 -8.2%
Will the Oklahoma City Thunder win th… Yes 18.8 36¢ 36¢ 6.70 -$0.04 -0.6%
Will Solana dip to $60 in February? No 13.5 75¢ 99¢ 13.47 +$3.32 32.7%
Will Bitcoin dip to $55,000 in Februa… No 13.5 74¢ 99¢ 13.41 +$3.42 34.2%
S&P 500 all time high by March 31, 20… Yes 8.3 60¢ 55¢ 4.58 -$0.41 -8.3%
Will Jesus Christ return before GTA V… Yes 5.0 48¢ 48¢ 2.42 +$0.02 1.0%
...
View open orders:
Market ID Outcome Side Price Size Filled Type
--------------------------------------------------------------------------------------------------
Will Kon Knueppel win the… 0x93fb842… Yes BUY 8¢ 5.00 0.00 GTC
...
View trade history:
Activity (showing 5)
Time Type Market Side Amount USDC
──────────────────────────────────────────────────────────────────────────────────────
2026-02-27T18:34:09 TRADE Will the Denver Nuggets win the… BUY 10.0 $1.50
2026-02-27T17:14:07 TRADE Will the Denver Nuggets win the… BUY 13.0 $1.95
2026-02-27T16:31:03 TRADE Will the Denver Nuggets win the… BUY 10.0 $1.50
2026-02-27T14:35:23 TRADE Will the New York Knicks win th… BUY 16.6 $2.32
2026-02-27T14:35:23 TRADE Will the Detroit Pistons win th… BUY 0.6 $0.14
9. Leaderboard & Trader Intelligence¶
View the weekly leaderboard:
# Username Address Volume P&L Win Rate Trades
-----------------------------------------------------------------------------------------------
1 gmanas 0xe90b...5da2 $22.9M +$1.7M - -
2 lfc123 0xb904...c255 $4.8M +$749.2K - -
3 joosangyoo 0x07b8...8e25 $8.4M +$540.3K - -
4 0x1979ae6B7E6534dE9c4539D0c20… 0x1979...7c9d $31.5M +$459.4K - -
5 gopatriots 0xe20a...e469 $4.5M +$415.5K - -
6 predictorxyz 0x1d9a...426d $540.3K +$410.4K - -
7 0x6a57D263cD7c8EbA88b857eDEB7… 0x6a57...2afa $1.7M +$392.0K - -
8 kch123 0x6a72...33ee $1.6M +$389.1K - -
9 GamblingIsAllYouNeed 0x507e...beae $11.6M +$354.8K - -
10 0x054eC2F0cCfdaE941886a3eD306… 0x054e...6639 $1.7M +$354.2K - -
View the daily leaderboard:
# Username Address Volume P&L Win Rate Trades
-----------------------------------------------------------------------------------------------
1 weflyhigh 0x03e8...1697 $430.4K +$400.4K - -
2 Countryside 0xbddf...c684 $610.9K +$346.1K - -
3 kch123 0x6a72...33ee $352.4K +$167.6K - -
4 joosangyoo 0x07b8...8e25 $772.8K +$150.0K - -
5 0x24357454d8d1a0cc93a6c25fd49… 0x6e82...752c $135.6K +$127.8K - -
10. Trade Feed¶
Watch the live trade feed filtered to large trades:
Filtered Trades (10 total, page 1)
Market Side Price Size Trader PnL Tracked
--------------------------------------------------------------------------------
Will Leverkusen win the 202… SELL 1¢ $591 -$314 -
US strikes Iran by February… BUY 4¢ $2.6K $0 -
Will Wolverhampton Wanderer… BUY 80¢ $798 $760 -
Ethereum Up or Down - Febru… SELL 7¢ $643 -$109 -
RC Strasbourg Alsace vs. Ra… BUY 68¢ $2.0K $4.3M -
Bitcoin Up or Down - Februa… BUY 59¢ $508 -$6.2K -
Will Elon Musk post 60-79 t… BUY 0¢ $8.1K -$65 -
11. Watchlist¶
Add a market to your watchlist:
bullpen polymarket watchlist --add will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting
View your watchlist:
12. JSON Output & Scripting¶
Most data and automation commands support --output json for programmatic use.
Raw output commands such as bullpen completion, interactive commands such as
bullpen shell, and unsupported streaming previews reject JSON mode. Check the
per-command reference page before wiring a command into automation.
bullpen polymarket positions --output json | jq '.positions[:3] | .[] | {market: .title, outcome, pnl, pnl_pct}'
13. Interactive Shell¶
Launch the REPL — runs commands without the bullpen prefix:
Inside the shell:
bullpen> polymarket discover --limit 5
bullpen> polymarket price will-the-fed-decrease-interest-rates-by-25-bps-after-the-march-2026-meeting
bullpen> portfolio overview
bullpen> exit
For the full-screen terminal UI, run bullpen with no arguments. See the TUI Guide for layout, key bindings, slash commands, and exit shortcuts.
14. Upgrade¶
Very old installs may be prompted to re-login once (bullpen logout --force && bullpen login). After that, all future upgrades preserve the session.
Release Notes¶
For the most recent release notes, see the CHANGELOG. Run bullpen --version to see your installed version, and bullpen upgrade to update.
Demo Tips¶
--previewon trading commands shows what would happen without executing — great for demos.--output json | jq .on JSON-capable commands to show structured data.bullpen shellfeels like a native trading terminal — impressive for live demos.bullpenopens the full-screen TUI when you want scrollback, autocomplete, and the operator panel; see the TUI Guide.- Tab completion:
bullpen completion zsh >> ~/.zshrc && source ~/.zshrc. - The Fed March rate market (
fed-decision-in-march-885) is a good demo market — high volume, multiple outcomes, active trading. - If a market slug expires or resolves, swap in any slug from
bullpen polymarket discover.