Markets & Trading

How to find markets, research them, and trade from the CLI.

Find Markets

bullpen polymarket discover                              # trending markets
bullpen polymarket discover crypto --limit 10            # crypto markets
bullpen polymarket discover sports                       # sports markets
bullpen polymarket discover traders --limit 10           # top traders by P&L
bullpen polymarket discover walletscope --address 0x...  # what a wallet holds
bullpen polymarket discover flow --address 0x...         # wallet's recent trades
bullpen polymarket search "bitcoin"                      # search by keyword
bullpen polymarket markets --active --sort volume        # browse all active markets

Sort options for discover: volume, volume24h, liquidity, newest, ending-soon

Filter options: --min-liquidity, --min-volume, --min-odds, --status, --category

Research a Market

bullpen polymarket event <slug>                          # event overview + all outcomes
bullpen polymarket price <slug>                          # real-time bid/ask/mid/spread
bullpen polymarket price <slug> yes                      # price for one outcome only
bullpen polymarket trades <slug> --limit 20              # recent trades
bullpen polymarket holders <slug> --limit 10             # top holders
bullpen polymarket price-history <slug> --outcome Yes    # price chart
bullpen polymarket comments <slug>                       # market comments
bullpen polymarket market <slug>                         # detailed market info

Price history intervals: 1h, 6h, 1d (default), 1w

Buy & Sell

bullpen polymarket buy <slug> <outcome> <amount_usd> --yes
bullpen polymarket sell <slug> <outcome> <shares> --yes

--preview shows what would happen without executing. --yes skips the confirmation prompt. Without --yes, you type y to confirm.

Outcomes accept: Yes, No, Y, N, True, False, 1, 0, or the full outcome text for multi-outcome markets.

Market slugs (e.g. will-btc-reach-100k) and full Polymarket URLs both work.

Limit Orders

bullpen polymarket limit-buy <slug> <outcome> --price 0.55 --shares 50 --yes
bullpen polymarket limit-sell <slug> <outcome> --price 0.70 --shares 15 --yes

Flag	Description
--price	Price between 0.01 and 0.99
--shares	Number of shares
--expiration	gtc (default), gtd, fok, fak
--post-only	Reject if order would fill immediately

Positions

bullpen polymarket positions                             # active positions with P&L
bullpen polymarket positions --address 0x...             # another wallet's positions
bullpen polymarket positions --closed                    # closed positions
bullpen polymarket positions --redeemable                # resolved, ready to collect

Orders

bullpen polymarket orders                                # open orders
bullpen polymarket orders --history                      # trade history
bullpen polymarket orders --cancel <id>                  # cancel one
bullpen polymarket orders --cancel abc,def,ghi           # cancel multiple
bullpen polymarket orders --cancel-all --yes             # cancel everything
bullpen polymarket orders --cancel-market <id> --yes     # cancel all on one market

Redeem Winnings

Collect payouts from resolved markets. All redemptions are gasless.

bullpen polymarket redeem --condition-ids id1,id2,id3 --yes

Works with both standard binary and neg-risk markets.

Portfolio

bullpen portfolio overview                               # total value + P&L by chain
bullpen portfolio balances                               # full breakdown
bullpen portfolio pnl                                    # detailed profit & loss

Covers Solana, Hyperliquid (Spot + Perps), and Polymarket (Polygon).

Activity Feed

Full history of trades, redemptions, rewards, and more:

bullpen polymarket activity                              # recent activity
bullpen polymarket activity --type trade                 # trades only
bullpen polymarket activity --type trade,redeem,reward   # multiple types
bullpen polymarket activity --side buy --start 2026-02-01 --end 2026-02-28
bullpen polymarket activity --sort cash --limit 20

Watchlist

bullpen polymarket watchlist                             # view
bullpen polymarket watchlist --add <slug>                # add a market
bullpen polymarket watchlist --remove <slug>             # remove

Stored locally at ~/.bullpen/watchlist.json.

Smart Money

bullpen polymarket data leaderboard --period week        # top traders
bullpen polymarket data profile <address>                # trader stats
bullpen polymarket data profile <address> --trades       # stats + recent trades
bullpen polymarket data smart-money                      # smart money signals
bullpen polymarket data smart-money --type top_traders --category crypto
bullpen polymarket data smart-money --type new_wallet

Trade & Comment Feeds

Filtered streams of activity across all markets:

bullpen polymarket feed trades --min-pnl 10000 --min-trade-size 500
bullpen polymarket feed trades --action Buy --category crypto
bullpen polymarket feed comments --min-volume 100000 --category politics
bullpen polymarket feed comments --following-only

Filters for both: --min-pnl, --min-volume, --min-predictions, --min-position-value, --category, --exclude-categories

Trade-only: --action, --min-trade-size, --min-price, --max-price

Comment-only: --following-only

Alerts

bullpen polymarket smart-alerts --set --smart-money true --categories crypto
bullpen polymarket trade-alert --set --min-pnl 10000 --action Buy
bullpen polymarket comment-alert --set --min-pnl 5000 --following-only

View current settings by running the command with no flags. Delete with --delete.

Wallet Tracking

bullpen tracker follow <address>                         # follow on Polymarket
bullpen tracker unfollow <address>
bullpen tracker following                                # list followed wallets
bullpen tracker trades                                   # trades from followed wallets
bullpen tracker add <address> --chain solana              # track a wallet
bullpen tracker remove <address>
bullpen tracker list                                     # list tracked wallets

Per-wallet notification filters:

bullpen tracker follow <address> --update-filters --notify-trades true --trade-threshold 500

Filter options: --notify-trades, --notify-comments, --trade-threshold, --markets, --category, --action

Deposit & Withdraw

bullpen polymarket deposit --address <your_wallet>       # deposit addresses
bullpen polymarket withdraw --to <addr> --amount 100 --chain ethereum --yes
bullpen polymarket bridge --supported                    # supported chains/tokens
bullpen polymarket bridge --status <addr>                # check deposit status

Points & Rewards

bullpen points                                           # your points total
bullpen rewards                                          # view and claim rewards
bullpen notifications                                    # view notifications

Before Your First Trade

Polymarket requires one-time ERC-1155 and USDC approvals on Polygon (gasless):

bullpen polymarket approve --check                       # check status
bullpen polymarket approve --yes                         # set approvals
bullpen polymarket preflight                             # full pre-trade check

bullpen setup handles approvals automatically. These commands are only needed if you skipped setup.

Tips

• --output json works on any read command for scripting
• --preview on any trade shows what would happen without executing
• bullpen shell launches a REPL so you skip typing bullpen every time
• bullpen with no args opens the interactive TUI
• Prices are 0.01-0.99 (cents per share / probability)

Full Reference

Per-command documentation for all 100+ commands: cli.bullpen.fi/reference

LLM docs bundle: cli.bullpen.fi/llm.txt