How do I install the Polymarket Knowledge skill?

Run npx skillmds@latest add cyl19970726/polymarket-knowledge in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Polymarket Knowledge safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Polymarket Knowledge?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Polymarket Knowledge free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Polymarket Knowledge?

cyl19970726 (@cyl19970726) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Polymarket Knowledge by cyl19970726

Name: Polymarket Knowledge
Rating: 4.666666666666667 (3 reviews)
Author: cyl19970726

Polymarket Knowledge

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.

cyl19970726 5d0b2d6 4 files · 19.9 KB Updated Sep 17, 2026

File contents

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 → OPEN
matched (partial) → PARTIALLY_FILLED
matched (full) → FILLED
delayed → PENDING
cancelled → CANCELLED
expired → 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_amount not matched_size, size_matched not matched_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

---name: polymarket-knowledgedescription: 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.---# Polymarket Knowledge## OverviewComprehensive 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 MachineSee [references/order-state-machine.md](references/order-state-machine.md) for complete state diagram and transitions.**States**: PENDING → OPEN → PARTIALLY_FILLED → FILLED/CANCELLED/EXPIRED**API Status Mapping**:- `live` → OPEN- `matched` (partial) → PARTIALLY_FILLED- `matched` (full) → FILLED- `delayed` → PENDING- `cancelled` → CANCELLED- `expired` → EXPIRED## WebSocket EventsSee [references/websocket-events.md](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 Pitfalls1. **Wrong field names**: API uses `matched_amount` not `matched_size`, `size_matched` not `matched_size`2. **Wrong endpoint**: USER events require `/ws/user`, not `/ws/market`3. **USDC type**: Polymarket uses USDC.e (bridged), not native USDC## Resources- [references/order-state-machine.md](references/order-state-machine.md) - State transitions and validation- [references/websocket-events.md](references/websocket-events.md) - WebSocket field mappings- [references/api-field-mappings.md](references/api-field-mappings.md) - API response field reference

Frequently asked questions

Polymarket Knowledge

File contents

Polymarket Knowledge

Overview

Quick Reference

Order Types

Order Requirements

Order State Machine

WebSocket Events

Common Pitfalls

Resources

Related skills

Frequently asked questions

How do I install the Polymarket Knowledge skill?

What does the Polymarket Knowledge skill do?

Is Polymarket Knowledge safe to use?

Which AI agents work with Polymarket Knowledge?

Is Polymarket Knowledge free to use?

Who published Polymarket Knowledge?