GoldRush Streaming API 是一款专为实时区块链数据设计的流式接口服务，通过 WebSocket 上的 GraphQL 订阅机制，为开发者提供低延迟的链上数据推送能力。该服务特别适用于需要秒级甚至亚秒级响应的金融监控、交易信号生成和实时市场数据分析等场景。与传统的 RESTful API 不同，GoldRush Streaming API 采用 push-based 的数据传输模式，能够主动向客户端推送 OHLCV（开盘价、最高价、最低价、收盘价、成交量）价格蜡烛图、去中心化交易所（DEX）配对创建事件、配对更新（包括价格、流动性、交易量变化）以及钱包活动状态等关键信息。其核心优势在于支持 sub-second 级别的延迟，确保用户能够在第一时间获取最新市场动态，从而构建高时效性的应用系统。 该 API 的设计充分考虑了开发者的实际使用体验，推荐优先使用官方提供的 GoldRush Client SDKs，这些 SDK 封装了复杂的 WebSocket 连接管理、自动重连逻辑、身份验证流程以及类型安全的接口调用，极大简化了集成难度。只有在特定约束条件下，如避免依赖外部库或需要更细粒度的控制时，才建议使用原生的 `graphql-ws` 客户端。目前支持的区块链网络包括 ETH_MAINNET、BASE_MAINNET 等主要公链，覆盖主流 DEX 的交易事件源，并整合了部分链上的预言机喂价数据，为用户提供多维度、高可靠性的实时数据流。 除了实时的订阅功能外，GoldRush Streaming API 还提供了有限的查询类操作，例如基于代币名称或符号的快速搜索，以及针对交易者盈亏分析的一次性查询接口。然而，其真正的价值体现在持续监听与即时响应的能力上。无论是监控某个特定代币的价格波动、追踪新上线 DEX 配对的出现，还是观察大额钱包地址的资金流动，该 API 都能以高效的方式满足需求。整体而言，它是一个面向高频数据消费场景的专业工具，适合搭建行情看板、量化策略引擎、DeFi 风险预警系统等对时效性要求极高的应用场景。
核心功能特点
- 基于 WebSocket 的 GraphQL 订阅机制，实现实时数据推送
- 支持 sub-second 级别的低延迟 OHLCV 价格蜡烛图流
- 可监听 DEX 新配对创建及现有配对的价格、流动性、交易量更新
- 提供钱包活动实时监控功能，捕捉链上资金动向
- 推荐使用官方 SDK 简化连接管理、认证与错误处理
- 支持多主流区块链网络（如 ETH_MAINNET、BASE_MAINNET）
适用场景
GoldRush Streaming API 最典型的应用场景是金融领域的实时行情监控系统。例如，在构建加密货币交易仪表盘时，开发者可以利用 `subscribeToOHLCVTokens` 接口持续接收特定代币的分钟级或小时级 K 线数据，结合前端图表库实时渲染价格走势，帮助用户快速判断市场趋势。对于量化交易团队而言，该 API 提供的超低延迟喂价能力至关重要——通过监听 DEX swap 事件直接计算真实成交价，避免中心化交易所 API 的潜在延迟或操纵风险，从而制定更精准的策略执行逻辑。 另一个重要用例是 DeFi 生态中的异常行为检测与风险管理。通过 `subscribeToWalletActivity` 订阅指定地址的交易流水，企业可以实时识别潜在的洗钱活动、巨鲸转账或合约交互异常，及时触发风控警报。同时，`subscribeToNewPairs` 和 `subscribeToPairUpdates` 组合使用，可用于发现新兴 DEX 项目并监控其早期流动性变化，辅助投资决策或套利机会挖掘。此外，在 NFT 市场或 GameFi 项目中，实时追踪钱包活动也有助于分析用户行为模式，优化产品体验。 尽管该 API 主打实时推送，但它也兼顾了灵活性。例如，当需要批量检索历史数据或进行离线分析时，虽然主要依赖 Foundational API，但 Streaming API 的查询端点（如 `searchTokens` 和 `getTradersPnl`）仍可作为补充手段，用于快速验证假设或生成报告。总体来看，任何需要‘所见即所得’式实时反馈的应用——从专业交易终端到社区情绪分析工具——都可以借助 GoldRush Streaming API 提升数据新鲜度与响应速度。