Skip to content

Orders and Watchlist

View trade history, cancel orders, and maintain a watchlist.

Orders Overview

The orders subcommand provides trade history and order cancellation. Viewing open orders is not supported because Polymarket's CLOB API requires L2 wallet credentials; view open orders at polymarket.com instead.

# These two modes are available:
bullpen prediction polymarket orders --address 0xABC... --history
bullpen prediction polymarket orders --address 0xABC... --cancel <ORDER_ID>
Flag Description
--address Wallet address (required)
--history Show past trade history
--cancel Cancel an order by ID
--trade-server-url Override trade server URL (needed for cancel)
--access-token Override access token (needed for cancel)

Trade History

View past trades:

bullpen prediction polymarket orders --address 0xABC... --history

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 an Order

Cancel an open order by ID:

bullpen prediction polymarket orders --address 0xABC... --cancel abc123

Cancelling requires trade server credentials. The CLI resolves --trade-server-url from the flag, then config.toml, then the environment default. The --access-token resolves from the flag, then stored credentials from bullpen auth login.

Output:

Order abc123 cancelled.

Watchlist

The watchlist is stored locally at ~/.bullpen/watchlist.json (or $BULLPEN_HOME/watchlist.json).

List Watchlist

bullpen prediction polymarket 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

bullpen prediction polymarket watchlist --add will-btc-reach-100k

The CLI looks up the market title by slug and confirms:

Added 'Will BTC reach $100K by March?' to watchlist.

Remove a Market

bullpen prediction polymarket watchlist --remove will-btc-reach-100k

Output:

Removed 'will-btc-reach-100k' from watchlist.

JSON Output

bullpen prediction polymarket watchlist --output json
bullpen prediction polymarket orders --address 0xABC... --history --output json