polymarket

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

Resource	URL	Description
Docs Index	llms.txt	Page index with links and one-line descriptions (~6K tokens)
Full Docs	llms-full.txt	Complete documentation in a single file (~122K tokens)
OpenAPI Specs	clob-openapi.yaml	CLOB API OpenAPI spec
	gamma-openapi.yaml	Gamma API OpenAPI spec
	data-openapi.yaml	Data API OpenAPI spec
	bridge-openapi.yaml	Bridge API OpenAPI spec
	relayer-openapi.yaml	Relayer API OpenAPI spec

This skill distills the full docs (~122K tokens) into 13 focused modules (~18K tokens total), loaded on demand.

Project Structure