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
null
if transaction succeeded- Contains TransactionError details if transaction failed
-
memo: <string|null>
- Memo associated with the transaction
null
if no memo is present
-
blockTime: <i64|null>
- Estimated production time
- Unix timestamp (seconds since the Unix epoch)
null
if timestamp is unavailable
-
confirmationStatus: <string|null>
- Transaction’s cluster confirmation status
- Possible values:
processed
,confirmed
, orfinalized