POLYDATA
Polymarket 概念

Polymarket 概念

生命周期概览

Polymarket market lifecycle overview with Market, OrderFilled, and Oracle lanes
polyData Monitor 中的 Polymarket 市场生命周期:市场身份、OrderFilled 交易活动与 oracle 结算状态。

Market

Polymarket 中有五个容易混淆的概念:market、event、series、slug 和 token。token 是最低层的可结算资产;market 是可交易的问题;event 用来组织一个或多个相关 market;series 是更大的集合,可跨赛季、重复主题、选举、赛事或长期专题组织 event;slug 是用于 URL 和 API 的人类可读查询键。

market 是最小可交易单位。在常见二元市场中,它对应一个具体的 Yes/No 问题,并拥有两个 outcome token。event 是用户在 Polymarket 前端通常看到的页面级容器。slug 不是链上 ID,也不是钱包真正持有的资产;token 才是真正的结果资产。

Series
- title: 2028 U.S. Presidential Election
- slug: us-presidential-election-2028

  Event
  - title: Who will win the 2028 U.S. presidential election?
  - slug: who-will-win-the-2028-us-presidential-election

    Market
    - question: Will Donald Trump win the 2028 U.S. presidential election?
    - slug: will-donald-trump-win-the-2028-us-presidential-election
    - conditionId: 0xabc...
    - token A: YES
    - token B: NO

Polymarket 的历史价格不是传统 OHLCV K 线,而是以 midpoint 为核心的价格历史。midpoint 是当前最优买价和最优卖价的平均值。前端通常显示 midpoint,当 spread 大于 0.10 美元时会回退显示最近成交价。实时订单簿是另一层数据,Polymarket 并不提供完整官方历史 LOB 档案。

OrderFilled

trade 是成交结果视角:它描述哪个市场发生了成交、涉及哪个 outcome、taker 的方向、撮合价格、总成交数量,以及吃掉了哪些 maker 订单。

OrderFilled 是链上 fill 事件视角。当成交通过 Exchange 合约结算时,合约会发出 fill 级事件,包含 orderHash、maker、taker、makerAssetId、takerAssetId、makerAmountFilled、takerAmountFilled 和 fee。简言之:trade 是成交回执;OrderFilled 是 fill 级账本。

Aggregated trade:
- side: BUY
- price: 0.52
- size: 100
- maker_orders: A 30, B 20, C 50

OrderFilled rows:
- A_SELL filled for 30
- B_SELL filled for 20
- C_SELL filled for 50

maker 和 taker 是某次成交中的角色,不是永久用户类别。order、trade、fill 和 transaction 也是不同层级:order 是指令,trade 是撮合结果,OrderFilled 是链上 fill 事件,transaction 是区块链结算记录。

Oracle

Oracle 数据解释市场如何离开交易阶段并形成最终结算结果。价格本身不能证明结算。oracle 层记录请求了什么答案、提出了什么结果、是否发生争议,以及最终如何结算。

许多 Polymarket 市场通过 UMA 相关 adapter 和 oracle 合约结算。生命周期可能包含问题初始化、请求、提议、争议和结算。polyData 会保存这些事件的交易哈希、日志索引、区块号、事件时间、提议价格、结算价格、参与者以及匹配元数据。

难点在身份匹配。有些 oracle 事件可以通过 question id 或 condition id 直接匹配;另一些则需要 adapter 映射、ancillary data 解码、标题/日期匹配,或 neg-risk request 映射。

Market lifecycle:
1. Discovered from Gamma, CLOB, or on-chain registry events
2. Made tradeable through condition id and outcome tokens
3. Actively traded through CLOB prices and OrderFilled flow
4. Closed or locked near the market end date
5. Reviewed through oracle request, proposal, dispute, and settlement
6. Resolved, final, and archived for historical analysis