getSignaturesForAddress

The getSignaturesForAddress method returns confirmed transaction signatures for transactions involving a specified address, in reverse chronological order. This method is essential for building transaction history, tracking account activity, and implementing blockchain explorers or wallet transaction views.

Every transaction in Solana involves one or more accounts, either as signers, writable accounts, or read-only accounts. This method allows you to discover all transactions that touched a specific account, providing a complete activity history. The signatures returned can then be used with getTransaction to fetch full transaction details. The method supports pagination through before/until parameters and can limit results for efficient data retrieval.

This method is crucial for wallets displaying transaction history, analytics platforms tracking account activity, compliance tools auditing transactions, and any application that needs to reconstruct account state changes over time. It provides the foundation for building comprehensive account activity timelines and enables users to review their complete on-chain history.

Parameters

parameter	type	description
address	string	Account address as base-58 encoded string
config	object	Optional configuration object
config.commitment	string	Level of commitment: 'confirmed' or 'finalized' (default: 'finalized')
config.limit	number	Maximum number of signatures to return (maximum 1000, default: 1000)
config.before	string	Optional. Start searching backwards from this transaction signature
config.until	string	Optional. Search until this transaction signature is reached
config.minContextSlot	number	Optional. Minimum slot that the request can be evaluated at

Return Object

field	type	description
result	array	Array of signature information objects, ordered from newest to oldest
result[].signature	string	Transaction signature as base-58 encoded string
result[].slot	number	The slot in which the transaction was processed
result[].err	object\|null	Error if transaction failed, null if successful
result[].memo	string\|null	Memo associated with the transaction, if any
result[].blockTime	number\|null	Estimated production time as Unix timestamp, or null if not available
result[].confirmationStatus	string\|null	Commitment level: 'processed', 'confirmed', or 'finalized'

Request Example

Request

Response Example

Response

Tip: Results are ordered newest to oldest. Use before parameter with the last signature from previous results to implement pagination. The err field indicates transaction success (null) or failure (error object). Maximum 1000 results per request. For complete history, paginate through results.