WebSocket API for Real-Time Transaction Monitoring

The Ranger Data API provides a WebSocket-based real-time transaction monitoring service, allowing clients to observe Solana transactions and receive updates when they are processed. The implementation follows a GraphQL-like subscription protocol and includes features such as automatic timeouts, connection management, and Redis PubSub integration.

Currently the Beta URL is using the data api

wss://data-api-staging-437363704888.asia-northeast1.run.app/v1/observe_tx?tx_signature=4gL5mR9XJJMZJYDkR4YR...&user_id=user123

WebSocket API Overview

The WebSocket API allows clients to:

Monitor transactions in real-time
Receive immediate notifications when transactions are confirmed
Track status updates for orders placed through the SOR API
Maintain a persistent connection for low-latency updates

Connection Endpoints

wss://data-api-staging-437363704888.asia-northeast1.run.app/v1/observe_tx

Query Parameters

Parameter	Type	Required	Description
tx_signature	string	Yes	The Solana transaction signature to monitor
user_id	string	No	Optional user identifier for analytics and tracking

Example Connection URL

wss://data-api-staging-437363704888.asia-northeast1.run.app/v1/observe_tx?tx_signature=4gL5mR9XJJMZJYDkR4YR...&user_id=user123

Connection Lifecycle

Connection Establishment
- Client connects to the WebSocket endpoint with required query parameters
- Connection is established and tracked in server statistics

Table of Contents

WebSocket API Overview

Connection Endpoints

Query Parameters

Example Connection URL

Connection Lifecycle