用途:GoldRush Streaming API 用于获取实时区块链数据,通过 WebSocket 上的 GraphQL 订阅推送,延迟为亚秒级,适合实时行情与链上监控场景。
主要能力:提供两类端点。订阅类(WebSocket 实时推送)覆盖按代币或交易对的 OHLCV 价格K线、新 DEX 交易对创建、交易对更新(价格/流动性/成交量)以及钱包活动;查询类(一次性 GraphQL 获取)覆盖代币搜索与交易者盈亏分析。价格来源包括 DEX 兑换事件,以及部分链上的链上预言机喂价(如 MegaETH 上的 Redstone Bolt,更新频率 2.4ms)。
使用方式:官方建议优先使用 GoldRush Client SDK,它提供自动认证、连接管理、重试逻辑与类型安全。安装命令为 npm install @covalenthq/client-sdk。示例中通过 GoldRushClient 创建客户端并调用 StreamingService.subscribeToOHLCVTokens 等订阅方法。若需避免 SDK 依赖,可使用 graphql-ws 等 GraphQL WebSocket 客户端。关键规则:链名使用 SCREAMING_SNAKE_CASE(如 ETH_MAINNET);WebSocket 地址为 wss://streaming.goldrushdata.com/graphql;协议头为 Sec-WebSocket-Protocol: graphql-transport-ws;认证载荷为 { "type": "connection_init", "payload": { "GOLDRUSH_API_KEY": "YOUR_KEY" } }。注意认证错误是延迟的,connection_ack 总是成功,认证错误仅在订阅开始时出现。SDK 使用单例 WebSocket 复用连接,完成后应调用返回的取消订阅函数,调用 disconnect() 关闭全部连接。
适用场景:实时价格K线、新交易对监控、交易对状态跟踪、钱包活动流、代币搜索与交易者盈亏分析。
限制:与 Foundational API 不同,本 API 使用 GraphQL over WebSocket 而非 REST,链名格式与认证方式也不同;具体支持的链与 DEX 列表、完整参数与响应结构需查阅参考文件(overview.md、endpoints.md、sdk-guide.md)。