欢迎来到 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 USDC00

费用概述(Overview)

  • 费用对称应用在输出资产(收益)上,确保公平性和市场完整性。
  • 费用计算根据买卖方向不同:
    • 卖出结果代币(base)换取抵押品(quote):
      feeQuote = baseRate × min(price, 1 - price) × size
    • 用抵押品(quote)买入结果代币(base):
      feeBase = baseRate × min(price, 1 - price) × (size / price)

说明: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 签名和原子交换,确保高性能、低费用(目前零费)和用户控制力。适合市场做市商、量化交易者和开发者构建自动化工具。