This is a solid reference for building anything that touches Polymarket's trading infrastructure. You get authentication patterns for the CLOB API, market data fetching from Gamma, WebSocket subscriptions for real-time updates, and actual order execution code with proper error handling. The Python examples are copy-paste ready, covering the full flow from initializing a client with API credentials to placing orders and calculating P&L. Honestly most useful for the specific endpoint documentation and the order type explanations, since Polymarket's own docs can be scattered. If you're building a trading bot or market analytics tool, this covers the repetitive integration work so you can focus on your actual strategy.

skills.sh installs
970
GitHub stars
26
last updated
Aug 21, 2026

Install

$ npx -y skills add agentmc15/polymarket-trader --skill polymarket-api --agent claude-code

Installs into .claude/skills of the current project.

Files

Polymarket API Integration Skill

Overview

This skill provides comprehensive guidance for integrating with Polymarket's APIs and smart contracts.

API Endpoints

CLOB API (Central Limit Order Book)

Base URL: https://clob.polymarket.com

Authentication Levels
  • Level 0 (Public): Market data, orderbooks, prices
  • Level 1 (Signer): Create/derive API keys
  • Level 2 (Authenticated): Trading, orders, positions
Key Endpoints
GET  /markets              # List all markets
GET  /markets/{condition_id}  # Get specific market (condition_id is the
                               # MARKET key; token_id is the per-outcome
                               # BOOK key used by /price, /midpoint, /book
                               # below — the two are not interchangeable)
GET  /price?token_id=X     # Get current price
GET  /midpoint?token_id=X  # Get midpoint price
GET  /book?token_id=X      # Get orderbook
GET  /trades               # Get user trades
POST /order                # Place order
DELETE /order/{id}         # Cancel order
GET  /positions            # Get positions

Gamma API (Market Metadata)

Base URL: https://gamma-api.polymarket.com

Sponsors

Details

Repository
github.com/agentmc15/polymarket-trader
Categories
Backend & APIs, Documentation, Finance & Trading, Web3 & Blockchain

More from agentmc15/polymarket-trader

All 3
1vapiai avatarsetup-api-keyvapiai/skillsGuide users through obtaining and configuring a Vapi API key. Use when the user needs to set up Vapi, when API calls fail due to missing keys, or when the user 965skills.sh installs
2firebase avatarfirebase-data-connectfirebase/skillsfirebase data connect895skills.sh installs
3encoredev avatarencore-apiencoredev/skillsDefine typed API endpoints in Encore.ts using `api(...)` from `encore.dev/api`. Covers typed request/response interfaces, path/query/header/cookie params, reque874skills.sh installs
4mindrally avatarwebsocket-developmentmindrally/skillsBest practices and guidelines for building real-time applications with WebSocket communication854skills.sh installs
5sickn33 avatarbackend-security-codersickn33/antigravity-awesome-skillsbackend security coder852skills.sh installs
6sickn33 avatarapi-design-principlessickn33/antigravity-awesome-skillsapi design principles824skills.sh installs