getSignaturesForAddress

Returns signatures for confirmed transactions that include the specified address in the accountKeys list. Results are returned in reverse chronological order, starting from the provided signature or the most recent confirmed block.

Parameters

• address: (string) [required] - The base-58 encoded public key of the account to query.

• config: (object) [optional] - Configuration object with the following options:

  • commitment: (string) [optional] - The commitment level to use for the query. The default is finalized. Possible values are:
    • finalized - Queries the most recent block confirmed by a super majority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
    • confirmed - Queries the most recent block that has been voted on by a super majority of the cluster.
    • processed - Queries its most recent block. The block may still be skipped by the cluster.
  • minContextSlot: [optional] - The minimum slot to use for the query.
  • limit: (number) [optional] - The maximum number of signatures to return (between 1 and 1000). The default is 1000.
  • before: (string) [optional] - Starts searching backward from the specified transaction signature. If not provided, the search begins from the most recent confirmed block.
  • until: (string) [optional] - The signature to end the query at (if found before reaching limit).

Returns

result - An object with the following fields:

• blockTime - The estimated production time, as Unix timestamp (seconds since the Unix epoch). null if not available.
• confirmationStatus - The transaction's cluster confirmation status. The status can be processed, confirmed, or finalized.
• err - Error code if the transaction failed, or null if the transaction succeeds.
• memo - The memo associated with the transaction, or null if no memo is present.
• signature - The base58 encoded signature of the transaction.
• slot - The slot number in which the transaction was confirmed.

Example

Replace <YOUR-API-KEY> with your API key.

Request

• curl

curl https://solana-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "getSignaturesForAddress", "params": ["Vote111111111111111111111111111111111111111", {"limit": 1}]}'

Response

• JSON

{
  "jsonrpc": "2.0",
  "result": [
    {
      "blockTime": 1744177112,
      "confirmationStatus": "finalized",
      "err": null,
      "memo": null,
      "signature": "2QYQGurkeT9CwdMTnMNTETbqwU4NiLoB8kqA4KxVUu4vV1BWxw79YfzWAWpPduqA2zmxgbunyrPZtCbDR7LCmTZr",
      "slot": 373019515
    }
  ],
  "id": 1
}