Skip to main content

getSignaturesForAddress

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

Address <string>

  • Account address as base-58 encoded string

Configuration <object>

  • Configuration object containing the following fields:
    • limit: <number> - maximum transaction signatures to return (between 1 and 1,000).
    • before: <string> - start searching backwards from this transaction
    • until: <string> - 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> - This will always be "finalized"

Code sample

curl "https://testnet.atlas.xyz/?apikey=$ATLAS_API_KEY" -X POST -H "Content-Type: application/json" -d '
{
"jsonrpc": "2.0",
"id": "0bdba4c1-3073-41b0-b849-46f14e004e38",
"method": "getSignaturesForAddress",
"params": [
"AxTc4ZJtizGCkJWLQ6WQPUXPv7rzZP5vNJGVimX592nn",
{
"limit": 1
}
]
}
'

Response

{
"jsonrpc": "2.0",
"id": "0bdba4c1-3073-41b0-b849-46f14e004e38",
"result": [
{
"signature": "25HfrLUT6piHHNRvYo49tZ7br1D7ixLMKG7mcY6HeFrs94qrhARzAyxJzcHyTHgpr1UoVLEjoQgBarb6YmUk5bjK",
"slot": 11132604,
"err": null,
"memo": null,
"blockTime": 1724965719,
"confirmationStatus": null
}
]
}