Polymarket 提供了一套完整的开发者工具，包括三大 REST API（CLOB、Gamma、Data）和实时 WebSocket，支持市场发现、数据查询、订单管理与程序化交易。下面将官方文档中 Endpoints、Rate Limits 和 Glossary 的关键内容整合成一篇完整中文指南，帮助开发者快速上手。一、Polymarket API 整体架构与端点概览Polymarket 的 API 分为三大类，每类有独立的基地址：
| API 类型 | 基地址（Base URL） | 主要用途与特点 | 是否需要认证 |
|---|---|---|---|
| CLOB API | https://clob.polymarket.com | 核心交易接口：下单、撤单、实时价格、订单簿查询 | 大部分需要 L2 Header 认证 |
| Gamma API | https://gamma-api.polymarket.com | 公共市场发现：事件列表、市场元数据、分类、搜索 | 无需认证，纯公共数据 |
| Data API | https://data-api.polymarket.com | 用户个人信息：持仓、交易历史、活动记录 | 需要用户认证 |
实时推送（WebSocket）：
- CLOB WebSocket：wss://ws-subscriptions-clob.polymarket.com/ws/
用于订单簿更新、价格变动、用户订单状态（公共 + 私有频道） - RTDS（实时数据流）：wss://ws-live-data.polymarket.com
低延迟加密货币价格、评论流等
快速上手建议：
- 先用 Gamma API 拉取活跃事件和市场列表（无需登录）
- 用 CLOB API 查询价格/订单簿
- 最后通过 SDK（如 clob-client）提交订单
二、常用端点速查表Gamma API（市场发现，无需认证）
- GET /events → 列出活跃事件（支持 active=true, closed=false, limit 等过滤）
- GET /markets → 所有市场列表或条件过滤
- GET /events/{id} → 特定事件详情（含嵌套市场）
- GET /search → 搜索事件/市场
CLOB API（交易核心）
- GET /price → 指定 token 当前买/卖价
- GET /book → 完整订单簿
- GET /midpoint → 中位价
- POST /order → 提交订单（需认证）
- DELETE /order → 取消订单
- POST /orders → 批量提交
- DELETE /orders → 批量取消
Data API（用户数据）
- GET /positions → 当前持仓（可按市场过滤）
- GET /trades → 交易记录
- GET /activity → 活动历史
三、API 速率限制（Rate Limits）全览所有端点均由 Cloudflare 强制节流，超过限制会延迟处理而非直接拒绝。以下为主要限制（单位：请求数 / 10秒，除特殊注明）：通用限制：
- 所有端点通用：15000 / 10秒
- “OK” 健康检查：100 / 10秒
Gamma API（市场发现）：
- 通用：4000 / 10秒
- /events：500 / 10秒
- /markets：300 / 10秒
- 搜索：350 / 10秒
CLOB API（交易核心）：
- 通用：9000 / 10秒
- /book、/price、/midpoint：1500 / 10秒
- POST /order（下单）：3500 / 10秒（突发），持续 60 / 秒
- DELETE /order（撤单）：3000 / 10秒（突发），持续 50 / 秒
- 批量 /orders：1000 / 10秒（突发）
Data API（用户数据）：
- 通用：1000 / 10秒
- /trades、/positions：150–200 / 10秒
开发者建议：
- 高频做市机器人必须实现指数退避（exponential backoff）和请求队列。
- 优先使用批量端点（/orders）减少请求数。
- 频繁触发节流可申请提升限额（针对合格做市商）。
四、核心术语表（Glossary）
| 英文术语 | 中文翻译 | 简要定义 |
|---|---|---|
| Event | 事件 | 一组相关市场的集合（如“2025年比特币是否破20万”） |
| Market | 市场 | 单个可交易结果（通常 Yes/No 二元市场） |
| Token ID | 代币 ID | Yes/No 结果代币的唯一标识，下单/查询价格必用 |
| CLOB | 中心化限价订单簿 | Polymarket 的链下订单匹配系统 |
| Tick Size | 最小价格单位 | 价格最小变动单位（通常 0.01 或 0.001） |
| GTC / FOK / FAK | 永久有效 / 全成或取消 / 尽可能成交后取消 | 常见订单类型 |
| NegRisk | 负风险市场 | 多结果事件中只有一个 Yes，其余均为 No（下单需设置 negRisk: true） |
| USDCe | USDCe | Polygon 上的桥接 USDC，作为抵押品 |
| Funder Address | 资金地址 | 实际持有资金的钱包地址（EOA 或代理钱包） |
| Signature Type | 签名类型 | 0=EOA, 1=Magic Link 代理, 2=Gnosis Safe 代理 |
一句话总结：
Polymarket 的 API 设计非常友好——公共数据（Gamma）零门槛、交易核心（CLOB）高性能、用户数据（Data）安全隔离。开发者只需记住三大基地址 + 速率限制，就能快速构建市场浏览器、做市机器人、套利工具或数据分析系统。推荐开发路径：
- 用浏览器直接访问 https://gamma-api.polymarket.com/events?active=true&limit=10 测试市场数据
- 阅读 CLOB 文档，安装 @polymarket/clob-client SDK
- 参考速率限制，编写带退避的请求逻辑
