gRPCSubscribe
solana-mainnet.nodit.io:443 geyser.Geyser/Subscribebidirectional streamingStreams account, slot, transaction, block, and entry updates in real time according to your filters. Because the stream is bidirectional, you can keep the connection open and send a new SubscribeRequest to replace filters or send a ping.
- Fields within a filter are combined with AND, and values within an array with OR. Leaving every field of a filter empty streams all updates of that type.
- Sending a new request replaces all existing filters with the filters in the new request.
- Some load balancers close idle streams, so reply to the server's
pingupdates with apingrequest to keep the connection alive. - Set
from_slotto resume from that slot after a short disconnection. UseSubscribeReplayInfoto find the earliest slot available for replay.
Filter label. Choose any key name (e.g., client); updates matching this filter carry the same label in their filters field.
Account addresses to stream updates for (OR).
Streams updates for accounts owned by these programs (OR).
Account data conditions, combined with AND. Set exactly one of the fields below in each item.
Matches accounts whose data equals the given value at the offset.
Byte offset to start comparing at.
Value to compare (bytes, base64). Set only one of bytes, base58, or base64.
Value to compare (Base58 string).
Value to compare (Base64 string).
Matches accounts whose data size in bytes equals this value.
When true, matches only valid SPL token accounts.
Balance (lamports) comparison. Set only one of eq, ne, lt, or gt.
Balance equal to this value.
Balance not equal to this value.
Balance less than this value.
Balance greater than this value.
When true, streams only account updates caused by a transaction (updates with a txn_signature).
Filter label. Choose any key name (e.g., client); updates matching this filter carry the same label in their filters field.
When true, streams only slot updates that reach the request's commitment level. Omit to receive slot updates for every status.
When true, also streams intermediate statuses such as SLOT_FIRST_SHRED_RECEIVED, SLOT_COMPLETED, SLOT_CREATED_BANK, and SLOT_DEAD.
Filter label. Choose any key name (e.g., client); updates matching this filter carry the same label in their filters field.
Whether to include vote transactions. true streams only vote transactions and false excludes them. Omit to receive both.
Whether to include failed transactions. true streams only failed transactions and false only successful ones. Omit to receive both.
Streams only the transaction with this signature (Base58).
Streams transactions that use any of these addresses (OR).
Excludes transactions that use any of these addresses.
Streams only transactions that use all of these addresses (AND).
Filter label. Choose any key name (e.g., client); updates matching this filter carry the same label in their filters field.
Whether to include vote transactions. true streams only vote transactions and false excludes them. Omit to receive both.
Whether to include failed transactions. true streams only failed transactions and false only successful ones. Omit to receive both.
Streams only the transaction with this signature (Base58).
Streams transactions that use any of these addresses (OR).
Excludes transactions that use any of these addresses.
Streams only transactions that use all of these addresses (AND).
Filter label. Choose any key name (e.g., client); updates matching this filter carry the same label in their filters field.
Limits the transactions and accounts included in the block to those that use these addresses (OR).
Whether to include the block's transactions.
Whether to include the accounts updated in the block.
Whether to include the block's entries.
Filter label. Choose any key name (e.g., client); updates matching this filter carry the same label in their filters field.
Filter label. Choose any key name (e.g., client); updates matching this filter carry the same label in their filters field.
Commitment level for updates. One of PROCESSED, CONFIRMED, or FINALIZED. Defaults to PROCESSED when omitted. CONFIRMED and FINALIZED updates are delivered after reaching that level.
Start byte offset of the range.
Length of the range in bytes.
Ping identifier, echoed back in the pong update.
Replays updates starting from this slot. Use it to recover from short disconnections; replay starts at a slot boundary, so deduplicate updates.
Labels of the filters that matched this update.
Account information.
Account address (base64).
Account balance in lamports.
Address of the program that owns the account (base64).
Whether the account is an executable program.
Epoch at which the account next owes rent.
Account data (base64). Contains only the requested ranges when accounts_data_slice is set.
Write version of the account. Use it to order updates within the same slot.
Signature of the transaction that modified the account (base64). Absent for startup updates.
Slot number where the update occurred.
Whether the update comes from the startup snapshot.
Slot number.
Parent slot number.
Slot status.
Reason the slot became SLOT_DEAD.
Transaction information.
Transaction signature (base64).
Whether this is a vote transaction.
The raw transaction.
List of transaction signatures (base64).
Transaction message.
Message header.
Account addresses referenced by the transaction (base64).
Recent blockhash used by the transaction (base64).
List of instructions to execute.
Whether this is a versioned (v0) transaction.
Address lookup table (ALT) references.
Transaction execution metadata.
Execution error. Absent for successful transactions.
Serialized error value (base64).
Transaction fee in lamports.
Account balances in lamports before execution.
Account balances in lamports after execution.
Inner instructions executed during program invocation.
Program log messages.
Token balances before execution.
Index of the token account in account_keys.
Mint address of the token.
Token amount adjusted for decimals.
Address of the token account owner.
Token program ID.
Token balances after execution.
Index of the token account in account_keys.
Mint address of the token.
Token amount adjusted for decimals.
Address of the token account owner.
Token program ID.
Rewards generated by the transaction.
Address of the account that received the reward.
Reward amount in lamports. Negative values are debits.
Account balance in lamports after the reward was applied.
Reward type.
Vote account commission (%) when the reward was credited. Present only for Voting and Staking rewards.
Addresses loaded as writable from address lookup tables (base64).
Addresses loaded as read-only from address lookup tables (base64).
Total compute units consumed by the transaction.
Position (index) of the transaction within the block.
Slot number containing the transaction.
Slot number containing the transaction.
Transaction signature (base64).
Whether this is a vote transaction.
Position (index) of the transaction within the block.
Execution error. Absent for successful transactions.
Serialized error value (base64).
Slot number of the block.
Blockhash (Base58).
Block reward information.
List of rewards.
Address of the account that received the reward.
Reward amount in lamports. Negative values are debits.
Account balance in lamports after the reward was applied.
Reward type.
Vote account commission (%) when the reward was credited. Present only for Voting and Staking rewards.
Block production time.
Unix timestamp in seconds.
Block height.
Block height value.
Slot number of the parent block.
Blockhash of the parent block (Base58).
Number of transactions executed in the block.
Transactions in the block. Included when include_transactions is true.
Transaction signature (base64).
Whether this is a vote transaction.
The raw transaction.
List of transaction signatures (base64).
Transaction message.
Message header.
Account addresses referenced by the transaction (base64).
Recent blockhash used by the transaction (base64).
List of instructions to execute.
Whether this is a versioned (v0) transaction.
Address lookup table (ALT) references.
Transaction execution metadata.
Execution error. Absent for successful transactions.
Serialized error value (base64).
Transaction fee in lamports.
Account balances in lamports before execution.
Account balances in lamports after execution.
Inner instructions executed during program invocation.
Program log messages.
Token balances before execution.
Index of the token account in account_keys.
Mint address of the token.
Token amount adjusted for decimals.
Address of the token account owner.
Token program ID.
Token balances after execution.
Index of the token account in account_keys.
Mint address of the token.
Token amount adjusted for decimals.
Address of the token account owner.
Token program ID.
Rewards generated by the transaction.
Address of the account that received the reward.
Reward amount in lamports. Negative values are debits.
Account balance in lamports after the reward was applied.
Reward type.
Vote account commission (%) when the reward was credited. Present only for Voting and Staking rewards.
Addresses loaded as writable from address lookup tables (base64).
Addresses loaded as read-only from address lookup tables (base64).
Total compute units consumed by the transaction.
Position (index) of the transaction within the block.
Number of accounts updated in the block.
Accounts updated in the block. Included when include_accounts is true.
Account address (base64).
Account balance in lamports.
Address of the program that owns the account (base64).
Whether the account is an executable program.
Epoch at which the account next owes rent.
Account data (base64). Contains only the requested ranges when accounts_data_slice is set.
Write version of the account. Use it to order updates within the same slot.
Signature of the transaction that modified the account (base64). Absent for startup updates.
Number of entries in the block.
Entries in the block. Included when include_entries is true.
Slot number the entry belongs to.
Index of the entry within the slot.
Number of PoH hashes since the previous entry.
Entry hash (base64).
Number of transactions executed in the entry.
Block index of the first transaction in the entry.
Slot number of the block.
Blockhash (Base58).
Block reward information.
List of rewards.
Address of the account that received the reward.
Reward amount in lamports. Negative values are debits.
Account balance in lamports after the reward was applied.
Reward type.
Vote account commission (%) when the reward was credited. Present only for Voting and Staking rewards.
Block production time.
Unix timestamp in seconds.
Block height.
Block height value.
Slot number of the parent block.
Blockhash of the parent block (Base58).
Number of transactions executed in the block.
Number of entries in the block.
Slot number the entry belongs to.
Index of the entry within the slot.
Number of PoH hashes since the previous entry.
Entry hash (base64).
Number of transactions executed in the entry.
Block index of the first transaction in the entry.
The id from the ping request.
Time the server created the update (RFC 3339).