bullpen polymarket¶
Last updated: May 29, 2026
Polymarket prediction market commands: discover, search, trade, and manage positions
Usage¶
Subcommands¶
| Subcommand | Description |
|---|---|
status |
Show Polymarket platform status and per-component health (read-only) |
discover |
Discover prediction markets with various lenses and filters |
positions |
View prediction market positions and P&L |
wallet-stats |
Show server-derived wallet statistics, including risk and insider signals |
activity |
View activity history (trades, redemptions, rewards, etc.) [aliases: history] |
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 |
poll-order |
Poll an order until it fills, cancels, or times out |
search |
Search prediction markets and trader profiles |
event |
View details for a specific prediction market event |
event-top-holders |
Show top holders aggregated across all markets in an event |
events |
List and filter prediction market events |
trades |
Show recent trades on a market |
price-history |
Show price history for a market outcome |
candles |
Show OHLC candlestick chart for a market outcome |
orderbook |
Show the live orderbook (bids and asks) for a market outcome |
preview |
Preview a trade: estimated fill price, fees, slippage, and total cost without executing |
holders |
Show top position holders for a market |
comments |
View comments on markets, events, series, or users |
feed |
View filtered trade or comment feeds (requires login) |
approve |
Check and set ERC-1155 token approvals for sell orders |
activate |
Activate the currently-selected Polymarket wallet for trading |
revoke |
Revoke all Polymarket trading approvals (ERC-1155 + pUSD) |
deploy-deposit-wallet |
Deploy and activate your Polymarket deposit wallet |
reregister-deposit-wallet |
Re-register an already-deployed deposit wallet with the Bullpen server |
wallet |
Check Polymarket wallet routing and balances for every owner EOA |
wallet-audit |
Detect split-brain / assets-in-both state across all owner EOAs |
consolidate |
Consolidate stranded assets to your server-selected Polymarket wallet |
migrate |
Move pUSD between your legacy Safe and Deposit Wallet |
migrate-collateral |
Migrate stranded pUSD from your Safe wallet to your deposit wallet |
preflight |
Run pre-trade safety checks (server time, account status, balance, approvals) |
doctor |
Run diagnostic checks for trading readiness |
market |
Show detailed market information |
markets |
List and filter markets |
price |
Quick price check for a prediction market (midpoint, last trade, bid/ask, spread) |
withdraw |
Withdraw USDC.e from a Deposit Wallet on Polygon; other withdrawals use the web app |
wrap |
Wrap USDC into pUSD (Polymarket collateral token) |
unwrap |
Unwrap pUSD back to USDC |
sweep-stranded |
Move a stranded ERC-20 token out of your Safe wallet via a gasless relayer transaction |
sweep-native-pol |
Move native POL accidentally sent to a Deposit Wallet via the gasless relayer |
sweep-signer-eoa |
Sweep USDC held directly on a signer EOA into your active Polymarket wallet |
bridge |
Bridge utilities: check deposit transaction status |
tags |
List market tags/categories |
categories |
Browse market categories with stats from top markets (market count, volume, examples) |
series |
List event series or show series detail |
teams |
List sports teams |
sports-list |
List all supported sports categories |
sports-market-types |
List valid sports market types |
split |
Split USDC into YES and NO tokens for a market |
merge |
Merge YES and NO tokens back into USDC |
redeem-neg-risk |
Redeem neg-risk positions using the NegRiskAdapter |
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 |
rewards |
View your Polymarket reward earnings and active reward programs |
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 |
bracket |
Bracket contest commands: March Madness picks, leaderboard, and results |
Live Help¶
Polymarket prediction market commands: discover, search, trade, and manage positions
Usage: bullpen polymarket [OPTIONS] <COMMAND>
Commands:
status Show Polymarket platform status and per-component health (read-only)
discover Discover prediction markets with various lenses and filters
positions View prediction market positions and P&L
wallet-stats Show server-derived wallet statistics, including risk and insider signals
activity View activity history (trades, redemptions, rewards, etc.) [aliases: history]
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
poll-order Poll an order until it fills, cancels, or times out
search Search prediction markets and trader profiles
event View details for a specific prediction market event
event-top-holders Show top holders aggregated across all markets in an event
events List and filter prediction market events
trades Show recent trades on a market
price-history Show price history for a market outcome
candles Show OHLC candlestick chart for a market outcome
orderbook Show the live orderbook (bids and asks) for a market outcome
preview Preview a trade: estimated fill price, fees, slippage, and total cost without executing
holders Show top position holders for a market
comments View comments on markets, events, series, or users
feed View filtered trade or comment feeds (requires login)
approve Check and set ERC-1155 token approvals for sell orders
activate Activate the currently-selected Polymarket wallet for trading
revoke Revoke all Polymarket trading approvals (ERC-1155 + pUSD)
deploy-deposit-wallet Deploy and activate your Polymarket deposit wallet
reregister-deposit-wallet Re-register an already-deployed deposit wallet with the Bullpen server
wallet Check Polymarket wallet routing and balances for every owner EOA
wallet-audit Detect split-brain / assets-in-both state across all owner EOAs
consolidate Consolidate stranded assets to your server-selected Polymarket wallet
migrate Move pUSD between your legacy Safe and Deposit Wallet
migrate-collateral Migrate stranded pUSD from your Safe wallet to your deposit wallet
preflight Run pre-trade safety checks (server time, account status, balance, approvals)
doctor Run diagnostic checks for trading readiness
market Show detailed market information
markets List and filter markets
price Quick price check for a prediction market (midpoint, last trade, bid/ask, spread)
withdraw Withdraw USDC.e from a Deposit Wallet on Polygon; other withdrawals use the web app
wrap Wrap USDC into pUSD (Polymarket collateral token)
unwrap Unwrap pUSD back to USDC
sweep-stranded Move a stranded ERC-20 token out of your Safe wallet via a gasless relayer transaction
sweep-native-pol Move native POL accidentally sent to a Deposit Wallet via the gasless relayer
sweep-signer-eoa Sweep USDC held directly on a signer EOA into your active Polymarket wallet
bridge Bridge utilities: check deposit transaction status
tags List market tags/categories
categories Browse market categories with stats from top markets (market count, volume, examples)
series List event series or show series detail
teams List sports teams
sports-list List all supported sports categories
sports-market-types List valid sports market types
split Split USDC into YES and NO tokens for a market
merge Merge YES and NO tokens back into USDC
redeem-neg-risk Redeem neg-risk positions using the NegRiskAdapter
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
rewards View your Polymarket reward earnings and active reward programs
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
bracket Bracket contest commands: March Madness picks, leaderboard, and results
help Print this message or the help of the given subcommand(s)
Options:
--output <OUTPUT>
Output format for command results
[possible values: table, json]
--env <ENV>
Target environment to connect to (overrides config.toml)
[env: BULLPEN_ENV=]
[possible values: staging, production]
--config <CONFIG>
Path to a custom config.toml file (overrides $BULLPEN_CONFIG and the default location).
Explicit --config and BULLPEN_CONFIG paths fail closed: if the file is missing, the CLI exits validation instead of silently loading defaults. Credentials still resolve via BULLPEN_HOME, so set BULLPEN_HOME too when isolating a session.
--read-only
Enable read-only mode: blocks all mutating commands
--non-interactive
Suppress interactive prompts; does NOT imply --yes for money-moving commands
[env: BULLPEN_NON_INTERACTIVE=]
-h, --help
Print help (see a summary with '-h')