Back to Details

polymarket-knowledge

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Polymarket Knowledge

Polymarket 知识库

Overview

概述

Comprehensive reference for Polymarket CLOB API integration, focusing on order management and real-time event handling.
这是Polymarket CLOB API集成的综合参考文档，重点介绍订单管理与实时事件处理。

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
类型行为适用场景
GTC取消前有效做市订单、提供流动性
GTD指定日期前有效限时订单
FOK必须完全成交否则取消全部成交否则取消的订单
FAK成交可成交部分，取消剩余部分成交部分后取消剩余的订单

Order Requirements

订单要求

  • Minimum order value: $1 USDC
  • Minimum shares: 5
  • Tick size: 0.01 (prices must be 0.01, 0.02, ... 0.99)
  • 最低订单价值：1 USDC
  • 最低股数：5
  • 最小价格变动单位：0.01（价格必须为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
完整的状态图与状态转换请查看references/order-state-machine.md。
状态：PENDING（待处理）→ OPEN（已挂单）→ PARTIALLY_FILLED（部分成交）→ FILLED（完全成交）/CANCELLED（已取消）/EXPIRED（已过期）
API状态映射:
  • live
    → OPEN（已挂单）
  • matched
    （部分）→ PARTIALLY_FILLED（部分成交）
  • matched
    （全部）→ FILLED（完全成交）
  • delayed
    → PENDING（待处理）
  • cancelled
    → CANCELLED（已取消）
  • expired
    → EXPIRED（已过期）

WebSocket Events

WebSocket事件

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
字段映射与示例请查看references/websocket-events.md。
关键端点:
  • 市场端：
    wss://ws-subscriptions-clob.polymarket.com/ws/market
  • 用户端：
    wss://ws-subscriptions-clob.polymarket.com/ws/user
    （需认证）
USER_ORDER事件类型：PLACEMENT（下单）、UPDATE（更新）、CANCELLATION（撤单） USER_TRADE状态：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
  1. 字段名称错误：API使用
    matched_amount
    而非
    matched_size
    ，
    size_matched
    而非
    matched_size
  2. 端点错误：用户事件需使用
    /ws/user
    ，而非
    /ws/market
  3. USDC类型：Polymarket使用的是USDC.e（跨链版本），而非原生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
  • references/order-state-machine.md - 状态转换与验证
  • references/websocket-events.md - WebSocket字段映射
  • references/api-field-mappings.md - API响应字段参考