bullpen polymarket clob

Last updated: February 26, 2026

Direct CLOB API commands: prices, order book, balances, and order lookup

Usage

bullpen polymarket clob [OPTIONS] <COMMAND>

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 USDC 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)
price-history	Get price history for a token ID (unauthenticated)
trades	Get authenticated trade history filtered by market/asset (authenticated)
post-orders	Post multiple limit orders in one batch call (authenticated, direct CLOB)
market-order	Place an explicit market order directly on the Polymarket CLOB (authenticated)
delete-notifications	Delete CLOB notifications by ID (authenticated)
update-balance	Refresh on-chain USDC balance and allowance in the CLOB (authenticated)
simplified-markets	List simplified market views with reduced detail (unauthenticated)
sampling-markets	List reward-eligible sampling markets (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 USDC 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)
  price-history         Get price history for a token ID (unauthenticated)
  trades                Get authenticated trade history filtered by market/asset (authenticated)
  post-orders           Post multiple limit orders in one batch call (authenticated, direct CLOB)
  market-order          Place an explicit market order directly on the Polymarket CLOB (authenticated)
  delete-notifications  Delete CLOB notifications by ID (authenticated)
  update-balance        Refresh on-chain USDC balance and allowance in the CLOB (authenticated)
  simplified-markets    List simplified market views with reduced detail (unauthenticated)
  sampling-markets      List reward-eligible sampling markets (unauthenticated)
  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

bullpen polymarket clob [OPTIONS] <COMMAND>
bullpen polymarket clob --help
bullpen polymarket clob --output json

Example Data

Representative JSON shape for automation and integrations:

{
  "command": "bullpen polymarket clob",
  "type": "command_group",
  "subcommands": [ "midpoint", "midpoints", "spread", "spreads", "book", "books" ],
  "last_updated": "2026-02-26"
}