getSignaturesForAddress RPC Method

Description

Returns confirmed signatures for transactions involving an address backwards in time from the provided signature or most recent confirmed block.

Parameters

1. account_address (string, required) - The account address encoded as base-58 string
2. object (array, optional) - The configuration object with the following fields:
   • limit (integer) - The maximum number of transaction signatures to return (between 1 and 1000). The default value is 1000
   • before (string, optional) - Start searching backward from this transaction signature. If not provided, the search starts from the top of the highest max confirmed block
   • until (string, optional) - Searches until this transaction signature, if found before limit reached
   • commitment (string, optional) - The level of commitment required for the query. The options include:
     • finalized - The node will query the most recent block confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized
     • confirmed - The node will query the most recent block that has been voted on by the supermajority of the cluster
     • processed - The node will query its most recent block. Note that the block may not be complete
   • minContextSlot (integer, optional) - The minimum slot at which the request can be evaluated

Returns

A JSON 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 either 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 and null if no memo is present
• signature - The base58-encoded signature of the transaction
• slot - The slot number in which the transaction was confirmed

Code Examples

curl "https://rpc-mainnet.solanatracker.io/?api_key=YOUR_API_KEY_HERE" \
  -X POST \
  -H "Content-Type: application/json" \
  -d $'
    {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getSignaturesForAddress",
      "params": ["Vote111111111111111111111111111111111111111",{"limit": 1}]
      }
  '