Polymarket Real Time Trades Stream 是一个专为 Polygon 链上的 Polymarket 预测市场设计的实时数据流工具。它通过 WebSocket 协议提供高频率、低延迟的交易事件推送，覆盖所有成功成交的预测交易记录。每条数据包含完整的交易细节，包括买方与卖方地址、抵押金额（以美元计价）、成交价、结果标签（如“上涨”或“下跌”）、市场问题描述以及对应的区块链交易哈希。该工具基于 Bitquery 的 EVM.PredictionTrades 订阅接口构建，确保数据源可靠且结构清晰，适合开发者快速接入并用于构建交易监控面板或分析系统。 使用本工具前需注意关键安全限制：Bitquery API 仅支持将认证令牌直接嵌入 WebSocket URL 中传递（格式为 `?token=…`），不支持头部认证或其他加密方式。这意味着 API 密钥会明文出现在内存和网络流量中，存在泄露风险。因此强烈建议仅在隔离环境（如容器或虚拟环境）中运行，并避免打印、记录或暴露完整连接 URL。一旦怀疑密钥泄露，应立即更换新密钥以保障账户安全。此外，用户需提前获取 Bitquery API 密钥并配置为环境变量 `BITQUERY_API_KEY`，否则程序将无法启动。
核心功能特点
- 实时流式传输 Polygon 链上 Polymarket 的所有成功预测交易
- 每条交易包含买方/卖方地址、抵押金额（USD）、成交价（USD）及结果标签
- 支持按市场 ID、标题或结果类型过滤特定事件流
- 集成完整的链上审计信息：交易哈希、区块时间戳、调用签名与日志签名
- 适用于订单流分析、鲸鱼交易识别与市场情绪监测
适用场景
该工具特别适合量化交易员和做市商用于实时监控预测市场的资金流向与价格动态。例如，交易者可以通过监听大额成交（CollateralAmountInUSD）来识别‘鲸鱼’动向，判断是否有机构资金集中押注某一结果，从而辅助入场时机决策。同时，结合 `IsOutcomeBuy` 字段可追踪多空力量对比，发现市场情绪转折点。对于高频策略而言，实时价格变动（PriceInUSD）提供了极佳的流动性参考点，有助于优化买卖价差和执行效率。 除了个人交易用途，该数据流还可服务于数据验证平台或第三方行情聚合服务。开发者可利用 `Question.ResolutionSource` 筛选出依赖预言机（如 Chainlink）的数据驱动型市场，在临近结算时观察交易量变化，评估市场对最终结果的预期稳定性。此外，通过持续监控 `Marketplace.ProtocolName` 可确保数据纯净性，排除来自 Gnosis CTF 等其他协议的干扰。整个系统设计强调可扩展性，允许下游应用自由组合字段进行聚合分析，比如统计某时间段内各结果的净买入量，生成可视化热力图或触发自动化警报机制。