bullpen polymarket clob¶
Last updated: May 29, 2026
Direct CLOB API commands: prices, order book, balances, and order lookup
Usage¶
Subcommands¶
| Subcommand | Description |
|---|---|
midpoint |
Get the midpoint price for a token ID |
midpoints |
Get midpoint prices for multiple token IDs (batch) |
spread |
Get the bid-ask spread for a token ID |
spreads |
Get bid-ask spreads for multiple token IDs (batch) |
book |
Get order book depth for a token ID |
books |
Get order books for multiple token IDs (batch) |
batch-prices |
Get batch prices for multiple token IDs |
last-trades |
Get last trade prices for multiple token IDs (batch) |
balance |
Query pUSD balance and allowance (authenticated) |
ok |
Check CLOB API health |
time |
Get the current CLOB server time |
geoblock |
Check geo-restriction status for your IP address |
fee-rate |
Get the fee rate in basis points for a token ID |
account-status |
Get account close-only mode status (authenticated) |
tick-size |
Get the minimum tick size for a token ID |
neg-risk |
Check whether a token uses the NegRisk adapter |
order |
Look up a single order by order ID (authenticated) |
rewards |
View reward earnings for a specific date (authenticated) |
earnings |
View total earnings summary for a date (authenticated) |
current-rewards |
List current active reward programs (authenticated) |
reward-percentages |
View reward percentage breakdown by market (authenticated) |
order-scoring |
Check if a single order is scoring rewards (authenticated) |
orders-scoring |
Check if multiple orders are scoring rewards (authenticated) |
market-reward |
Get reward details for a specific market (authenticated) |
earnings-markets |
Get earnings with market reward config for a date (authenticated) |
api-keys |
List API keys associated with the authenticated wallet (authenticated) |
create-api-key |
Create or derive API key credentials for the authenticated wallet (authenticated) |
delete-api-key |
Delete the current API key used by the authenticated wallet (authenticated) |
reset-api-key |
Recover from "Could not derive api key" errors by re-resolving the signing address and creating fresh credentials (authenticated) |
price-history |
Get price history for a token ID (unauthenticated) |
trades |
Get authenticated trade history filtered by market/asset (authenticated) |
delete-notifications |
Delete CLOB notifications by ID (authenticated) |
update-balance |
Refresh on-chain pUSD balance and allowance in the CLOB (authenticated) |
orders |
List open orders (authenticated) |
simplified-markets |
List simplified market views with reduced detail (unauthenticated) |
sampling-markets |
List reward-eligible sampling markets (unauthenticated) |
price |
Get the price for a single token ID (unauthenticated) |
last-trade |
Get the last trade price for a single token ID (unauthenticated) |
market |
Get CLOB market detail by condition ID (unauthenticated) |
markets |
List CLOB markets with pagination (unauthenticated) |
cancel |
Cancel a single order by ID (authenticated) |
cancel-orders |
Cancel multiple orders by IDs (authenticated) |
cancel-all |
Cancel all open orders (authenticated) |
cancel-market |
Cancel all orders for a specific market (authenticated) |
notifications |
List CLOB notifications (authenticated) |
sampling-simp-markets |
List sampling simplified markets — intersection of sampling and simplified views (unauthenticated) |
Live Help¶
Direct CLOB API commands: prices, order book, balances, and order lookup
Usage: bullpen polymarket clob [OPTIONS] <COMMAND>
Commands:
midpoint Get the midpoint price for a token ID
midpoints Get midpoint prices for multiple token IDs (batch)
spread Get the bid-ask spread for a token ID
spreads Get bid-ask spreads for multiple token IDs (batch)
book Get order book depth for a token ID
books Get order books for multiple token IDs (batch)
batch-prices Get batch prices for multiple token IDs
last-trades Get last trade prices for multiple token IDs (batch)
balance Query pUSD balance and allowance (authenticated)
ok Check CLOB API health
time Get the current CLOB server time
geoblock Check geo-restriction status for your IP address
fee-rate Get the fee rate in basis points for a token ID
account-status Get account close-only mode status (authenticated)
tick-size Get the minimum tick size for a token ID
neg-risk Check whether a token uses the NegRisk adapter
order Look up a single order by order ID (authenticated)
rewards View reward earnings for a specific date (authenticated)
earnings View total earnings summary for a date (authenticated)
current-rewards List current active reward programs (authenticated)
reward-percentages View reward percentage breakdown by market (authenticated)
order-scoring Check if a single order is scoring rewards (authenticated)
orders-scoring Check if multiple orders are scoring rewards (authenticated)
market-reward Get reward details for a specific market (authenticated)
earnings-markets Get earnings with market reward config for a date (authenticated)
api-keys List API keys associated with the authenticated wallet (authenticated)
create-api-key Create or derive API key credentials for the authenticated wallet (authenticated)
delete-api-key Delete the current API key used by the authenticated wallet (authenticated)
reset-api-key Recover from "Could not derive api key" errors by re-resolving the signing address and creating fresh credentials (authenticated)
price-history Get price history for a token ID (unauthenticated)
trades Get authenticated trade history filtered by market/asset (authenticated)
delete-notifications Delete CLOB notifications by ID (authenticated)
update-balance Refresh on-chain pUSD balance and allowance in the CLOB (authenticated)
orders List open orders (authenticated)
simplified-markets List simplified market views with reduced detail (unauthenticated)
sampling-markets List reward-eligible sampling markets (unauthenticated)
price Get the price for a single token ID (unauthenticated)
last-trade Get the last trade price for a single token ID (unauthenticated)
market Get CLOB market detail by condition ID (unauthenticated)
markets List CLOB markets with pagination (unauthenticated)
cancel Cancel a single order by ID (authenticated)
cancel-orders Cancel multiple orders by IDs (authenticated)
cancel-all Cancel all open orders (authenticated)
cancel-market Cancel all orders for a specific market (authenticated)
notifications List CLOB notifications (authenticated)
sampling-simp-markets List sampling simplified markets — intersection of sampling and simplified views (unauthenticated)
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')