订单簿结构

Polymarket 使用中央限价订单簿（CLOB）：

Order Book for "YES" Token
--------------------------
BIDS (Buy Orders)     |  ASKS (Sell Orders)
$0.62 - 500 shares    |  $0.64 - 300 shares
$0.61 - 1000 shares   |  $0.65 - 800 shares
$0.60 - 2000 shares   |  $0.66 - 1500 shares

• 买价：买方愿意支付的最高价格
• 卖价：卖方愿意接受的最低价格
• 价差：最佳买价与最佳卖价之间的差额
• 中间价：（最佳买价 + 最佳卖价）/ 2

交易机制

订单类型

仓位管理

• 买入 YES：如果结果为真则盈利（以 $1.00 结算）
• 买入 NO：如果结果为假则盈利（以 $1.00 结算）
• 卖出：通过将代币卖回订单簿来平仓
• 合并：合并 YES + NO 代币以赎回 $1.00 USDC

费用

• 挂单费：约 0%（提供流动性）
• 吃单费：约 1-2%（消耗流动性）
• 费用可能变动；请查看当前费用表

结算与裁决

1. 交易停止：市场在 end_date_iso 停止接受订单
2. 裁决：预言机确定结果
3. 结算：
   • 获胜代币可赎回 $1.00 USDC
   • 失败代币变得一文不值（$0.00）
4. 赎回：用户通过智能合约领取奖金

API 约定

基础 URL

公共端点（无需认证）

认证端点

认证

Polymarket 使用 EIP-712 签名进行认证：

Headers:
  POLY_ADDRESS: <wallet_address>
  POLY_SIGNATURE: <eip712_signature>
  POLY_TIMESTAMP: <unix_timestamp>
  POLY_NONCE: <random_nonce>

WebSocket（实时更新）

连接到 wss://ws-subscriptions-clob.polymarket.com/ws/ 以获取：

• price - 实时价格更新
• book - 订单簿变动
• trades - 交易执行通知

API 响应示例

市场对象

{
  "condition_id": "0x1234...",
  "question": "Will Team Liquid win the CS2 Major?",
  "tokens": [
    {
      "token_id": "12345",
      "outcome": "Yes",
      "price": 0.65
    },
    {
      "token_id": "12346",
      "outcome": "No",
      "price": 0.35
    }
  ],
  "volume": "150000.00",
  "liquidity": "25000.00",
  "end_date_iso": "2024-03-15T00:00:00Z",
  "active": true,
  "closed": false
}

订单簿响应

{
  "token_id": "12345",
  "bids": [
    {"price": "0.64", "size": "500"},
    {"price": "0.63", "size": "1000"}
  ],
  "asks": [
    {"price": "0.66", "size": "300"},
    {"price": "0.67", "size": "800"}
  ]
}

体育与电子竞技市场

Polymarket 提供各种体育和电子竞技博彩市场。理解命名约定和市场结构对于跨平台匹配市场至关重要。

支持的类别

市场命名约定

Polymarket 体育市场通常遵循以下模式：

Match Winner:
  "Will [Team A] beat [Team B]?"
  "Will [Team A] win against [Team B]?"
  "[Team A] vs [Team B] - Winner"

Tournament Winner:
  "Will [Team/Player] win [Tournament]?"
  "[Tournament] Winner: [Team/Player]"

Player Props:
  "Will [Player] score [X] points?"
  "Will [Player] get [X] kills?"

常见名称变体

跨平台匹配市场时，请注意以下变体：

电子竞技特定模式

CS2（反恐精英 2）

Market formats:
  "Will Team Liquid win vs FaZe Clan?"
  "Team Liquid vs FaZe - CS2 Major"
  "CS2 Major Champion: Team Liquid"

Common tournaments:
  - Major Championships (Copenhagen, Shanghai)
  - ESL Pro League
  - BLAST Premier
  - IEM (Intel Extreme Masters)

英雄联盟

Market formats:
  "Will T1 win Worlds 2024?"
  "T1 vs Gen.G - LCK Finals"
  "League of Legends World Champion"

Common tournaments:
  - Worlds (World Championship)
  - MSI (Mid-Season Invitational)
  - LCK, LEC, LCS (Regional leagues)

无畏契约

Market formats:
  "Will Sentinels win VCT Champions?"
  "Sentinels vs LOUD - VCT Finals"

Common tournaments:
  - VCT Champions
  - VCT Masters
  - Regional Challengers

使命召唤

Market formats:
  "Will OpTic win CDL Championship?"
  "OpTic vs FaZe - CDL Major"

Common tournaments:
  - CDL (Call of Duty League) Majors
  - CDL Championship
  - Warzone events

传统体育模式

NBA 篮球

Market formats:
  "Will the Lakers beat the Celtics?"
  "Lakers vs Celtics - NBA Finals Game 1"
  "NBA Champion 2024"

Identifiers:
  - Team city + name (Los Angeles Lakers)
  - Just team name (Lakers)
  - Abbreviations (LAL)

足球

Market formats:
  "Will Manchester City beat Arsenal?"
  "Man City vs Arsenal - Premier League"
  "Champions League Winner 2024"

Leagues/Tournaments:
  - Premier League (England)
  - La Liga (Spain)
  - Serie A (Italy)
  - Bundesliga (Germany)
  - UEFA Champions League
  - UEFA Europa League
  - World Cup

NFL 橄榄球

Market formats:
  "Will the Chiefs beat the Eagles?"
  "Chiefs vs Eagles - Super Bowl"
  "Super Bowl LVIII Winner"

Identifiers:
  - City + name (Kansas City Chiefs)
  - Just name (Chiefs)
  - Abbreviations (KC)

网球

Market formats:
  "Will Djokovic win Wimbledon?"
  "Djokovic vs Alcaraz - Wimbledon Final"
  "US Open Men's Singles Winner"

Tournaments:
  - Grand Slams: Australian Open, French Open, Wimbledon, US Open
  - ATP/WTA Masters events

综合格斗/UFC

Market formats:
  "Will Jon Jones beat Stipe Miocic?"
  "Jones vs Miocic - UFC 309"
  "UFC Heavyweight Champion after UFC 309"

Identifiers:
  - Fighter full name
  - Last name only
  - Nickname ("Bones" for Jon Jones)

体育市场的 API 过滤

以编程方式查找体育市场：

// Filter by tags/categories
GET /markets?tag=sports
GET /markets?tag=esports
GET /markets?tag=nba
GET /markets?tag=cs2

// Search by keywords in question
GET /markets?search=NBA
GET /markets?search=Team%20Liquid
GET /markets?search=UFC

// Filter active sports markets
GET /markets?active=true&tag=sports

市场匹配策略

对于跨平台套利，使用以下匹配方法：

1. 标准化队伍/选手名称

   • 移除特殊字符：FaZe Clan → faze clan
   • 处理缩写：TL → team liquid
   • 映射昵称：NaVi → natus vincere

2. 提取关键实体

   • 队伍 A 名称
   • 队伍 B 名称
   • 锦标赛/联赛名称
   • 比赛日期/时间

3. 基于相似度匹配

   • 使用莱文斯坦距离进行模糊匹配
   • 多词名称的标记重叠
   • 相同对阵的日期接近度

4. 验证市场类型

   • 两个市场必须是"比赛获胜者"类型
   • 涉及相同的队伍/选手
   • 相同的事件时间范围

示例：跨平台匹配

Polymarket Market:
  Question: "Will Team Liquid beat G2 Esports?"
  YES price: $0.55
  End date: 2024-03-15

Kalshi Market:
  Title: "Team Liquid vs G2 - CS2 Major Semifinal"
  YES price: $0.52
  NO price: $0.51

Matching confidence: HIGH
- Same teams (Team Liquid, G2)
- Similar timeframe
- Both match-winner markets

Arbitrage check:
  Polymarket NO: $0.45
  Kalshi YES: $0.52
  Total: $0.97 → $0.03 profit potential

应用指导

回答关于 Polymarket 的问题时：

1. 澄清术语：解释价格代表隐含概率
2. 强调 CLOB：与 AMM 不同，Polymarket 使用限价订单
3. 解释代币：YES/NO 是独立的可交易 ERC-1155 代币
4. 注意费用：吃单费会降低利润率
5. 提及结算：获胜代币恰好以 $1.00 赎回
6. 保持中立：不提供财务建议或预测

套利背景（ArbiBot）

对于与 Kalshi 的跨平台套利：

有效套利策略

当总成本 < $1.00 时，跨平台买入相反的结果：

Example:
  Polymarket YES @ $0.45
  Kalshi NO @ $0.48
  Total Cost: $0.93
  Guaranteed Profit: $0.07 (one side pays $1.00)

示例

解释价格

"YES 代币以 $0.72 交易意味着市场集体估计该结果发生的概率为 72%。"

描述订单执行

"您以 $0.65 买入 100 份 YES 份额的限价订单将保留在订单簿中，直到有人以该价格或更低价格卖出。"

结算解释

"如果 Team Liquid 获胜，您的 YES 代币将以每个 $1.00 结算。如果他们输了，这些代币将变得一文不值，但任何 NO 代币将支付 $1.00。"

参考

• Polymarket CLOB 文档
• Polymarket API 参考
• 条件代币框架

每周安装数

174

代码仓库

axwelbrand-byte/arbibot

首次出现

2026年1月22日

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

gemini-cli144

opencode143

codex139

github-copilot133

cursor130

kimi-cli119

Market Objects

Key fields in Polymarket market data:

Order Book Structure

Polymarket uses a Central Limit Order Book (CLOB) :

Order Book for "YES" Token
--------------------------
BIDS (Buy Orders)     |  ASKS (Sell Orders)
$0.62 - 500 shares    |  $0.64 - 300 shares
$0.61 - 1000 shares   |  $0.65 - 800 shares
$0.60 - 2000 shares   |  $0.66 - 1500 shares

• Bid : Highest price buyers will pay
• Ask : Lowest price sellers will accept
• Spread : Difference between best bid and ask
• Mid Price : (Best Bid + Best Ask) / 2

Trading Mechanics

Order Types

Position Management

• Buy YES : Profit if outcome is true (settles at $1.00)
• Buy NO : Profit if outcome is false (settles at $1.00)
• Sell : Close position by selling tokens back to order book
• Merge : Combine YES + NO tokens to redeem $1.00 USDC

Fees

• Maker Fee : ~0% (providing liquidity)
• Taker Fee : ~1-2% (taking liquidity)
• Fees may vary; check current fee schedule

Settlement & Resolution

1. Trading Closes : Market stops accepting orders at end_date_iso
2. Resolution : Oracle determines the outcome
3. Settlement :
   • Winning tokens redeem for $1.00 USDC
   • Losing tokens become worthless ($0.00)
4. Redemption : Users claim winnings via smart contract

API Conventions

Base URLs

Public Endpoints (No Auth)

Authenticated Endpoints

Authentication

Polymarket uses EIP-712 signatures for authentication:

Headers:
  POLY_ADDRESS: <wallet_address>
  POLY_SIGNATURE: <eip712_signature>
  POLY_TIMESTAMP: <unix_timestamp>
  POLY_NONCE: <random_nonce>

WebSocket (Real-time Updates)

Connect to wss://ws-subscriptions-clob.polymarket.com/ws/ for:

• price - Real-time price updates
• book - Order book changes
• trades - Trade execution notifications

API Response Examples

Market Object

{
  "condition_id": "0x1234...",
  "question": "Will Team Liquid win the CS2 Major?",
  "tokens": [
    {
      "token_id": "12345",
      "outcome": "Yes",
      "price": 0.65
    },
    {
      "token_id": "12346",
      "outcome": "No",
      "price": 0.35
    }
  ],
  "volume": "150000.00",
  "liquidity": "25000.00",
  "end_date_iso": "2024-03-15T00:00:00Z",
  "active": true,
  "closed": false
}

Order Book Response

{
  "token_id": "12345",
  "bids": [
    {"price": "0.64", "size": "500"},
    {"price": "0.63", "size": "1000"}
  ],
  "asks": [
    {"price": "0.66", "size": "300"},
    {"price": "0.67", "size": "800"}
  ]
}

Sports & Esports Markets

Polymarket hosts various sports and esports betting markets. Understanding the naming conventions and market structures is critical for matching markets across platforms.

Supported Categories

Market Naming Conventions

Polymarket sports markets typically follow these patterns:

Match Winner:
  "Will [Team A] beat [Team B]?"
  "Will [Team A] win against [Team B]?"
  "[Team A] vs [Team B] - Winner"

Tournament Winner:
  "Will [Team/Player] win [Tournament]?"
  "[Tournament] Winner: [Team/Player]"

Player Props:
  "Will [Player] score [X] points?"
  "Will [Player] get [X] kills?"

Common Name Variations

When matching markets across platforms, watch for these variations:

Esports-Specific Patterns

CS2 (Counter-Strike 2)

Market formats:
  "Will Team Liquid win vs FaZe Clan?"
  "Team Liquid vs FaZe - CS2 Major"
  "CS2 Major Champion: Team Liquid"

Common tournaments:
  - Major Championships (Copenhagen, Shanghai)
  - ESL Pro League
  - BLAST Premier
  - IEM (Intel Extreme Masters)

League of Legends

Market formats:
  "Will T1 win Worlds 2024?"
  "T1 vs Gen.G - LCK Finals"
  "League of Legends World Champion"

Common tournaments:
  - Worlds (World Championship)
  - MSI (Mid-Season Invitational)
  - LCK, LEC, LCS (Regional leagues)

Valorant

Market formats:
  "Will Sentinels win VCT Champions?"
  "Sentinels vs LOUD - VCT Finals"

Common tournaments:
  - VCT Champions
  - VCT Masters
  - Regional Challengers

Call of Duty

Market formats:
  "Will OpTic win CDL Championship?"
  "OpTic vs FaZe - CDL Major"

Common tournaments:
  - CDL (Call of Duty League) Majors
  - CDL Championship
  - Warzone events

Traditional Sports Patterns

NBA Basketball

Market formats:
  "Will the Lakers beat the Celtics?"
  "Lakers vs Celtics - NBA Finals Game 1"
  "NBA Champion 2024"

Identifiers:
  - Team city + name (Los Angeles Lakers)
  - Just team name (Lakers)
  - Abbreviations (LAL)

Soccer/Football

Market formats:
  "Will Manchester City beat Arsenal?"
  "Man City vs Arsenal - Premier League"
  "Champions League Winner 2024"

Leagues/Tournaments:
  - Premier League (England)
  - La Liga (Spain)
  - Serie A (Italy)
  - Bundesliga (Germany)
  - UEFA Champions League
  - UEFA Europa League
  - World Cup

NFL Football

Market formats:
  "Will the Chiefs beat the Eagles?"
  "Chiefs vs Eagles - Super Bowl"
  "Super Bowl LVIII Winner"

Identifiers:
  - City + name (Kansas City Chiefs)
  - Just name (Chiefs)
  - Abbreviations (KC)

Tennis

Market formats:
  "Will Djokovic win Wimbledon?"
  "Djokovic vs Alcaraz - Wimbledon Final"
  "US Open Men's Singles Winner"

Tournaments:
  - Grand Slams: Australian Open, French Open, Wimbledon, US Open
  - ATP/WTA Masters events

MMA/UFC

Market formats:
  "Will Jon Jones beat Stipe Miocic?"
  "Jones vs Miocic - UFC 309"
  "UFC Heavyweight Champion after UFC 309"

Identifiers:
  - Fighter full name
  - Last name only
  - Nickname ("Bones" for Jon Jones)

API Filtering for Sports Markets

To find sports markets programmatically:

// Filter by tags/categories
GET /markets?tag=sports
GET /markets?tag=esports
GET /markets?tag=nba
GET /markets?tag=cs2

// Search by keywords in question
GET /markets?search=NBA
GET /markets?search=Team%20Liquid
GET /markets?search=UFC

// Filter active sports markets
GET /markets?active=true&tag=sports

Market Matching Strategy

For cross-platform arbitrage, use this matching approach:

1. Normalize team/player names

   • Remove special characters: FaZe Clan → faze clan
   • Handle abbreviations: TL → team liquid
   • Map nicknames: NaVi → natus vincere

2. Extract key entities

   • Team A name
   • Team B name
   • Tournament/League name
   • Match date/time

3. Match by similarity

   • Levenshtein distance for fuzzy matching
   • Token overlap for multi-word names
   • Date proximity for same matchup

4. Verify market type

   • Both markets must be "match winner" type
   • Same teams/players involved
   • Same event timeframe

Example: Cross-Platform Match

Polymarket Market:
  Question: "Will Team Liquid beat G2 Esports?"
  YES price: $0.55
  End date: 2024-03-15

Kalshi Market:
  Title: "Team Liquid vs G2 - CS2 Major Semifinal"
  YES price: $0.52
  NO price: $0.51

Matching confidence: HIGH
- Same teams (Team Liquid, G2)
- Similar timeframe
- Both match-winner markets

Arbitrage check:
  Polymarket NO: $0.45
  Kalshi YES: $0.52
  Total: $0.97 → $0.03 profit potential

Application Guidance

When answering questions about Polymarket:

1. Clarify terminology : Explain that prices represent implied probabilities
2. Highlight CLOB : Unlike AMMs, Polymarket uses limit orders
3. Explain tokens : YES/NO are separate tradeable ERC-1155 tokens
4. Note fees : Taker fees reduce profit margins
5. Mention settlement : Winning tokens redeem at exactly $1.00
6. Stay neutral : Do not provide financial advice or predictions

Arbitrage Context (ArbiBot)

For cross-platform arbitrage with Kalshi:

Valid Arbitrage Strategy

Buy opposing outcomes across platforms when total cost < $1.00:

Example:
  Polymarket YES @ $0.45
  Kalshi NO @ $0.48
  Total Cost: $0.93
  Guaranteed Profit: $0.07 (one side pays $1.00)

Examples

Explaining a Price

"The YES token trading at $0.72 means the market collectively estimates a 72% probability of this outcome occurring."

Describing Order Execution

"Your limit order to buy 100 YES shares at $0.65 will sit in the order book until someone sells at that price or lower."

Settlement Explanation

"If Team Liquid wins, your YES tokens settle at $1.00 each. If they lose, those tokens become worthless, but any NO tokens would pay out $1.00."

References

• Polymarket CLOB Documentation
• Polymarket API Reference
• Conditional Token Framework

Weekly Installs

174

Repository

axwelbrand-byte/arbibot

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

gemini-cli144

opencode143

codex139

github-copilot133

cursor130

kimi-cli119