​
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 string

object optional
Configuration object containing the following fields:

commitment string optional
The level of commitment desired when querying state

minContextSlot number optional
The minimum slot that the request can be evaluated at

limit 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