bullpen polymarket¶
Last updated: February 26, 2026
Polymarket prediction market commands: discover, search, trade, and manage positions
Usage¶
Subcommands¶
| Subcommand | Description |
|---|---|
discover |
Discover prediction markets with various lenses and filters |
positions |
View prediction market positions and P&L |
activity |
View activity history (trades, redemptions, rewards, etc.) |
buy |
Buy shares on a prediction market outcome |
sell |
Sell shares on a prediction market outcome |
limit-buy |
Place a limit buy order on a prediction market outcome |
limit-sell |
Place a limit sell order on a prediction market outcome |
redeem |
Redeem resolved prediction market positions |
orders |
View open orders, trade history, or cancel orders |
search |
Search prediction markets and trader profiles |
watchlist |
Manage prediction market watchlist |
event |
View details for a specific prediction market event |
trades |
Show recent trades on a market |
price-history |
Show price history for a market outcome |
holders |
Show top position holders for a market |
comments |
View comments on markets, events, series, or users |
feed |
View filtered trade or comment feeds |
comment-alert |
Manage comment alert settings |
trade-alert |
Manage trade alert settings |
smart-alerts |
Manage smart alert preferences |
approve |
Check and set ERC-1155 token approvals for sell orders |
preflight |
Run pre-trade safety checks (server time, account status, balance, approvals) |
market |
Show detailed market information |
markets |
List and filter markets |
price |
Quick price check for a prediction market (midpoint, last trade, bid/ask, spread) |
deposit |
Get deposit addresses for your Polymarket wallet via the bridge |
withdraw |
Withdraw funds from Polymarket to an external address |
bridge |
Bridge utilities: supported assets and deposit transaction status |
tags |
List market tags/categories |
series |
List event series or show series detail |
split |
Split USDC into YES and NO tokens for a market |
merge |
Merge YES and NO tokens back into USDC |
condition-id |
Calculate a condition ID from oracle address, question ID, and outcome count |
collection-id |
Calculate a collection ID from condition ID and index set |
position-id |
Calculate a position ID from collateral token and collection ID |
watch |
Subscribe to real-time market data via WebSocket |
clob |
Direct CLOB API commands: prices, order book, balances, and order lookup |
data |
Query Polymarket data: leaderboards, profiles, smart money, open interest, and builder stats |
Live Help¶
Polymarket prediction market commands: discover, search, trade, and manage positions
Usage: bullpen polymarket [OPTIONS] <COMMAND>
Commands:
discover Discover prediction markets with various lenses and filters
positions View prediction market positions and P&L
activity View activity history (trades, redemptions, rewards, etc.)
buy Buy shares on a prediction market outcome
sell Sell shares on a prediction market outcome
limit-buy Place a limit buy order on a prediction market outcome
limit-sell Place a limit sell order on a prediction market outcome
redeem Redeem resolved prediction market positions
orders View open orders, trade history, or cancel orders
search Search prediction markets and trader profiles
watchlist Manage prediction market watchlist
event View details for a specific prediction market event
trades Show recent trades on a market
price-history Show price history for a market outcome
holders Show top position holders for a market
comments View comments on markets, events, series, or users
feed View filtered trade or comment feeds
comment-alert Manage comment alert settings
trade-alert Manage trade alert settings
smart-alerts Manage smart alert preferences
approve Check and set ERC-1155 token approvals for sell orders
preflight Run pre-trade safety checks (server time, account status, balance, approvals)
market Show detailed market information
markets List and filter markets
price Quick price check for a prediction market (midpoint, last trade, bid/ask, spread)
deposit Get deposit addresses for your Polymarket wallet via the bridge
withdraw Withdraw funds from Polymarket to an external address
bridge Bridge utilities: supported assets and deposit transaction status
tags List market tags/categories
series List event series or show series detail
split Split USDC into YES and NO tokens for a market
merge Merge YES and NO tokens back into USDC
condition-id Calculate a condition ID from oracle address, question ID, and outcome count
collection-id Calculate a collection ID from condition ID and index set
position-id Calculate a position ID from collateral token and collection ID
watch Subscribe to real-time market data via WebSocket
clob Direct CLOB API commands: prices, order book, balances, and order lookup
data Query Polymarket data: leaderboards, profiles, smart money, open interest, and builder stats
help Print this message or the help of the given subcommand(s)
Options:
--output <OUTPUT> [possible values: table, json]
--env <ENV> [possible values: staging, production]
--config <CONFIG>
-h, --help Print help
Example Commands¶
Example Data¶
Representative JSON shape for automation and integrations: