Skip to main content

​
getSignaturesForAddress RPC Method

Returns signatures for confirmed transactions that include the given address in their accountKeys list.

​
Method Behavior

Returns signatures backwards in time from the provided signature or most recent confirmed block.

​
Parameters

string required
Account address as base-58 encoded stringobject optional
Configuration object containing the following fields:commitment string optional
The level of commitment desired when querying stateminContextSlot number optional
The minimum slot that the request can be evaluated atlimit number optional
Maximum transaction signatures to return
  • Default: 1000
  • Range: Between 1 and 1,000
before string optional
Start searching backwards from this transaction signature
  • If not provided, search starts from the top of the highest max confirmed block
until string optional
Search until this transaction signature, if found before limit reached

​
Code Sample

curl https://rpc.testnet.soo.network/rpc \
-X POST \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getSignaturesForAddress",
  "params": [
    "5ThJTCxpdn54bk3gBAWKZS4K9ogHEX56WooYbXQDnm3Q",
    {
      "limit": 10,
      "commitment": "finalized"
    }
  ]
}'

​
Response

{
  "jsonrpc": "2.0",
  "result": [
    {
      "signature": "BESTc6u4kKPDrdAXHTKPgCm9bwBzDn2Nq9g4gk1Ld3P4",
      "slot": 369624,
      "err": null,
      "memo": null,
      "blockTime": 1701234567,
      "confirmationStatus": "finalized"
    }
  ],
  "id": 1
}

​
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, or finalized