RPC MethodsHTTPgetTransactionsForAddress

Transaction

getTransactionsForAddress

Transaction history query with advanced filtering, bidirectional sorting, and efficient pagination. This method provides significantly more power than the standard getSignaturesForAddress, with features including: • Retrieve full transaction data in a single call without additional getTransaction requests • Time-based filtering with Unix timestamps and slot ranges • Status filtering for succeeded/failed transactions • Chronological or reverse-chronological sorting • Simple pagination with slot:position tokens.

Parameters

addressstring required

Base-58 encoded public key of the account to query transaction history for.

configobject optional

Configuration object with advanced filtering options.

transactionDetailsstring

Level of detail to return: "signatures" for basic info (up to 1000), or "full" for complete transaction data (up to 100). Default: "signatures".

sortOrderstring

Sort order: "desc" for newest first (default), or "asc" for chronological order (oldest first).

limitnumber

Maximum transactions to return. Up to 1000 for "signatures" mode, up to 100 for "full" mode.

paginationTokenstring

Pagination token from previous response in format "slot:position".

commitmentstring

Commitment level: "finalized" or "confirmed". Note: "processed" is not supported.

encodingstring

Encoding format for transaction data (only applies when transactionDetails is "full"). Options: "json", "jsonParsed", "base64", "base58". Default: "json".

maxSupportedTransactionVersionnumber

Highest transaction version to return. Set to 1 to include v1 transactions. If omitted, only legacy transactions are returned.

minContextSlotnumber

The minimum slot that the request can be evaluated at.

filtersobject

Advanced filtering options for narrowing results.

Result

object

Object containing data array and optional paginationToken for next page.

dataarray

Array of transaction data. Structure depends on transactionDetails parameter.

paginationTokenstring | null

Token for fetching the next page in format 'slot:position', or null if no more results. Pass this value as the paginationToken parameter in the next request to continue pagination.

Solana

As we do not yet have historical data available on Solana, if a transaction is not found, we will return an error object that contains our oldest stored slot.

Example

JSON

{

"jsonrpc": "2.0",

"id": 1,

"error": {

"code": -32017,

"message": "Transaction not available in cache",

"data": {

"oldestSlot": 938489449

}

FOGO Mainnet

Historical data is stored for Fogo Mainnet (not Testnet). If transaction not found, result is null. Otherwise, the response returned is as below.

Example

Request

JSON

curl "https://eu.fluxrpc.com?key=<your-API-key>" -s -X POST -H "Content-Type: application/json" -d '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getTransactionsForAddress",
  "params": [
    "7UX2i7SucgLMQcfZ75s3VXmZZY4YRUyJN9X1RgfMoDUi",
    {
      "transactionDetails": "full",
      "sortOrder": "asc",
      "limit": 10,
      "commitment": "finalized",
      "filters": {
        "blockTime": {
          "gte": 1735689600,
          "lte": 1738368000
        },
        "status": "succeeded",
        "tokenAccounts": "balanceChanged"
      },
      "encoding": "jsonParsed",
      "maxSupportedTransactionVersion": 1
    }
  ]
}'

Response

JSON

{

"jsonrpc": "2.0",

"result": {

"data": [

{

"slot": 123456789,

"transactionIndex": 5,

"blockTime": 1735692000,

"transaction": {

"signatures": [

"5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv"

"message": {

"accountKeys": [

"7UX2i7SucgLMQcfZ75s3VXmZZY4YRUyJN9X1RgfMoDUi"

"recentBlockhash": "EkSnNWid2cvwEVnVx9aBqawnmiCNiDgp3gUdkDPTKN1N",

"instructions": []

}

"meta": {

"err": null,

"fee": 5000,

"preBalances": [

1000000000

"postBalances": [

999995000

"innerInstructions": [],

"logMessages": [],

"preTokenBalances": [],

"postTokenBalances": [],

"rewards": []

}

"paginationToken": "123456790:0"

"id": 1

}

getSignaturesForAddress

getSignatureStatuses