Orders and Watchlist¶
View open orders, trade history, cancel orders, and maintain a watchlist.
Orders Overview¶
The orders subcommand manages your open orders, trade history, and order cancellation. By default (no flags), it shows your current open orders.
# View open orders (default)
bullpen polymarket orders
# Trade history
bullpen polymarket orders --history
# Cancel a single order
bullpen polymarket orders --cancel <ORDER_ID>
# Bulk cancel (comma-separated IDs)
bullpen polymarket orders --cancel id1,id2,id3
# Cancel ALL open orders
bullpen polymarket orders --cancel-all --yes
# Cancel all orders on a specific market
bullpen polymarket orders --cancel-market <CONDITION_ID> --yes
| Flag | Description |
|---|---|
--address |
Wallet address (used with --history) |
--history |
Show past trade history |
--cancel |
Cancel order(s) by ID; comma-separate multiple IDs |
--cancel-all |
Cancel ALL open orders |
--cancel-market |
Cancel all orders on a specific market (by condition ID) |
--yes |
Skip confirmation prompt (for cancel operations) |
Note: --history, --cancel, --cancel-all, and --cancel-market are mutually exclusive. Only one can be used at a time.
Open Orders¶
View your current open orders (requires authentication):
Output:
Market Outcome Side Price Shares Expiration
------------------------------------------------------------------------------------
Will BTC reach $100K? Yes BUY 65¢ 10.00 GTC
Will ETH flip SOL in TVL? No SELL 42¢ 20.00 EOD
Trade History¶
View past trades:
If --address is omitted, the CLI uses your logged-in Polymarket address.
Output:
Market Outcome Side Price Size Time
------------------------------------------------------------------------------------
Will BTC reach $100K? Yes BUY 65¢ 10.00 2024-12-01T10:30:00Z
Will ETH merge succeed? No SELL 40¢ 20.00 2024-12-01T09:15:00Z
Cancel Orders¶
Cancel a Single Order¶
Output:
Bulk Cancel¶
Cancel multiple orders at once by passing comma-separated IDs:
Output:
If some orders fail to cancel, the CLI reports which ones and why:
Cancel All Orders¶
Cancel every open order on your account:
You will be prompted to confirm unless --yes is passed:
Cancel by Market¶
Cancel all orders on a specific market (by condition ID):
You will be prompted to confirm unless --yes is passed:
Watchlist¶
The watchlist is stored locally at ~/.bullpen/watchlist.json (or $BULLPEN_HOME/watchlist.json).
List Watchlist¶
Output:
Market Added
------------------------------------------------------------------
Will BTC reach $100K by March? 2024-12-01T10:30:00+00:00
Will ETH merge succeed? 2024-11-28T08:00:00+00:00
Add a Market¶
The CLI looks up the market title by slug and confirms:
Current behavior note: some slugs resolve only when passed as the event slug (not a child market slug). If --add fails with failed to fetch event, retry with the parent event slug.
Remove a Market¶
Output:
JSON Output¶
bullpen polymarket watchlist --output json
bullpen polymarket orders --output json
bullpen polymarket orders --history --output json
Current behavior caveat: some mutating commands (--add, --remove, cancel flows) can still emit plain-text status lines in --output json mode.