Parameters
- addressstringREQUIRED
The account address encoded as base-58 string to retrieve transaction history for
- objectobject
(Optional) The configuration object with the following fields:
- transactionDetailsstring
(Default: signatures) The level of transaction detail to return. It can be one of signatures or full. When set to full, each item includes the complete transaction and metadata objects
- sortOrderstring
(Default: desc) The order in which results are sorted by slot and transaction index. It can be one of desc (newest first) or asc (oldest first)
- limitinteger
(Default: 1000) The maximum number of transactions to return (between 1 and 1000). Values above 1000 are capped at 1000
- paginationTokenstring
The token returned as paginationToken in a previous response, used to fetch the next page of results. The value is formatted as slot:transactionIndex
- commitmentstring
The level of commitment required for the query. This method does not support commitment levels below confirmed. The options include:
- finalizedstring
The node will query the most recent block the cluster has recognized as finalized
- confirmedstring
The node will query the most recent block that has been voted on by the supermajority of the cluster
- minContextSlotinteger
The minimum slot at which the request can be evaluated
- encodingstring
(Default: json) The encoding format for the transaction data. It can be one of json, jsonParsed, base58, or base64. This field only applies when transactionDetails is set to full
- maxSupportedTransactionVersioninteger
The maximum transaction version to return, as a JSON integer. Set it to 1 to receive legacy, version 0, and version 1 transactions. This field only applies when transactionDetails is set to full
- filtersobject
(Optional) The filter object used to narrow the returned transactions with the following fields:
- slotobject
Filters transactions by slot using any combination of the comparison fields below
- gteinteger
Matches transactions in slots greater than or equal to this value
- gtinteger
Matches transactions in slots greater than this value
- lteinteger
Matches transactions in slots less than or equal to this value
- ltinteger
Matches transactions in slots less than this value
- blockTimeobject
Filters transactions by block time, as a Unix timestamp in seconds, using any combination of the comparison fields below
- gteinteger
Matches transactions with a block time greater than or equal to this value
- gtinteger
Matches transactions with a block time greater than this value
- lteinteger
Matches transactions with a block time less than or equal to this value
- ltinteger
Matches transactions with a block time less than this value
- eqinteger
Matches transactions with a block time equal to this value
- signatureobject
Filters transactions by their position relative to a base-58 encoded transaction signature, using any combination of the comparison fields below
- gtestring
Matches transactions positioned at or after this signature
- gtstring
Matches transactions positioned after this signature
- ltestring
Matches transactions positioned at or before this signature
- ltstring
Matches transactions positioned before this signature
- statusstring
(Default: any) Filters transactions by execution status. It can be one of any, succeeded, or failed
- tokenAccountsstring
(Default: none) Controls whether transactions involving token accounts owned by the address are included. It can be one of none (only the address itself), balanceChanged (also include token accounts whose balance changed), or all (also include all token accounts owned by the address)
Returns
- resultobject
A JSON object with the following fields:
- dataarray
An array of transaction objects. The fields present in each object depend on transactionDetails, as noted below:
- signaturestring
Only present when transactionDetails is signatures. The base-58 encoded signature of the transaction. When transactionDetails is full, the signature is available in transaction.signatures[0] for the json and jsonParsed encodings
- slotinteger
The slot number in which the transaction was confirmed
- transactionIndexinteger
The position of the transaction within its block
- errobject
Only present when transactionDetails is signatures. Error object if the transaction failed or null if the transaction succeeded. When transactionDetails is full, the error is available in meta.err
- memostring
Only present when transactionDetails is signatures. The memo associated with the transaction and null if no memo is present
- blockTimeinteger
The estimated production time, as Unix timestamp (seconds since the Unix epoch). Null if not available
- confirmationStatusstring
Only present when transactionDetails is signatures. The transaction's cluster confirmation status. The status can either be confirmed or finalized
- transactionobject
Only present when transactionDetails is full. The transaction object, either in JSON format or encoded binary data depending on the encoding parameter. Version 1 transactions carry their compute and fee settings in the message's transactionConfig object
- metaobject
Only present when transactionDetails is full. The transaction status metadata object, containing fields such as err, fee, preBalances, postBalances, preTokenBalances, postTokenBalances, innerInstructions, logMessages, rewards, loadedAddresses, status, computeUnitsConsumed, and costUnits. The loadedAddresses field holds the addresses resolved from address lookup tables as writable and readonly arrays, both empty for legacy and version 1 transactions, and is omitted when encoding is jsonParsed, where those addresses appear in accountKeys with a source of lookupTable
- versionstring|integer
Only present when transactionDetails is full. The transaction version, one of "legacy", 0, or 1
- paginationTokenstring
The token used to fetch the next page of results, formatted as slot:transactionIndex. Null when there are no further results
1{2"jsonrpc": "2.0",3"result": {4"data": [5{6"signature": "451WMoVHaDk3yFnHXDnzfaUg3iQxfDwvuLJbhndumUrhnu5Y8M3p6CDSCs7eJjiUdvNsyqH99MtXiwbovAKcRfHd",7"slot": 458981321,8"transactionIndex": 1295,9"err": null,10"memo": null,11"blockTime": 1792445094,12"confirmationStatus": "finalized"13},14{15"signature": "XfTs1wU1YjvsYuiVdFXzUmZKnVGRv5LjabqJTB7Q1LpgfZBzK6SLphvvUwnmrVbinqnU2UWUYzeD7FGNsCyvmvn",16"slot": 458981321,17"transactionIndex": 1294,18"err": null,19"memo": null,20"blockTime": 1792445094,21"confirmationStatus": "finalized"22}23],24"paginationToken": "458981321:1294"25},26"id": 127}
1{2"jsonrpc": "2.0",3"result": {4"data": [5{6"signature": "451WMoVHaDk3yFnHXDnzfaUg3iQxfDwvuLJbhndumUrhnu5Y8M3p6CDSCs7eJjiUdvNsyqH99MtXiwbovAKcRfHd",7"slot": 458981321,8"transactionIndex": 1295,9"err": null,10"memo": null,11"blockTime": 1792445094,12"confirmationStatus": "finalized"13},14{15"signature": "XfTs1wU1YjvsYuiVdFXzUmZKnVGRv5LjabqJTB7Q1LpgfZBzK6SLphvvUwnmrVbinqnU2UWUYzeD7FGNsCyvmvn",16"slot": 458981321,17"transactionIndex": 1294,18"err": null,19"memo": null,20"blockTime": 1792445094,21"confirmationStatus": "finalized"22}23],24"paginationToken": "458981321:1294"25},26"id": 127}