PolyClaw

Trading-enabled Polymarket skill for OpenClaw. Browse markets, manage wallets, execute trades, and track positions.

Features

• - Market Browsing - Search and browse Polymarket prediction markets
• Wallet Management - Env-var based wallet configuration
• Trading - Buy YES/NO positions via split + CLOB execution
• Position Tracking - Track entry prices, current prices, and P&L
• Hedge Discovery - LLM-powered covering portfolio discovery via logical implications

Quick Start

First, install dependencies (from skill directory):

CODEBLOCK0

First-Time Setup (Required for Trading)

Before your first trade, set Polymarket contract approvals (one-time, costs ~0.01 POL in gas):

CODEBLOCK1

This submits 6 approval transactions to Polygon. You only need to do this once per wallet.

Browse Markets

CODEBLOCK2

Output options:

• - Default output is a formatted table (good for display)
• Use --full flag for full question text without truncation
• Use --json flag via scripts/markets.py --json trending for structured JSON output

Wallet Management

CODEBLOCK3

The wallet is configured via the POLYCLAW_PRIVATE_KEY environment variable.

Trading

CODEBLOCK4

Positions

CODEBLOCK5

Hedge Discovery

Find covering portfolios - pairs of market positions that hedge each other via contrapositive logic.

CODEBLOCK6

Output options:

• - Default output is a formatted table showing Tier, Coverage, Cost, Target, and Cover
• Use --json flag for structured JSON output
• Use --min-coverage 0.90 to filter by minimum coverage (default 0.85)
• Use --tier 1 to filter by tier (1=best, default 2)

Coverage tiers:

• - Tier 1 (HIGH): >=95% coverage - near-arbitrage opportunities
• Tier 2 (GOOD): 90-95% - strong hedges
• Tier 3 (MODERATE): 85-90% - decent but noticeable risk
• Tier 4 (LOW): <85% - speculative (filtered by default)

LLM model: Uses nvidia/nemotron-nano-9b-v2:free via OpenRouter. Model selection matters — some models find spurious correlations while others (like DeepSeek R1) have output format issues. Override with --model <model_id> if needed.

Automation Tools

Portfolio Live Tracking

Real-time position tracking via Polymarket Data API. Groups positions by (slug, outcome) and displays YES/NO side, current value, and P&L with cost basis from portfolio.json.

CODEBLOCK7

• - Fetches live on-chain positions from INLINECODE11
• Shows outcome side (YES/NO), current price, and unrealized P&L
• No web3 dependency — uses REST API only

Auto Redeem

Automatically detects and redeems settled (resolved) markets. Checks payoutDenominator on-chain via the CTF contract. When a market resolves, submits a redeemPositions transaction through the NegRiskAdapter.

CODEBLOCK8

• - Requires web3 (use .venv/bin/python3, not system python)
• Tracks redeemed positions in redeem_state.json to avoid duplicates
• Needs CHAINSTACK_NODE and POLYCLAW_PRIVATE_KEY env vars

Discipline Scanner

Automated take-profit scanner. Sells positions that are up 20%+ with slippage protection. Configurable via cfo_params.json (DISCIPLINE_TP_PCT key).

CODEBLOCK9

• - Skips positions worth less than $1
• Take-profit threshold defaults to 20% (configurable)

Enhanced API (polyclaw_api.py)

CLI bridge for external integrations (e.g., Wells TG Bot via SSH). Provides structured JSON output for programmatic use.

CODEBLOCK10

• - portfolio is the recommended command for live position data (reads Data API, not local DB)
• INLINECODE22 requires web3 — use INLINECODE24
• INLINECODE25 reads local DB and can be stale — prefer portfolio for accuracy

Security

For the MVP, the private key is stored in an environment variable for simplicity and Claude Code compatibility.

Security Warning: Keep only small amounts in this wallet. Withdraw regularly to a secure wallet.

Environment Variables

Variable	Required	Description
INLINECODE27	Yes (trading)	Polygon RPC URL
INLINECODE28

Yes (hedge) | OpenRouter API key for LLM hedge discovery | | POLYCLAW_PRIVATE_KEY | Yes (trading) | EVM private key (hex, with or without 0x prefix) | | HTTPS_PROXY | Recommended | Rotating residential proxy for CLOB (e.g., IPRoyal) | | CLOB_MAX_RETRIES | No | Max CLOB retries with IP rotation (default: 5) |

Security Warning: Keep only small amounts in this wallet. Withdraw regularly to a secure wallet. The private key in an env var is convenient for automation but less secure than encrypted storage.

Trading Flow

1. 1. Split Position - USDC.e is split into YES + NO tokens via CTF contract
2. Sell Unwanted - The unwanted side is sold via CLOB order book
3. Result - You hold the wanted position, recovered partial cost from selling unwanted

Example: Buy YES at $0.70

• - Split $100 USDC.e → 100 YES + 100 NO tokens
• Sell 100 NO tokens at ~$0.30 → recover ~$27 USDC.e
• Net cost: ~$73 for 100 YES tokens (entry: $0.73)

Polymarket Contracts (Polygon Mainnet)

• - USDC.e: INLINECODE32
• CTF (Conditional Tokens): INLINECODE33
• CTF Exchange: INLINECODE34

Dependencies

Install with uv (from skill directory):
CODEBLOCK11

Limitations

• - Trading requires wallet approval setup (one-time)
• CLOB sells may fail if liquidity is insufficient

CLOB Cloudflare Blocking

Polymarket's CLOB API uses Cloudflare protection that blocks POST requests from many IPs, including datacenter IPs and some residential ISPs. This affects the "sell unwanted tokens" step.

Solution: Residential proxy with retry logic

The recommended setup uses a rotating residential proxy (e.g., IPRoyal, BrightData). The CLOB client automatically retries with new IPs until one works:

CODEBLOCK12

With this setup, CLOB orders typically succeed within 5-10 retries as the proxy rotates through IPs until finding an unblocked one.

Alternative workarounds:

1. 1. Use --skip-sell — Keep both YES and NO tokens, sell manually on polymarket.com
2. No proxy — Split still works; only CLOB sell is affected

If CLOB fails after all retries, your split still succeeded. The output tells you how many tokens to sell manually.

Troubleshooting

"No wallet available"

Set the POLYCLAW_PRIVATE_KEY environment variable: CODEBLOCK13

"Insufficient USDC.e"

Check balance with uv run python scripts/polyclaw.py wallet status. You need USDC.e (bridged USDC) on Polygon.

"CLOB order failed"

The CLOB sell may fail due to:

• - Insufficient liquidity at the sell price
• IP blocked by Cloudflare (try proxy)

Your split still succeeded - you have the tokens, just couldn't sell unwanted side.

"Approvals not set"

First trade requires contract approvals. Run: CODEBLOCK14

License

MIT