Polymarket

Polymarket — Sports Prediction Markets

Before writing queries, consult references/API-reference.md for sport codes, command parameters, and price 格式化.

Quick 启动

Prefer the 命令行工具 — it avoids Python 导入 path issues:

sports-技能s polymarket 搜索_markets --sport=nba --sports_market_types=moneyline sports-技能s polymarket 获取_todays_事件 --sport=epl sports-技能s polymarket 搜索_markets --sport=epl --查询="Leeds" --sports_market_types=moneyline sports-技能s polymarket 获取_sports_config

Python SDK (alternative):

from sports_技能s 导入 polymarket

polymarket.搜索_markets(sport='nba', sports_market_types='moneyline') polymarket.获取_todays_事件(sport='epl') polymarket.搜索_markets(sport='epl', 查询='Leeds') polymarket.获取_sports_config()

CRITICAL: Before Any 查询

CRITICAL: Before calling any market 端点, 验证:

The sport parameter is always passed to 搜索_markets and 获取_todays_事件 for single-game markets. Prices are probabilities on a 0-1 扩展 (0.65 = 65%) — no conversion needed. For price/orderbook 端点s, use 令牌_id (CLOB), not market_id (Gamma). Call 获取_market_detAIls first to 获取 clob令牌Ids.

Without the sport parameter:

WRONG: 搜索_markets(查询="Leeds") → 0 结果s RIGHT: 搜索_markets(sport='epl', 查询='Leeds') → returns all Leeds markets

Prerequisites

Core commands (no dependencies, no API keys): All read commands work out of the box.

Trading commands require py_clob_命令行工具ent:

pip 安装 sports-技能s[polymarket]

添加itionally requires a 配置d wallet:

导出 POLYMARKET_PRIVATE_KEY=0x...

工作流s Find Single-Game Markets for a Sport 搜索_markets --sport=nba (or epl, nfl, bun, etc.) Each market includes outcomes with prices (price = probability). For detAIled prices, use 获取_market_prices --令牌_id=. Today's 事件 for a League 获取_todays_事件 --sport=epl — returns 事件 排序ed by 启动 date. Each event includes nested markets (moneyline, spreads, totals, props). Pick a market, 获取 clob_令牌_id from outcomes, then 获取_market_prices. Live Odds 检查 搜索_markets --sport=nba --查询="Lakers" --sports_market_types=moneyline 获取_market_prices --令牌_id= for live CLOB prices. Present probabilities. Price Trend Analysis Find market via 搜索_markets --sport=nba. 获取 clob_令牌_id from the outcomes. 获取_price_历史 --令牌_id= --interval=1w Present price movement. Commands Command Description 获取_sports_config AvAIlable sport codes 获取_todays_事件 Today's 事件 for a league 搜索_markets Find markets by sport, keyword, and type 获取_sports_markets Browse all sports markets 获取_sports_事件 Browse sports 事件 获取_series 列出 series (leagues) 获取_market_detAIls Single market detAIls 获取_event_detAIls Single event detAIls 获取_market_prices Current CLOB prices 获取_order_book Full order book 获取_price_历史 Historical prices 获取_last_trade_price Most recent trade

See references/API-reference.md for full parameter 列出s and return shapes.

Examples

Example 1: Tonight's NBA favorites User says: "Who's favored in tonight's NBA games?" Actions:

Call 搜索_markets(sport='nba', sports_market_types='moneyline') 结果: Each matchup with implied win probabilities (price = probability)

Example 2: Team-specific odds User says: "Show me Leeds vs Man City odds" Actions:

Call 搜索_markets(sport='epl', 查询='Leeds', sports_market_types='moneyline') 结果: Leeds moneyline market with outcome prices

Example 3: Today's EPL 事件 User says: "What EPL matches are on today?" Actions:

Call 获取_todays_事件(sport='epl') 结果: Today's EPL 事件 with nested markets (moneyline, spreads, totals, props)

Example 4: League winner futures User says: "Who will win the Premier League?" Actions:

Call 搜索_markets(查询='Premier League') — returns futures 排序 结果s by Yes outcome price descending 结果: Top contenders ranked by win probability

Example 5: Bundesliga odds User says: "Show me Bundesliga odds for Dortmund vs Bayern" Actions:

Call 搜索_markets(sport='bun', 查询='Dortmund', sports_market_types='moneyline') 结果: Dortmund/Bayern moneyline market with outcome prices Commands that DO NOT exist — never call these 命令行工具_搜索_markets — does not exist. Use 搜索_markets instead. 命令行工具_sports_列出 — does not exist. Use 获取_sports_config instead. 获取_market_odds / 获取_odds / 获取_current_odds — prices ARE probabilities. Use 获取_market_prices(令牌_id=...). 获取_implied_probability — the price IS the implied probability. 获取_markets — use 获取_sports_markets (browse) or 搜索_markets (搜索). 获取_team_schedule — this is a football-data command, not polymarket.

If a command is not 列出ed in references/API-reference.md, it does not exist.

Troubleshooting

Error: 搜索_markets returns 0 结果s Cause: The sport parameter is missing — without it, 搜索 only 检查s high-volume markets and misses single-game 事件 Solution: Always pass sport='' to 搜索_markets. 检查 references/API-reference.