OpenSkillIndex← back to search
claude-code

Skills polymarket-autotrade

Polymarket prediction market CLI - Browse markets, check prices, execute trades, and manage portfolio.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/aplanckfish/polymarket-autotrade" ~/.claude/skills/clawdbot-skills-polymarket-autotrade && rm -rf "$T"
manifest: skills/aplanckfish/polymarket-autotrade/SKILL.md
source content

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

Browse Markets

"Polymarket 有什么热门市场" "显示当前趋势" "查看政治预测市场" "加密货币市场怎么样" "体育博彩市场" "商业/经济类预测市场" "娱乐新闻相关" "What's trending on Polymarket" "Show me popular prediction markets"

Event Details

"2028共和党候选人详情" "伊朗战争市场详细信息" "J.D. Vance 当前概率多少" "这个市场什么意思" "Show me details about [event name]" "What are the odds for [outcome]" "Explain this market"

Trading

"买入 J.D. Vance YES" "买 2 美元" "做多比特币" "下注 5 美元" "Buy [token/outcome]" "I want to buy [amount] USDC of [outcome]" "Place a bet on [outcome]" "Long [market]"

Portfolio

"我的仓位" "我的持仓" "还剩多少钱" "当前余额" "My positions" "Show me my balance" "How much USDC do I have"

Features

  • Env-first credentials - Reads 
    POLYMARKET_PRIVATE_KEY
    / 
    POLYMARKET_PROXY_ADDRESS
    from env, falls back to config file
  • Auto API credentials - Generated on first trade and cached to 
    ~/.openclaw/credentials/polymarket_api.json
  • Default wallet - Uses 
    proxy_address
    from config for position/balance commands
  • Local-only signing - Private key never leaves your machine; only signed transactions are sent to Polymarket CLOB API

APIs