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 8 skill files to /Users/you/.claude/skills/bullpen-cli
Installed 2 skill files to /Users/you/.claude/skills/bullpen-bracket
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 v0.1.19
Environment: production
Credentials: file (~/.bullpen/credentials.json)
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¶
Every command supports --output json for programmatic use:
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
14. Upgrade¶
Demo Tips¶
--previewon trading commands shows what would happen without executing — great for demos.--output json | jq .on any command to show structured data.bullpen shellfeels like a native trading terminal — impressive for live demos.- 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.