polymarket

Polymarket prediction market CLI - Browse & Trade.

Setup

# Install dependencies
pip install -r requirements.txt

Configure credentials

Method 1: Via openclaw.json (Recommended)

Add to your ~/.openclaw/openclaw.json under skills.entries:

{
  "skills": {
    "entries": {
      "polymarket": {
        "env": {
          "POLYMARKET_PRIVATE_KEY": "your_wallet_private_key",
          "POLYMARKET_PROXY_ADDRESS": "0x_your_proxy_wallet_address"
        }
      }
    }
  }
}

Or use the shorthand apiKey field for the primary key:

{
  "skills": {
    "entries": {
      "polymarket": {
        "apiKey": "your_wallet_private_key",
        "env": {
          "POLYMARKET_PROXY_ADDRESS": "0x_your_proxy_wallet_address"
        }
      }
    }
  }
}

Method 2: Via config file (Legacy)

Create ~/.openclaw/credentials/polymarket.json:

{
  "private_key": "your_wallet_private_key",
  "proxy_address": "0x_your_proxy_wallet_address"
}

The skill checks env vars first, then falls back to the config file.

Credential details:

• POLYMARKET_PRIVATE_KEY / private_key — Your wallet private key (from MetaMask or similar)
• POLYMARKET_PROXY_ADDRESS / proxy_address — Your Polymarket proxy wallet address (from polymarket.com/settings)
• API credentials (apiKey, secret, passphrase) are auto-generated on first trade and cached locally.

Security Warning

• Strongly recommended: Use a dedicated wallet with limited funds, NOT your main wallet.
• The private key is only used locally for signing transactions via py-clob-client. It is never transmitted to any endpoint other than clob.polymarket.com (Polymarket's official CLOB API).
• If using config file method: chmod 600 ~/.openclaw/credentials/polymarket.json

Commands

Browse Markets

polymarket trending                     # Homepage (featured order)
polymarket trending geopolitics          # By category
polymarket trending crypto
polymarket trending sports
polymarket trending politics
polymarket trending business
polymarket trending entertainment
polymarket trending tech

Event Details

polymarket detail us-strikes-iran-by
polymarket event us-strikes-iran-by     # Simple overview

Trading

# Check price
polymarket price <token_id>

# Trade (requires credentials)
polymarket buy <token_id> <amount>     # Buy with USDC
polymarket sell <token_id> <amount>    # Sell USDC worth

# Example
polymarket buy 40081275558852222228080198821361202017557872256707631666334039001378518619916 2

Portfolio

polymarket position                     # From config wallet
polymarket position <wallet_address>
polymarket balance                    # From config wallet
polymarket balance <wallet_address>

Natural Language Triggers