Overview 概述

Polymarket API 基于 REST 架构,使用 JSON 格式传输数据。所有 API 端点均通过 HTTPS 加密通信,确保数据安全。

🔑

Authentication 认证

使用 API Key 和 HMAC 签名进行身份验证。在开发者控制台创建 API Key 后即可开始使用。

Base URL 基础地址

所有 API 请求发送至:
https://clob.polymarket.com

📦

Data Format 数据格式

所有请求和响应均使用 JSON 格式。时间戳使用 Unix 毫秒格式,价格使用字符串表示以避免精度丢失。

Endpoints API端点

核心 API 端点列表,涵盖市场数据、交易和账户管理功能。

GET
/markets
获取所有活跃市场列表。支持分页、排序和筛选参数。返回市场ID、标题、描述、当前概率等完整信息。
GET
/markets/{id}
获取单个市场详细信息,包括当前价格、交易量、流动性深度、历史价格走势等数据。
GET
/prices
获取市场实时价格数据。支持批量查询多个市场的当前价格,返回最新成交价和买卖盘口。
GET
/orderbook/{token_id}
获取指定代币的完整订单簿数据,包括所有买单和卖单的深度信息。
POST
/order
提交新的交易订单。支持限价单和市价单。需要 API Key 签名认证。返回订单ID和状态。
DELETE
/order/{order_id}
取消指定订单。只能取消尚未成交的挂单。需要 API Key 签名认证。
GET
/trades
获取历史成交记录。支持按市场、时间范围和交易方向筛选。返回成交价格、数量和时间戳。
GET
/positions
获取当前持仓信息。返回所有持有头寸的市场、数量、平均成本和未实现盈亏。

Code Examples 代码示例

使用不同编程语言调用 Polymarket API 的示例代码。

Python 示例 - 获取市场列表
import requests

# 获取所有活跃市场
response = requests.get("https://clob.polymarket.com/markets",
    params={"limit": 10, "active": True}
)

markets = response.json()
for market in markets["data"]:
    print(f"{market['question']} - {market['outcomePrices']}")
JavaScript 示例 - 查询市场价格
// 获取市场实时价格
const response = await fetch(
    'https://clob.polymarket.com/prices?token_ids=TOKEN_ID'
);

const data = await response.json();
console.log(`当前价格: ${data.price}`);
console.log(`24h变化: ${data.change}`);
cURL 示例 - 提交订单
# 提交限价买单
curl -X POST https://clob.polymarket.com/order \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "token_id": "TOKEN_ID",
    "side": "BUY",
    "price": "0.55",
    "size": "100",
    "order_type": "GTC"
  }'

Rate Limits 速率限制

为确保 API 服务的稳定性,所有端点都有速率限制。超出限制将返回 HTTP 429 错误。

Endpoint 端点 Rate Limit 限制 Window 时间窗口
GET /markets 100 次请求 每分钟
GET /prices 200 次请求 每分钟
GET /orderbook 100 次请求 每分钟
POST /order 20 次请求 每分钟
GET /trades 60 次请求 每分钟
GET /positions 60 次请求 每分钟

FAQ 常见问题

关于 Polymarket API 的常见问题解答。

如何获取 API Key?

登录 Polymarket 账户后,进入"Settings" → "API"页面,点击"Create API Key"即可生成新的 API Key。每个账户最多可以创建5个 API Key。请妥善保管您的 API Key 和 Secret,不要分享给他人。

API 是否免费使用?

市场数据查询 API(GET 请求)完全免费。交易相关 API(POST/DELETE 请求)需要账户中有资金,但不收取额外的 API 使用费用。交易手续费与网页端相同。

是否提供 WebSocket 实时数据?

是的,Polymarket 提供 WebSocket 接口用于实时价格和订单簿更新。WebSocket 端点为 wss://ws-subscriptions-clob.polymarket.com/ws。支持订阅特定市场的价格变动和订单簿更新。

如何提高 API 速率限制?

如果您需要更高的速率限制,请联系我们的开发者支持团队。VIP 用户和机构客户可以申请提高限额。提供您的使用场景和预期请求量,我们将为您定制合适的方案。