getSignaturesForAddress

POSTTransactionsOperator+

Returns recent transaction signatures that touched a given address, newest first.

Try itSends a real request from your browser to the selected region.
POST
/

getSignaturesForAddress walks an account's transaction history backwards from a starting point, returning matching signatures with a short status summary for each — no full transaction bodies.

getTransaction or getSignatureStatuses, paired with this call, supply full detail once specific transactions are identified.

Plans & rate limitsOperator and above
FreeNot included
Operator5/s
Blade Runner10/s
Nexus30/s

Parameters

params is a JSON array, with values in this order: address, config.

1addressstringrequired

Account address to search transaction history for, base-58 encoded.

2configobject

Optional configuration.

Show propertiesProperties
commitmentstringdefault: "finalized"

Bank state to search from. processed is not accepted here.

Allowed values:confirmedfinalized
minContextSlotinteger

Minimum slot the node must have processed before answering.

limitintegerdefault: 1000

Maximum number of signatures to return.

Minimum: 1Maximum: 1000
beforestring

Start searching backwards from this signature, exclusive. Omit to start from the most recent transaction.

untilstring

Stop searching once this signature is reached, exclusive. Useful for paging forward to "catch up" from a previously-seen signature.

Result

resultobject[]

An array of signature-info objects, ordered newest-first. Not wrapped in a context/value envelope.

Show each itemEach item
signaturestringrequired

Transaction signature, base-58 encoded.

slotintegerrequired

Slot the transaction was processed in.

errobject | nullrequired

Null if the transaction succeeded; a TransactionError object if it failed. Failed transactions are still included.

memostring | null

Contents of the transaction's memo instruction, if it had one.

blockTimeinteger | null

Estimated production time of the containing block, as Unix seconds.

confirmationStatusstring | null

Confirmation status at the time of the response.

Allowed values:processedconfirmedfinalizednull

Notes

  • Failed transactions are included (see the third example entry, a program-defined Custom error); the err field distinguishes successes from failures client-side.
  • Paging through history uses the last signature received as before on the next call.
  • constant-k keeps a rolling window of ledger history; old signatures stop appearing once paging passes the retention window, whose start minimumLedgerSlot reports.