欢迎来到 Polymarket 订单簿 API(Order Book API)!这份文档提供概述、解释、示例和注释,旨在简化与订单簿的交互。下面详细介绍 Polymarket 的订单簿系统及其 API 使用方式。系统概述(System)Polymarket 的订单簿(Order Book),也称为 CLOB(Central Limit Order Book,中心化限价订单簿),采用混合去中心化(hybrid-decentralized)架构:
- 链下:由运营商(operator)负责订单匹配和排序。
- 链上:结算/执行完全去中心化、非托管,通过用户签名的订单消息实现。
- 使用自定义的 Exchange 合约,支持二元结果代币(binary Outcome Tokens,包括 CTF ERC1155 资产和 ERC20 PToken 资产)与抵押资产(ERC20,如 USDCe)之间的原子交换。
- 专为二元市场设计,支持互补代币(complementary tokens)在统一订单簿中匹配。
- 所有订单使用 EIP-712 签名 的结构化数据。
- 匹配订单:一个 maker(挂单方) + 一个或多个 taker(吃单方),taker 可获得价格改善(price improvement)。
- 运营商仅负责链下订单管理,并将匹配后的交易提交到区块链进行链上执行。
API 概述(API)Polymarket 订单簿 API 允许市场做市商(market makers)和交易者程序化管理订单:
- 支持创建、列出、获取任意数量的订单。
- 可读取市场订单簿数据。
- 通过 REST 和 WebSocket 端点,提供所有可用市场、市场价格、订单历史等数据。
安全性(Security)
- Polymarket 的 Exchange 合约已由 Chainsecurity 审计完成(查看审计报告)。
- 运营商权限严格受限:仅限于订单匹配、不审查、确保正确排序。
- 运营商无法设定价格或执行未授权交易。
- 用户可随时链上独立取消订单,如果对运营商失去信任,也能自行控制资产。
费用(Fees)费用表(Schedule)
费用表可能会变动
| 交易量级别 | Maker 基础费率 (bps) | Taker 基础费率 (bps) |
|---|---|---|
| >0 USDC | 0 | 0 |
费用概述(Overview)
- 费用对称应用在输出资产(收益)上,确保公平性和市场完整性。
- 费用计算根据买卖方向不同:
- 卖出结果代币(base)换取抵押品(quote):
feeQuote = baseRate × min(price, 1 - price) × size - 用抵押品(quote)买入结果代币(base):
feeBase = baseRate × min(price, 1 - price) × (size / price)
- 卖出结果代币(base)换取抵押品(quote):
说明:baseRate 为基础费率(bps 单位),min(price, 1 - price) 确保费用在概率接近 0 或 1 时趋近于 0,在 0.5 时最高。目前基础费率为 0,因此实际费用为 0(但平台保留调整权利)。额外资源(Additional Resources)
- Exchange 合约审计报告
- 后续文档建议阅读:
- CLOB 快速入门 (/developers/CLOB/quickstart)
- 认证方式 (/developers/CLOB/authentication)
- 地理限制 (/developers/CLOB/geoblock)
- 市场做市商指南 (/developers/market-makers/introduction)
- 构建者计划 (/developers/builders/builder-intro)
一句话总结:
Polymarket 的 CLOB 是专为二元预测市场设计的混合订单簿系统:链下高效匹配 + 链上安全非托管结算,结合 EIP-712 签名和原子交换,确保高性能、低费用(目前零费)和用户控制力。适合市场做市商、量化交易者和开发者构建自动化工具。
