CLI Commands

Command Tree

polygolem - Safe Polymarket SDK and CLI for Go
  auth - Inspect authentication readiness
    clob-probe - Probe configured CLOB L2 credentials with read-only calls
    export-key - Display private key for wallet import (use with care)
    headless-onboard - Run SIWE login + mint V2 Relayer API Key (headless; does NOT create CLOB API key)
    status - Check authentication readiness and API key status
  bridge - Polymarket Bridge API
    assets - List supported bridge assets
    deposit - Create deposit addresses
  builder - Manage builder credentials
    auto - Mint CLOB L2 creds via ClobAuth signature
    onboard - Capture builder credentials and persist locally
  clob - CLOB market data and authenticated account commands
    balance - Get CLOB balance and allowances
    batch-orders - Create multiple signed CLOB limit orders
    book - Get L2 order book
    cancel - Cancel a single open CLOB order
    cancel-all - Cancel all open CLOB orders
    cancel-market - Cancel open CLOB orders for a market or asset
    cancel-orders - Cancel multiple open CLOB orders
    create-api-key - Create or derive CLOB API credentials
    create-api-key-for-address - Create CLOB API credentials for a deposit wallet owner
    create-builder-fee-key - Mint a CLOB builder fee key (POST /auth/builder-api-key)
    create-order - Create a signed CLOB limit order
    heartbeat - Send one CLOB heartbeat ping
    list-builder-fee-keys - List builder fee keys (GET /auth/builder-api-keys)
    market - Get CLOB market by condition ID
    market-order - Create a signed CLOB market/FOK order
    markets - List CLOB markets
    order - Get a single authenticated CLOB order
    orders - List authenticated CLOB orders
    price-history - Get CLOB token price history
    revoke-builder-fee-key - Revoke a builder fee key (DELETE /auth/builder-api-key/{key})
    tick-size - Get minimum tick size
    trades - List authenticated CLOB trades
    update-balance - Refresh CLOB balance and allowances
  data - Polymarket Data API analytics
    activity - List public activity for a user
    closed-positions - List closed positions for a user
    holders - List top holders for a token
    leaderboard - List trader leaderboard rows
    live-volume - Get live volume summary
    markets-traded - Get total markets traded for a user
    open-interest - Get open interest for a token
    order-results - Join positions, trades, and results for a user
    positions - List open positions for a user
    trades - List public Data API trades for a user
    value - Get total portfolio value for a user
  deposit-wallet - Deposit wallet onboarding (WALLET-CREATE, nonce, batch, status)
    approve - Build and optionally submit approval calls for the deposit wallet
    approve-adapters - Approve V2 collateral adapters for redeem (one-shot per wallet)
    batch - Sign and submit a deposit wallet WALLET batch
    deploy - Deploy the deposit wallet via relayer WALLET-CREATE
    derive - Derive the deterministic deposit wallet address
    fund - Transfer pUSD from EOA to the deposit wallet
    nonce - Get the current WALLET nonce for the owner
    onboard - Full deposit wallet onboarding: deploy + approve + fund
    redeem - Redeem winning deposit-wallet positions via the V2 collateral adapter
    redeemable - List redeemable positions held by the deposit wallet
    settlement-status - Check whether the deposit wallet is ready to redeem V2 winners
    status - Check deposit wallet deployment status or transaction state
    swap-pol-pusd - Swap native POL into an exact amount of pUSD via Uniswap V3
  discover - Market discovery via Polymarket Gamma API
    comments - List or fetch public Gamma comments
    enrich - Enrich market with CLOB data
    market - Get market details
    markets - List Gamma markets
    search - Search markets and events
    series - List or fetch Gamma series
    tags - List or fetch Gamma tags/categories
  events - List Polymarket events
    list - List events
  health - Check Gamma and CLOB API reachability
  live - Inspect live gate status
    status
  orderbook - Read CLOB order book data
    fee-rate - Get fee rate in bps
    get - Get L2 order book
    last-trade - Get last trade price
    midpoint - Get midpoint price
    price - Get best price (BUY side)
    spread - Get bid-ask spread
    tick-size - Get minimum tick size
  paper - Inspect local paper trading state
    buy
    positions
    reset
    sell
  preflight - Inspect local CLI readiness
  stream - Polymarket WebSocket streams
    market - Stream public CLOB market events
  version - Print version

Top-Level Commands

Command	Description
polygolem auth	Inspect authentication readiness
polygolem bridge	Polymarket Bridge API
polygolem builder	Manage builder credentials
polygolem clob	CLOB market data and authenticated account commands
polygolem data	Polymarket Data API analytics
polygolem deposit-wallet	Deposit wallet onboarding (WALLET-CREATE, nonce, batch, status)
polygolem discover	Market discovery via Polymarket Gamma API
polygolem events	List Polymarket events
polygolem health	Check Gamma and CLOB API reachability
polygolem live	Inspect live gate status
polygolem orderbook	Read CLOB order book data
polygolem paper	Inspect local paper trading state
polygolem preflight	Inspect local CLI readiness
polygolem stream	Polymarket WebSocket streams
polygolem version	Print version

Safety

Trading commands always use deposit-wallet signing (type 3 / POLY_1271). The old --signature-type flow is intentionally absent.

Every command accepts --json and --help. The canonical generated flag reference lives in docs/COMMANDS.md.