English | 中文
polymarket-skill
Claude Code skill for Polymarket — the complete developer reference for prediction market integration on Polygon.
What is this?
A Claude Code skill that gives Claude deep knowledge of the Polymarket API ecosystem. When installed, Claude can guide you through authentication, order placement, market data retrieval, WebSocket streaming, and CTF token operations — without hallucinating endpoints or parameters.
Coverage
| Module | File | Topics |
|---|
| Core | SKILL.md | API endpoints, contract addresses, client setup, quick reference |
| Authentication | authentication.md | L1 EIP-712, L2 HMAC-SHA256, API key lifecycle, builder headers |
| Orders | order-patterns.md | GTC/GTD/FOK/FAK, tick sizes, batch orders, cancel, heartbeat |
| Market Data | market-data.md | Gamma API, Data API, CLOB orderbook, subgraph queries |
| WebSocket | websocket.md | Market/user/sports channels, subscribe, heartbeat, reconnect |
| Fees | fees.md | Fee formula, fee tables by market type, SDK auto-handling, REST API manual flow |
| CTF Operations | ctf-operations.md | Split, merge, redeem positions, negative risk, token IDs |
| Bridge | bridge.md | Deposits, withdrawals, supported chains/tokens, status tracking |
| Gasless | gasless.md | Relayer client, wallet deployment, builder program setup |
| Concepts | concepts.md | Markets/events, positions/tokens, order lifecycle, resolution, negative risk |
| Error Codes | error-codes.md | All CLOB API error codes by endpoint, status code reference |
| Rate Limits | rate-limits.md | Gamma/Data/CLOB API limits, trading burst+sustained limits |
| Geoblock | geoblock.md | Blocked countries, geoblock API, close-only regions |
Quick Start
Option 1: Plugin install (recommended)
# Add marketplace source (one-time)
/plugin marketplace add atompilot/polymarket-skill
# Install
/plugin install polymarket@atompilot-polymarket-skill
Option 2: One-line install
curl -fsSL https://raw.githubusercontent.com/atompilot/polymarket-skill/master/install.sh | bash
Option 3: Manual clone
git clone --depth 1 https://github.com/atompilot/polymarket-skill.git ~/.claude/skills/polymarket
Option 4: Symlink (for development)
git clone https://github.com/atompilot/polymarket-skill.git ~/Projects/polymarket-skill
ln -s ~/Projects/polymarket-skill/skills/polymarket ~/.claude/skills/polymarket
Restart Claude Code after any installation method.
Usage
Once installed, Claude Code automatically picks up the skill. Just ask:
"Help me authenticate with Polymarket API using Python"
"Place a GTC limit order on the 2026 election market"
"Subscribe to real-time orderbook updates via WebSocket"
"How do I split CTF tokens for a negative risk market?"
"Show me how to bridge USDC to Polygon for Polymarket"
API Endpoints
| API | Base URL | Auth Required |
|---|
| CLOB | https://clob.polymarket.com | L2 for trade endpoints |
| Gamma / Data | https://gamma-api.polymarket.com | None |
| Data API | https://data-api.polymarket.com | None |
| WebSocket (Market) | wss://ws-subscriptions-clob.polymarket.com/ws/market | None |
| WebSocket (User) | wss://ws-subscriptions-clob.polymarket.com/ws/user | API creds |
| Relayer | https://relayer-v2.polymarket.com/ | Builder headers |
Supported SDKs
- TypeScript:
@polymarket/clob-client
- Python:
py-clob-client
Both are covered with code examples in each module.
Official Documentation
This skill distills the full docs (~122K tokens) into 13 focused modules (~18K tokens total), loaded on demand.
Project Structure
