AgentSkillsCN

polymarket-knowledge

构建 Polymarket CLOB API 知识库，涵盖订单管理、WebSocket 事件以及交易操作。适用于处理订单生命周期（下单、成交、取消）、调试 WebSocket USER_TRADE/USER_ORDER 事件、理解 API 字段映射，或实现交易逻辑时使用。

SKILL.md
--- frontmatter
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.

Polymarket Knowledge

Overview

Comprehensive reference for Polymarket CLOB API integration, focusing on order management and real-time event handling.

Quick Reference

Order Types

TypeBehaviorUse Case
GTCGood Till CancelledMaker orders, liquidity provision
GTDGood Till DateTime-limited orders
FOKFill Or KillMust fill completely or cancel
FAKFill And KillFill 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

  1. •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