Polymarket Monitor 用于实时监控 Polymarket 预测市场的价格变化、成交量激增和价差移动，当跨越设定阈值时输出结构化 JSON 告警。其所有端点均为只读，且不需要 API 密钥。
前提条件：该技能使用来自 polymarket-scanner 技能的 token ID，需先运行 scan_markets.py 发现市场并获取 token ID。
快速开始：所有脚本需要位于 /home/verticalclaw/.venv 的 Python 虚拟环境。
监控多个市场的价格告警：
source /home/verticalclaw/.venv/bin/activate && python polymarket-monitor/scripts/monitor_prices.py
--token-id "<TOKEN_ID_1>"
--token-id "<TOKEN_ID_2>"
--interval 30
--threshold 5.0
该命令每 30 秒轮询一次，当某 token 的中间价相对基线变动超过 5% 时打印一条 JSON 告警。
实时观察单个市场：
source /home/verticalclaw/.venv/bin/activate && python polymarket-monitor/scripts/watch_market.py
--token-id "<TOKEN_ID>"
--interval 15
每 15 秒打印一次 JSON 快照，包含价格、价差和订单簿深度。
脚本说明：
monitor_prices.py：按设定间隔轮询多个 token，当价格变化超过阈值时发出 JSON 告警。 参数： --token-id ID — 要监控的 CLOB token ID（可重复，至少一个） --interval N — 轮询间隔秒数（默认 30，最小 5） --threshold N — 触发告警的百分比变化（默认 5.0） --max-polls N — 轮询 N 次后停止（默认无限，用于非交互式运行） --baseline-window N — 用于计算基线的近期价格数量（默认 1，即与上次轮询比较） 输出：每条告警输出一个 JSON 对象，每行一个： { "type": "price_alert", "token_id": "...", "timestamp": "2026-02-26T12:00:00Z", "current_price": 0.65, "baseline_price": 0.60, "change_pct": 8.33, "direction": "up", "spread": 0.02, "poll_number": 5 } 非告警轮询会向 stderr 打印状态行，以便智能体知道监控处于活动状态。
watch_market.py：持续监控单个市场，每个间隔打印一个 JSON 快照，包含价格、价差、成交量和订单簿摘要。 参数： --token-id ID — 要观察的 CLOB token ID（必填） --interval N — 快照间隔秒数（默认 15，最小 5） --max-polls N — 快照 N 次后停止（默认无限） 输出：每个快照输出一个 JSON 对象，每行一个： { "type": "market_snapshot", "token_id": "...", "timestamp": "2026-02-26T12:00:00Z", "midpoint": 0.55, "best_bid": 0.54, "best_ask": 0.56, "spread": 0.02, "bid_depth": 15000.0, "ask_depth": 12000.0, "last_trade_price": 0.55, "last_trade_side": "BUY", "poll_number": 1 }
数据流：先运行 polymarket-scanner/scripts/scan_markets.py 查找市场并获取 token ID；将 token ID 传给 monitor_prices.py 进行多市场告警；或将单个 token ID 传给 watch_market.py 进行详细的单市场跟踪。
监控指南：关于按市场类型推荐的阈值和高级监控策略，参见 references/monitoring-guide.md。