Solana getSignaturesForAddress RPC Method

Returns signatures for confirmed transactions that include the given address in their accountKeys list. Returns signatures backwards in time from the provided signature or most recent confirmed block

Parameters#

stringrequired

Account address as base-58 encoded string

objectoptional

Configuration object containing the following fields:

commitmentstringoptional

The commitment describes how finalized a block is at that point in time.

minContextSlotnumberoptional

The minimum slot that the request can be evaluated at.

limitnumberoptional

maximum transaction signatures to return (between 1 and 1,000).

beforestringoptional

start searching backwards from this transaction signature. If not provided the search starts from the top of the highest max confirmed block.

untilstringoptional

search until this transaction signature, if found before limit reached

Result#

An array of <object>, ordered from newest to oldest transaction, containing transaction signature information with the following fields:

signature: <string> - transaction signature as base-58 encoded string
slot: <u64> - The slot that contains the block with the transaction
err: <object|null> - Error if transaction failed, null if transaction succeeded. See TransactionError definitions for more info.
memo: <string|null> - Memo associated with the transaction, null if no memo is present
blockTime: <i64|null> - estimated production time, as Unix timestamp (seconds since the Unix epoch) of when transaction was processed. null if not available.
confirmationStatus: <string|null> - The transaction's cluster confirmation status; Either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.

Code sample#

curl https://api.devnet.solana.com -s -X POST -H "Content-Type: application/json" -d '
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignaturesForAddress",
    "params": [
      "Vote111111111111111111111111111111111111111",
      {
        "limit": 1
      }
    ]
  }
'

Response#

{
  "jsonrpc": "2.0",
  "result": [
    {
      "err": null,
      "memo": null,
      "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
      "slot": 114,
      "blockTime": null
    }
  ],
  "id": 1
}

Try It

Endpoint