getSignaturesForAddress RPC Method
Returns signatures for confirmed transactions that include the given address in theiraccountKeys list.
Method Behavior
Returns signatures backwards in time from the provided signature or most recent confirmed block.Parameters
string requiredAccount address as base-58 encoded string
object optionalConfiguration object containing the following fields:commitment
string optionalThe level of commitment desired when querying stateminContextSlot
number optionalThe minimum slot that the request can be evaluated atlimit
number optionalMaximum transaction signatures to return
- Default:
1000 - Range: Between 1 and 1,000
string optionalStart searching backwards from this transaction signature
- If not provided, search starts from the top of the highest max confirmed block
string optionalSearch until this transaction signature, if found before limit reached
Result Details
An array of signature objects, ordered from newest to oldest:-
signature: <string>- Transaction signature as a base-58 encoded string
- Uniquely identifies the transaction
-
slot: <u64>- The slot containing the block with the transaction
- Indicates the blockchain location of the transaction
-
err: <object|null>- Transaction error details
nullif transaction succeeded- Contains TransactionError details if transaction failed
-
memo: <string|null>- Memo associated with the transaction
nullif no memo is present
-
blockTime: <i64|null>- Estimated production time
- Unix timestamp (seconds since the Unix epoch)
nullif timestamp is unavailable
-
confirmationStatus: <string|null>- Transaction’s cluster confirmation status
- Possible values:
processed,confirmed, orfinalized