parsedTransactionSubscribe

Subscribe to decoded Solana transactions matching a filter by program, account, and instruction name. Receive whole transactions with named arguments and accounts.

Start a subscription. Every confirmed transaction that matches your filter arrives as a parsedTransactionNotification, already decoded: every instruction with named arguments and named accounts, plus the fee, the full account key list, a transaction-level summary, and the SOL and token transfers.

Endpoints

Parsed Streams is available on all plans and served on the Gatekeeper endpoint, the same host as Helius RPC and WebSocket traffic:

• wss://beta.helius-rpc.com/?api-key=<API_KEY>

Authorizations

api-key · string · required

Your Helius API key, passed as the api-key query parameter or the x-api-key header. A missing or invalid key is rejected with HTTP 401.

Body

params · array · required

Hide Filter

At least one of programs or accounts.include is required. The fields you set combine with AND: an instruction must satisfy all of them to match.

programs · string[]

Program IDs to match (base58 addresses, not names). An instruction matches if its program is in this list. OR within the list.

instructionNames · string[]

Decoded instruction names, such as route. Matched exactly first, then with a case and separator insensitive fallback, so sharedAccountsRoute also matches the wire name shared_accounts_route. OR within the list. Only instructions whose name the catalog could identify can match, so take names from describeProgram.

accounts.include · string[]

Account addresses. An instruction matches if any of these appears in its account list. OR within the list. Works for every instruction, decoded or not. The program id itself does not count as an account here.

accounts.roles · object

A map of decoded account role name to address, such as { "user_transfer_authority": "<pubkey>" }. Every entry must hold (AND across entries), and the instruction must be decoded for this to apply. Role names match exactly, with no case folding, so copy them from describeProgram rather than guessing.

includeFailed · boolean · default: "false"

Include instructions from failed transactions.

includeCpi · boolean · default: "true"

Inner (CPI) instructions are eligible to match. Set false to match top-level instructions only.

Show Options

The second param is optional.

commitment · string · default: "confirmed"

Only confirmed is supported.

details · string · default: "full"

What each notification carries. full: the whole transaction, every instruction, plus matchedIndexes pointing at the filter hits. matched: only the instructions that matched, no index list. raw: matched instructions only, each reduced to its position, programId, and base58 data blob, with no decoded fields and no accountKeys array. Use matched when bandwidth matters more than context (full payloads average roughly three times the size), and raw when you decode instruction data yourself and only need the bytes.

Unknown fields anywhere in the filter or options are rejected with -32602 rather than silently ignored, so typos fail loudly instead of matching nothing.

Response

result · integer

Subscription id (needed to unsubscribe)

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "parsedTransactionSubscribe",
  "params": [
    {
      "programs": ["JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"],
      "instructionNames": ["route", "shared_accounts_route"],
      "accounts": {
        "include": ["So11111111111111111111111111111111111111112"],
        "roles": { "user_transfer_authority": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin" }
      },
      "includeFailed": false,
      "includeCpi": true
    },
    { "commitment": "confirmed", "details": "full" }
  ]
}

Response

{ "jsonrpc": "2.0", "id": 1, "result": 23 }

Notifications

One notification per matching transaction per subscription. Inside params.result.value:

• transaction — the full context: signature, slot, fee (lamports), the complete accountKeys list, status/error, a transaction-level summary, and the extracted nativeTransfers and tokenTransfers.
• instructions — every instruction in execution order, positioned by instructionIndex, innerInstructionIndex, and stackHeight. Decoded instructions carry named decoded.args and decoded.accounts (snake_case, u64 values as strings); undecoded ones carry rawData and rawAccounts instead.
• matchedIndexes — indices into instructions telling you which ones your filter actually hit. With details: "matched" the array contains only the hits and matchedIndexes is absent; with details: "raw" each matched instruction shrinks to its position, programId, and base58 data blob.

For a field-by-field reading of the notification payload, see the quickstart protocol reference.

Managing Subscriptions

The result from the subscribe response is the same number that appears in params.subscription on every notification from that subscription. Store it — you need it to unsubscribe.

A project may hold up to 5 concurrent connections on Free, 10 on Developer, and 50 on Business and Professional, shared across all of its API keys, with up to 25 subscriptions per connection. See the overview for all limits.