polymarket-knowledge
This reference guide supports order lifecycle management and WebSocket event mapping for the Polymarket CLOB API.
Install
mkdir -p .claude/skills/polymarket-knowledge && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/5324" && unzip -o skill.zip -d .claude/skills/polymarket-knowledge && rm skill.zipInstalls to .claude/skills/polymarket-knowledge
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Polymarket CLOB API knowledge base for order management, WebSocket events, and trading operations. Use when working with order lifecycle (place, fill, cancel), debugging WebSocket USER_TRADE/USER_ORDER events, understanding API field mappings, or implementing trading logic.Key capabilities
- →Manage order lifecycles including placement, filling, and cancellation
- →Debug WebSocket USER_TRADE and USER_ORDER events
- →Understand Polymarket CLOB API field mappings
- →Implement trading logic with the CLOB API
- →Identify order requirements like minimum value and tick size
- →Map API statuses to order states
How it works
This skill provides a reference for Polymarket CLOB API integration, focusing on order management and real-time event handling. It details order types, requirements, state transitions, and WebSocket events.
Inputs & outputs
When to use polymarket-knowledge
- →Manage order placement and cancellation
- →Debug USER_TRADE events
- →Implement trading logic with CLOB API
About this skill
Polymarket Knowledge
Overview
Comprehensive reference for Polymarket CLOB API integration, focusing on order management and real-time event handling.
Quick Reference
Order Types
| Type | Behavior | Use Case |
|---|---|---|
| GTC | Good Till Cancelled | Maker orders, liquidity provision |
| GTD | Good Till Date | Time-limited orders |
| FOK | Fill Or Kill | Must fill completely or cancel |
| FAK | Fill And Kill | Fill what you can, cancel rest |
Order Requirements
- Minimum order value: $1 USDC
- Minimum shares: 5
- Tick size: 0.01 (prices must be 0.01, 0.02, ... 0.99)
Order State Machine
See references/order-state-machine.md for complete state diagram and transitions.
States: PENDING → OPEN → PARTIALLY_FILLED → FILLED/CANCELLED/EXPIRED
API Status Mapping:
live→ OPENmatched(partial) → PARTIALLY_FILLEDmatched(full) → FILLEDdelayed→ PENDINGcancelled→ CANCELLEDexpired→ EXPIRED
WebSocket Events
See references/websocket-events.md for field mappings and examples.
Key Endpoints:
- Market:
wss://ws-subscriptions-clob.polymarket.com/ws/market - User:
wss://ws-subscriptions-clob.polymarket.com/ws/user(authenticated)
USER_ORDER Event Types: PLACEMENT, UPDATE, CANCELLATION USER_TRADE Statuses: MATCHED, MINED, CONFIRMED, RETRYING, FAILED
Common Pitfalls
- Wrong field names: API uses
matched_amountnotmatched_size,size_matchednotmatched_size - Wrong endpoint: USER events require
/ws/user, not/ws/market - USDC type: Polymarket uses USDC.e (bridged), not native USDC
Resources
- references/order-state-machine.md - State transitions and validation
- references/websocket-events.md - WebSocket field mappings
- references/api-field-mappings.md - API response field reference
When not to use it
- →When working with native USDC instead of USDC.e
- →When using incorrect field names for API calls
- →When using the market WebSocket endpoint for user-specific events
Limitations
- →Does not support native USDC
- →Requires correct API field names
- →Requires specific WebSocket endpoints for market versus user events
How it compares
This skill provides specific Polymarket CLOB API details, unlike a generic API reference that would not include order types, state machines, or WebSocket event specifics.
Compared to similar skills
polymarket-knowledge side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| polymarket-knowledge (this skill) | 1 | 5mo | No flags | Intermediate |
| billing-automation | 10 | 2mo | No flags | Intermediate |
| paypal-integration | 10 | 2mo | No flags | Intermediate |
| ccxt-php | 1 | 6mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
billing-automation
wshobson
Build automated billing systems for recurring payments, invoicing, subscription lifecycle, and dunning management. Use when implementing subscription billing, automating invoicing, or managing recurring payment systems.
paypal-integration
wshobson
Integrate PayPal payment processing with support for express checkout, subscriptions, and refund management. Use when implementing PayPal payments, processing online transactions, or building e-commerce checkout flows.
ccxt-php
ccxt
CCXT cryptocurrency exchange library for PHP developers. Covers both REST API (standard) and WebSocket API (real-time). Helps install CCXT, connect to exchanges, fetch market data, place orders, stream live tickers/orderbooks, handle authentication, and manage errors in PHP 8.1+. Use when working with crypto exchanges in PHP projects, trading bots, or web applications. Supports both sync and async (ReactPHP) usage.
openrouter-cost-controls
jeremylongshore
Implement budget controls and cost limits for OpenRouter. Use when managing spending or preventing overruns. Trigger with phrases like 'openrouter budget', 'openrouter spending limit', 'cost control', 'openrouter billing alert'.
plaid-fintech
davila7
Expert patterns for Plaid API integration including Link token flows, transactions sync, identity verification, Auth for ACH, balance checks, webhook handling, and fintech compliance best practices. Use when: plaid, bank account linking, bank connection, ach, account aggregation.
ccxt-csharp
ccxt
CCXT cryptocurrency exchange library for C# and .NET developers. Covers both REST API (standard) and WebSocket API (real-time). Helps install CCXT, connect to exchanges, fetch market data, place orders, stream live tickers/orderbooks, handle authentication, and manage errors in .NET projects. Use when working with crypto exchanges in C# applications, trading systems, or financial software. Supports .NET Standard 2.0+.