Polymarket 工具集用于访问 Polymarket 预测市场的数据并执行相关操作，重点覆盖体育预测市场。
用途 该工具主要面向 Polymarket 预测市场的查询与分析，涵盖实时赔率、价格、订单簿、事件、系列、市场搜索、排行榜、投资组合分析、交易以及链上操作。
主要能力 核心命令共 11 个，无需依赖或 API 密钥即可使用，包括：浏览体育市场（get_sports_markets）、浏览体育事件（get_sports_events）、列出系列/联赛（get_series）、市场详情（get_market_details）、事件详情（get_event_details）、当前 CLOB 价格（get_market_prices）、完整订单簿（get_order_book）、有效市场类型（get_sports_market_types）、关键词搜索（search_markets）、历史价格（get_price_history）、最近成交价（get_last_trade_price）。 CLI 命令共 30 多个，需要 Polymarket CLI 二进制文件，覆盖数据与分析（排行榜、持仓、已平仓持仓、投资组合价值、交易历史、活动流、持仓者、未平仓量、成交量、已交易市场）、搜索与标签发现（全文本搜索、标签列表、标签详情、相关标签）、评论与资料（评论、单条评论、用户评论、公开资料）、体育元数据（运动列表、按联赛查询队伍）、CLOB 附加信息（最小报价单位、费率）、交易（限价单、市价单、撤单、撤销全部订单、余额、挂单、用户成交）以及链上操作（CTF 拆分、合并、赎回，批准检查与设置）。
使用方式 官方推荐优先使用 CLI，以避免 Python 导入路径问题： sports-skills polymarket get_sports_markets --limit=20 sports-skills polymarket search_markets --query="NBA Finals"
Python SDK 作为替代方案： from sports_skills import polymarket markets = polymarket.get_sports_markets(limit=20) prices = polymarket.get_market_prices(token_id="abc123")
前提条件 核心命令（11 个）开箱即用，无需依赖和 API 密钥。 CLI 命令（30 多个）需要安装 Polymarket CLI 二进制： pip install sports-skills[polymarket] 或通过 Homebrew： brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli brew install polymarket 交易命令还需要配置钱包，提供三种方式： 方式 1 — 环境变量：export POLYMARKET_PRIVATE_KEY=0x... 方式 2 — Python SDK（按会话）：polymarket.configure(private_key="0x...") 方式 3 — CLI 配置文件（跨会话持久化）：polymarket wallet import <private-key>；polymarket approve set 如果 CLI 命令返回 "polymarket CLI not installed"，则使用 pip install sports-skills[polymarket] 安装。
重要说明 价格即为概率。价格 0.65 表示 65% 的隐含概率，无需转换。 token_id 与 market_id：价格和订单簿端点需要 CLOB token_id，而非 Gamma market_id，务必先调用 get_market_details 获取 clobTokenIds。 search_markets 匹配事件标题，而非运动类别，应使用具体联赛名称（"Premier League"、"Champions League"），而非泛称（"soccer"、"football"）。 cli_search_markets 是功能更强的 CLI 全文本搜索，当 search_markets 无结果时可使用。 复杂获取前可运行参数校验器：bash scripts/validate_params.sh <command> [args] 详细参考数据见 references/ 目录中的文件。
典型工作流 实时赔率检查：search_markets --query="<联赛/事件名>"，get_market_details --market_id=<id> 获取 CLOB token ID，get_market_prices --token_id=<id>，展示概率。 事件总览：get_sports_events --active=true，选事件后 get_event_details --event_id=<id>，对每个市场获取价格。 价格趋势分析：通过 search_markets 找市场，get_market_details 获取 token_id，get_price_history --token_id=<id> --interval=1w，展示价格走势。 投资组合分析（需 CLI）：get_positions --address=<钱包>、get_portfolio_value --address=<钱包>、get_trade_history --address=<钱包> --limit=20、get_activity --address=<钱包>。 市场分析（需 CLI）：get_holders --condition_id=<id>、get_open_interest --condition_id=<id>、get_volume --event_id=<id>。 排行榜（需 CLI）：get_leaderboard --period=week --order_by=pnl --limit=20，get_profile --address=<交易者地址>。 交易（需 CLI 与钱包）：get_balance --asset_type=collateral 查询 USDC 余额，cli_search_markets --query="NBA" 找市场，get_market_details --market_id=<id> 获取 token_id，create_order --token_id=<id> --side=buy --price=0.55 --size=10，get_orders 验证，cancel_order --order_id=<id> 撤单。
适用场景 适合查询体育预测市场的实时赔率与价格、浏览事件与系列、分析价格历史趋势、查看交易者排行榜、跟踪指定钱包的持仓与交易活动、进行市场持仓者与未平仓量分析，以及在配置钱包后执行限价单、市价单、撤单和 CTF 链上拆分/合并/赎回操作。
限制 CLI 命令需安装 Rust 二进制文件，交易与链上命令需配置钱包，工具本身不提供钱包资金。价格可能滞后，低流动性市场可能有较宽价差。若不存在对应市场，工具不会编造赔率或概率。