Polymarket Real Time Trades Stream — Polymarket 实时交易流

Polymarket 预测交易 — 实时流媒体在 Polygon 此技能在 Polygon（matic）上提供实时流媒体 Polymarket 预测交易 feed，通过 WebSocket 实现。每个事件都是一个成功的预测交易，包括结果代币金额、抵押金（以 USD 计算）、价格（以 USD 计算）、买家/卖家地址、市场问题、结果标签（例如 "Up" / "Down"）和交易哈希。交易被过滤为 TransactionStatus.Success：true。该流使用 Bitquery 的 EVM.PredictionTrades 订阅，因此下游代码可以构建仪表盘、跟踪订单流或监控特定市场。官方文档：Polymarket API — 获取价格、交易和市场数据（Bitquery）。

安装前需要考虑的事项 此技能的代码实现了所描述的 Polymarket 流并仅联系 Bitquery。在安装前： 所需凭证：此技能需要 BITQUERY_API_KEY（您的 Bitquery API 令牌）。注册表元数据必须声明此凭证，以便安装程序提示提供它。验证注册表项列出 BITQUERY_API_KEY 作为所需的环境变量。 Critical 安全风险 — 令牌在 WebSocket URL 中：Bitquery 的 API 不支持基于头部的身份验证或除将令牌嵌入 WebSocket URL（例如？token=...）以外的任何方法。这是 API 的固有设计限制，而不是此技能的 bug。然而，它会产生重大泄露风险：令牌将始终存在于连接 URL 中的内存和任何日志或捕获的网络流量中。如果 URL 被打印、记录、捕获在 shell 历史、IDE 历史、代理日志、防火墙日志或监控系统中，令牌将被暴露。一旦暴露，任何拥有令牌的人都可以冒充您的帐户并消耗您的配额。 缓解措施：仅在安全的环境变量中存储密钥；永远不要打印或记录完整的 URL；如果您怀疑暴露，立即轮换密钥；在沙盒环境（virtualenv/容器）中运行以限制日志记录表面。 沙盒测试：在将此技能用于生产或共享环境之前，先在隔离环境（virtualenv、容器或专用机器）中测试它，以确认日志记录行为并确保 URL 不被系统监控或日志记录工具捕获。 源代码和发布者：验证发布者的身份和源代码访问权限。查看 scripts/stream_polymarket.py 中的代码，以确认脚本在使用前不会记录完整的 URL。

安全检查清单 在运行此技能之前，请确认： 您已在环境中设置 BITQUERY_API_KEY：export BITQUERY_API_KEY=your_token_here 您正在沙盒或隔离环境（virtualenv、Docker 或专用机器）中运行 日志记录和 shell 历史已禁用或监控以防止 URL 捕获：检查 HISTFILE、.bash_history、系统日志、IDE 调试输出 您了解 WebSocket URL 将包含您的 API 令牌的明文形式在内存中 您有一个计划来轮换您的密钥，如果它被暴露 您不会打印、记录或提交完整的 URL 到任何文件或日志记录系统 如果这些条件中有任何一个无法确认，请不要继续使用此技能，直到这些条件得到满足。

先决条件 环境：BITQUERY_API_KEY — 您的 Bitquery API 令牌（必需）。 URL-only 身份验证（Bitquery API 限制）：Bitquery 的流媒体端点仅接受 URL 中的令牌作为查询参数（？token=...）。它不支持基于头部的身份验证或 Bearer 令牌。此设计选择意味着： 令牌嵌入在连接 URL 中，并将存在于内存、网络跟踪和任何捕获完整 URL 的日志中 永远不要在任何上下文中打印、记录或发出完整的 WebSocket URL 始终从环境变量构造 URL 并仅将其传递给 WebSocket 传输 如果 URL 出现在 shell 历史、日志、IDE 调试器或网络监控中，令牌将被泄露 如果您怀疑它被记录或捕获，立即轮换您的 API 密钥 仅在控制环境中运行此脚本，在那里日志记录和监控被安全配置。 运行时：Python 3.8+ 和 pip。安装依赖项：pip install 'gql[websockets]'。

交易者使用案例 这些是交易者使用此 feed 的主要原因：

• 订单流/市场活动

监控每个填充订单：买家、卖家、抵押金（以 USD 计算）、价格（以 USD 计算）和结果（是/否或上/下）。确定哪些市场最活跃，哪一方（买方 vs 卖方）占主导地位。

• 鲸鱼/大交易检测

通过 CollateralAmountInUSD 或 Amount 过滤以显示大型预测市场交易。用于跟踪智能资金流入特定结果。

• 市场特定监控

使用 Question.MarketId、Question.Title 或 Question.Id 来过滤流媒体到单个市场（例如 "Ethereum 上/下 - 3 月 10 日"），并实时跟踪该市场的所有交易。

• 结果不平衡

通过 Outcome.Label（例如 "Up" vs "Down"）和 IsOutcomeBuy 聚合交易，以查看每个结果的净买入压力 —— 对于情绪或动量分析有用。 5.