快速开始 Getting Started

🚀

API快速入门

5分钟内完成API配置,开始获取市场数据。了解认证方式、基础请求和响应格式。

阅读指南 →
🔑

认证与授权

了解API密钥管理、OAuth 2.0认证流程和权限范围。安全地访问Polymarket API。

查看文档 →
📦

SDK与工具

使用官方SDK快速集成。支持Python、JavaScript、Go等多种编程语言。

浏览SDK →

API参考 API Reference

Polymarket REST API 提供完整的市场数据、交易和账户管理功能。基础URL:https://clob.polymarket.com

GET

获取市场列表

返回所有活跃市场的列表,支持分页和过滤

/markets
GET

获取单个市场详情

返回指定市场的详细信息,包括当前价格、交易量和到期时间

/markets/{id}
GET

获取订单簿

返回指定市场的实时订单簿数据,包括买盘和卖盘

/book/{token_id}
GET

获取价格历史

返回指定市场的历史价格数据,支持自定义时间范围

/prices-history/{market}
POST

创建订单

提交新的限价单或市价单,需要API密钥认证

/order
POST

取消订单

取消指定的挂单,需要订单所有者认证

/order/{id}/cancel
GET

获取用户持仓

返回指定用户的所有持仓和未结算合约

/positions/{address}
GET

获取交易历史

返回指定市场或用户的交易历史记录

/trades

开发者指南 Developer Guides

📊 市场数据集成

学习如何获取和解析Polymarket的实时市场数据,构建数据驱动的应用。

  • 获取市场列表和详情
  • 实时价格流(WebSocket)
  • 历史数据查询
  • 数据格式和字段说明
查看指南 →

💱 交易API集成

了解如何通过API下单、管理订单和监控持仓,实现自动化交易。

  • 创建和管理订单
  • 订单类型说明
  • 交易确认和结算
  • 错误处理和重试策略
查看指南 →

🔗 智能合约交互

深入了解Polymarket的CTF(Conditional Token Framework)智能合约。

  • 条件代币标准
  • 合约地址和ABI
  • 链上结算流程
  • Polygon网络交互
查看指南 →

🛠️ Webhook与通知

配置Webhook接收实时事件通知,构建响应式应用。

  • Webhook配置方法
  • 事件类型和负载格式
  • 签名验证
  • 最佳实践和故障排除
查看指南 →

代码示例 Code Examples

Python - 获取市场数据 查看更多示例
# 安装SDK: pip install polymarket-sdk
from polymarket import PolymarketClient

# 初始化客户端
client = PolymarketClient(
    api_key="your_api_key",
    api_secret="your_api_secret"
)

# 获取所有活跃市场
markets = client.get_markets(active=True, limit=20)

for market in markets:
    print(f"市场: {market['question']}")
    print(f"概率: {market['outcome_prices']}")
    print(f"交易量: ${market['volume']}")
    print("---")

# 获取特定市场的订单簿
book = client.get_order_book(token_id="market_token_id")
print(f"最高买价: {book['bids'][0]['price']}")
print(f"最低卖价: {book['asks'][0]['price']}")

开发者资源 Developer Resources

🐍

Python SDK

官方Python SDK,支持异步操作

GitHub →
📜

JavaScript SDK

TypeScript SDK,支持Node.js和浏览器

GitHub →
📋

Postman集合

API测试Postman集合,快速调试

下载 →
💬

开发者社区

加入Discord开发者频道获取帮助

加入 →
📐

OpenAPI规范

完整的OpenAPI 3.0规范文件

下载 →
🧪

测试网

使用测试网进行开发和测试

了解 →
📊

数据文档

市场数据格式和字段说明

查看 →
🔧

变更日志

API版本更新和变更记录

查看 →