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

params

string required Account address as base-58 encoded string

object optional Configuration object containing the following fields:

commitment

The commitment describes how finalized a block is at that point in time. See Configuring State Commitment.

minContextSlot

The minimum slot that the request can be evaluated at

limit

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

Default: 1000

defore

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

until

Search until this transaction signature, if found before limit reached

result

array An array of transaction signature information objects, ordered from newest to oldest transaction, containing:

signature

Transaction signature as base-58 encoded string

slot

The slot that contains the block with the transaction

err

Error if transaction failed, null if transaction succeeded. See TransactionError definitions for more info.

mome

Memo associated with the transaction, null if no memo is present

blockTime

Estimated production time, as Unix timestamp (seconds since the Unix epoch) of when transaction was processed. null if not available.

confirmationStatus

The transaction's cluster confirmation status; Either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.

cURL

curl https://us-seattle.openverse.network/api -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": [
   {
     "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
     "slot": 114,
     "err": null,
     "memo": null,
     "confirmationStatus": "finalized"
   }
 ],
 "id": 1
}