> For the complete documentation index, see [llms.txt](https://docs.bullpen.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bullpen.fi/bullpen-cli/markets-and-trading.md). # 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 # event overview + all outcomes bullpen polymarket price # real-time bid/ask/mid/spread bullpen polymarket price yes # price for one outcome only bullpen polymarket trades --limit 20 # recent trades bullpen polymarket holders --limit 10 # top holders bullpen polymarket price-history --outcome Yes # price chart bullpen polymarket comments # market comments bullpen polymarket market # detailed market info ``` Price history intervals: `1h`, `6h`, `1d` (default), `1w` ### Buy & Sell ``` bullpen polymarket buy --yes bullpen polymarket sell --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 --price 0.55 --shares 50 --yes bullpen polymarket limit-sell --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 # cancel one bullpen polymarket orders --cancel abc,def,ghi # cancel multiple bullpen polymarket orders --cancel-all --yes # cancel everything bullpen polymarket orders --cancel-market --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 # add a market bullpen polymarket watchlist --remove # remove ``` Stored locally at `~/.bullpen/watchlist.json`. ### Smart Money ``` bullpen polymarket data leaderboard --period week # top traders bullpen polymarket data profile
# trader stats bullpen polymarket data profile
--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
# follow on Polymarket bullpen tracker unfollow
bullpen tracker following # list followed wallets bullpen tracker trades # trades from followed wallets bullpen tracker add
--chain solana # track a wallet bullpen tracker remove
bullpen tracker list # list tracked wallets ``` Per-wallet notification filters: ``` bullpen tracker follow
--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 # deposit addresses bullpen polymarket withdraw --to --amount 100 --chain ethereum --yes bullpen polymarket bridge --supported # supported chains/tokens bullpen polymarket bridge --status # 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](https://cli.bullpen.fi/reference/) LLM docs bundle: [cli.bullpen.fi/llm.txt](https://cli.bullpen.fi/llm.txt) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.bullpen.fi/bullpen-cli/markets-and-trading.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.