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 - HIGH RISK: display private key for wallet import
    headless-onboard - Run SIWE login + mint V2 Relayer API Key
    login - Sign in to Polymarket headlessly and mint V2 relayer credentials
    status - Check authentication readiness and API key status
  bridge - Polymarket Bridge API
    assets - List supported bridge assets
    deposit - Create deposit addresses
    quote - Quote a bridge deposit move
    status - Get bridge deposit status
  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 while reporting a maker address
    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-by-token - Resolve CLOB market by token ID
    market-order - Create a signed CLOB market/FOK order
    market-trades-probe - Probe CLOB trade scope for one market or token
    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
    enable-trading - Complete the UI Enable Trading signs for an existing deposit wallet
    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 + enable trading + 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
  diag - Print redacted local diagnostics
  discover - Market discovery via Polymarket Gamma API
    comments - List or fetch public Gamma comments
    crypto - Discover active crypto prediction markets
    crypto-5m - List all 7 active 5-minute crypto markets
    crypto-window - Resolve the current crypto prediction window deterministically
    enrich - Enrich market with CLOB data
    market - Get market details
    markets - List Gamma markets
    opportunities - Scan read-only market opportunity candidates
    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
  intel - Read-only wallet intelligence
    alerts - List user-scoped wallet dossier alerts
    leaderboard - List Data-API-ranked wallet intelligence rows
    market-flow - Summarize read-only market holder, trade, and open-interest flow
    wallet - Build a read-only wallet intelligence dossier
  live - Inspect live gate status
    status
  marketdata - Live CLOB orderbook and share-price snapshots
    crypto - Get live marketdata snapshots for crypto markets
    live - Stream enriched CLOB market-data snapshots
  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 - Paper trading simulation for crypto markets
    buy - Simulate a buy order (paper trading)
    crypto - Discover crypto markets and paper trade
    positions - Show current paper trading positions
    reset - Reset paper trading state
    sell - Simulate a sell order (paper trading)
    trade - Paper trade the current crypto window in one command
  preflight - Inspect local CLI readiness
  relayer - Inspect Polymarket relayer state
    transaction - Get relayer transaction state
  stream - Polymarket WebSocket streams
    crypto - Stream live crypto market events
    market - Stream public CLOB market events
    user - Stream authenticated CLOB user order/trade 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 diag`	Print redacted local diagnostics
`polygolem discover`	Market discovery via Polymarket Gamma API
`polygolem events`	List Polymarket events
`polygolem health`	Check Gamma and CLOB API reachability
`polygolem intel`	Read-only wallet intelligence
`polygolem live`	Inspect live gate status
`polygolem marketdata`	Live CLOB orderbook and share-price snapshots
`polygolem orderbook`	Read CLOB order book data
`polygolem paper`	Paper trading simulation for crypto markets
`polygolem preflight`	Inspect local CLI readiness
`polygolem relayer`	Inspect Polymarket relayer state
`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.