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.

Jump to install

Repository: cyl19970726/poly-sdk
Last source activity: February 22, 2026 at 14:34
Detected SKILL.md language: English
Stars: 1,272
Forks: 354

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/cyl19970726/poly-sdk --skill polymarket-knowledge

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

4 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

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

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

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

name	polymarket-knowledge
description	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.