get
Returns transactions that touched a given address, newest first by default, from long-term storage.
getTransactionsForAddress returns transactions that touched an address, answered from long-term storage. The region's ledger does not serve this method; it is Nexus only.
Responses page with paginationToken: pass the token from the previous response on the next call, and stop when it comes back null. Each token is scoped to the same query. Batch requests are not supported.
Historical lookups
| Plan | Available | Rate per key |
|---|---|---|
| Free | — | — |
| Operator | — | — |
| Blade Runner | — | — |
| Nexus | ✓ | 30/s (signatures), 5/s (full) |
Answers come from long-term storage within the shared limit 20/s, 1,000,000 per month (per region, all keys), with a longest wait of 5 s. Over the rate, HTTP 429 with code -32005 and a Retry-After: 1 header; over the monthly allowance, HTTP 429 with code -32005; when the retrieval is unavailable, HTTP 503 with code -32000. See Historical lookups.
Parameters
params is a JSON array, with values in this order: address, options.
Account address to search transaction history for, base-58 encoded.
Optional configuration.
Show propertiesProperties
"signatures" returns signature-level records only. "full" returns each transaction with its metadata. "full" caps limit at 100.
signaturesfullSort order of the returned transactions.
descascMaximum transactions per response. At most 1,000 with transactionDetails: "signatures" (the default), at most 100 with "full" (the default there).
1Maximum: 1000The previous response's paginationToken, a "slot:position" string, to continue where it stopped. Scoped to the same query.
Bank state to search from. processed is not accepted here.
finalizedconfirmedMinimum slot the region must have processed before answering.
Encoding for the transaction field. Available with transactionDetails: "full" only.
jsonjsonParsedbase58base64Highest transaction version the caller can decode. Available with transactionDetails: "full" only.
0Maximum: 1Restrict the search range and the transactions returned.
Show propertiesProperties
Slot range bounds.
Show propertiesProperties
Block time range bounds, as Unix seconds.
Show propertiesProperties
Signature range bounds, as base-58 strings.
Show propertiesProperties
Which transaction outcomes to return.
anysucceededfailedToken-account activity to match. Token-account activity is available from December 2022, slot 111,491,819.
nonebalanceChangedallResult
An object with data and paginationToken. paginationToken is null when the answer is complete; otherwise pass it as paginationToken on the next call.
Show propertiesProperties
Show each itemEach item
Transaction signature, base-58 encoded. Signatures mode only.
Slot the transaction was processed in.
Index of this transaction within its block.
Null if the transaction succeeded; a TransactionError object if it failed. Signatures mode only.
Contents of the transaction's memo instruction, if it had one. Signatures mode only.
Estimated production time of the containing block, as Unix seconds.
Confirmation status at the time of the response. Signatures mode only.
processedconfirmedfinalizednullThe compiled transaction. Full mode only.
The transaction metadata, as getTransaction reports it. Full mode only.
Full mode only: "legacy", or the integer version number 0 or 1.
A "slot:position" string to continue with, or null when the answer is complete.
Notes
- Nexus only. Requests from other plans are answered with HTTP
403and code-32600,getTransactionsForAddress requires higher tier. - Answers come from long-term storage; the region's ledger does not serve this method. Walk
paginationTokenuntil it is null. - With
transactionDetails: "full", a response holds at most 100 transactions. A higherlimitis not an error: the response holds 100 and apaginationTokenfor the next page. filters.tokenTransferis not supported. Usefilters.tokenAccountsfor token-account activity.- To get the full transactions for an address, use
transactionDetails: "full"and followpaginationToken(at most 100 per page). Signatures from this method in"signatures"mode do not make old transactions available throughgetTransaction: for a signature older than the region's ledger window,getTransactionreturnsnull. - Invalid parameters are returned as JSON-RPC errors. Batch requests are not supported: one call per HTTP request.