SaturnX
  • WELCOME
    • ☀️What is Saturnx?
    • Pricing with Rate limits
      • Prepaid Credits
      • Pay with Crypto
  • RPC Nodes
    • RPCs Overview
  • BLOCKCHAIN
    • Overview
    • HTTP
      • getHistoryCandleStick
      • getHistoryTransaction
      • getAccountTnx
      • getAccountTnxByToken
      • getHoldersTop
      • getHotPairs
      • getTokenSecurity
    • WebSocket
      • {blockchain}.broadcast.transactions
      • {blockchain}.broadcast.kline
    • Kafka
Powered by GitBook
On this page
  • Subscription Overview
  • Subscription Setup
  1. BLOCKCHAIN
  2. WebSocket

{blockchain}.broadcast.transactions

The {blockchain}.broadcast.transactions subscription provides real-time notifications for transactions broadcasted to the Solana blockchain via a WebSocket connection.

Subscription Overview

  • Connection Address: wss://stream.saturnx.dev/skt

  • Type: WebSocket Subscription

  • Topic: {blockchain}.broadcast.transactions

  • Purpose: Receive real-time transaction data broadcasted on the Solana network.

  • Response Type: JSON object containing transaction details.

Subscription Setup

Connection Details

  • Endpoint: wss://stream.saturnx.dev/skt

  • Protocol: WebSocket (WSS for secure connection)

  • Authentication: Requires an apiKey in the subscription request.

Subscription Request

To subscribe, send the following JSON message after establishing the WebSocket connection:

{
  "type": "subscribe",
  "topic": "{blockchain}.broadcast.transactions",
  "apiKey": ""
}

Field

Type

Required

Description

Example Value

type

String

Yes

Action type (must be "subscribe")

subscribe

topic

String

Yes

Subscription topic

{blockchain}.broadcast.transactions

apiKey

String

Yes

API key for authentication

Response FormatOnce subscribed, the server will push real-time transaction data in the following JSON format:json

{
  "blockTime": "2025-03-19T03:41:08Z",
  "dexAddress": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
  "dexName": "raydium_amm",
  "dexProtocol": "Raydium",
  "inputAmount": "9656.511228",
  "inputName": "NEW SOLANA PUPPY",
  "inputPrice": "0.000010355706904791888",
  "inputPriceUsd": "0.0012929946085872667",
  "inputSymbol": "TEDDY",
  "inputToken": "FnEWN3gQbDFy4R3StYTws1HbihSA7WZxkq1PzRrQ2VhS",
  "isSuccess": true,
  "outputAmount": "0.100000000",
  "outputName": "Wrapped Solana",
  "outputPrice": "96565.11228",
  "outputPriceUsd": "0",
  "outputSymbol": "WSOL",
  "outputToken": "So11111111111111111111111111111111111111112",
  "outputTokenFromAccount": "9PJmHcRXnNq1RJQnLKsCn3QfSQxcH8rKXDvz78wai45h",
  "ownerAccount": "9PJmHcRXnNq1RJQnLKsCn3QfSQxcH8rKXDvz78wai45h",
  "signature": "b1ogiyhN7NA1LRmTxbgD4tC4k1j5jKCxN3othZCW6xw7xk6dfLq1kN8sxWHMFuTe8GU2oQak3ZkptTZ7yBHN8a6"
}

Field

Type

Description

blockTime

String

UTC timestamp of the transaction’s block in ISO 8601 format (e.g.,YYYY-MM-DDThh:mm:ssZ).

dexAddress

String

Address of the decentralized exchange (DEX) involved in the transaction.

dexName

String

Name of the DEX (e.g., "raydium_amm").

dexProtocol

String

Protocol used by the DEX (e.g., "Raydium").

inputAmount

String

Amount of the input token in the transaction, as a string for precision.

inputName

String

Name of the input token (e.g., "NEW SOLANA PUPPY").

inputPrice

String

Price per unit of the input token, as a string for precision.

inputPriceUsd

String

USD value of the input token at the time of the transaction.

inputSymbol

String

Ticker symbol of the input token (e.g., "TEDDY").

inputToken

String

Address of the input token on the blockchain.

isSuccess

Boolean

Indicates if the transaction was successful (true) or failed (false).

outputAmount

String

Amount of the output token in the transaction, as a string for precision.

outputName

String

Name of the output token (e.g., "Wrapped Solana").

outputPrice

String

Price per unit of the output token, as a string for precision.

outputPriceUsd

String

USD value of the output token at the time of the transaction.

outputSymbol

String

Ticker symbol of the output token (e.g., "WSOL").

outputToken

String

Address of the output token on the blockchain.

outputTokenFromAccount

String

Account from which the output token was sourced.

ownerAccount

String

Account that initiated or owns the transaction.

signature

String

Unique cryptographic signature of the transaction for verification.

PreviousWebSocketNext{blockchain}.broadcast.kline

Last updated 1 month ago