Helius SDK - v3.4.0
    Preparing search index...

    Type Alias GetTransactionsForAddressBaseConfig

    Base configuration for getTransactionsForAddress with rich filtering.

    type GetTransactionsForAddressBaseConfig = {
        commitment?: Commitment;
        encoding?: "json" | "jsonParsed" | "base64" | "base58";
        filters?: {
            blockTime?: {
                eq?: number;
                gt?: number;
                gte?: number;
                lt?: number;
                lte?: number;
            };
            signature?: { gt?: string; gte?: string; lt?: string; lte?: string };
            slot?: {
                eq?: number;
                gt?: number;
                gte?: number;
                lt?: number;
                lte?: number;
            };
            status?: "succeeded"
            | "failed"
            | "any";
            tokenAccounts?: "none" | "balanceChanged" | "all";
            tokenTransfer?: {
                amount?: TransferComparisonFilter;
                direction?: "in" | "out" | "any";
                mint?: string;
                with?: string;
            };
        };
        limit?: number;
        maxSupportedTransactionVersion?: MaxSupportedTransactionVersion;
        minContextSlot?: number;
        paginationToken?: string
        | null;
        sortOrder?: "asc" | "desc";
    }
    Index

    Properties

    commitment?: Commitment
    encoding?: "json" | "jsonParsed" | "base64" | "base58"
    filters?: {
        blockTime?: {
            eq?: number;
            gt?: number;
            gte?: number;
            lt?: number;
            lte?: number;
        };
        signature?: { gt?: string; gte?: string; lt?: string; lte?: string };
        slot?: {
            eq?: number;
            gt?: number;
            gte?: number;
            lt?: number;
            lte?: number;
        };
        status?: "succeeded"
        | "failed"
        | "any";
        tokenAccounts?: "none" | "balanceChanged" | "all";
        tokenTransfer?: {
            amount?: TransferComparisonFilter;
            direction?: "in" | "out" | "any";
            mint?: string;
            with?: string;
        };
    }

    Rich filters for status, token accounts, slot, blockTime, and signature ranges.

    Type Declaration

    • OptionalblockTime?: { eq?: number; gt?: number; gte?: number; lt?: number; lte?: number }

      Filter by block time (Unix timestamp)

      • Optionaleq?: number

        Equal to

      • Optionalgt?: number

        Greater than

      • Optionalgte?: number

        Greater than or equal to

      • Optionallt?: number

        Less than

      • Optionallte?: number

        Less than or equal to

    • Optionalsignature?: { gt?: string; gte?: string; lt?: string; lte?: string }

      Filter by signature (lexicographic comparison)

      • Optionalgt?: string

        Greater than

      • Optionalgte?: string

        Greater than or equal to

      • Optionallt?: string

        Less than

      • Optionallte?: string

        Less than or equal to

    • Optionalslot?: { eq?: number; gt?: number; gte?: number; lt?: number; lte?: number }

      Filter by slot number

      • Optionaleq?: number

        Equal to

      • Optionalgt?: number

        Greater than

      • Optionalgte?: number

        Greater than or equal to

      • Optionallt?: number

        Less than

      • Optionallte?: number

        Less than or equal to

    • Optionalstatus?: "succeeded" | "failed" | "any"

      Filter by transaction status

    • OptionaltokenAccounts?: "none" | "balanceChanged" | "all"

      Filter transactions for related token accounts:

      • none: Only return transactions that reference the provided address (default)
      • balanceChanged: Include transactions that modify token account balances owned by the address (recommended)
      • all: Include all transactions involving any token account owned by the address
    • OptionaltokenTransfer?: {
          amount?: TransferComparisonFilter;
          direction?: "in" | "out" | "any";
          mint?: string;
          with?: string;
      }

      Only transactions where the address sent or received a matching token transfer. Fields combine with AND.

      • Optionalamount?: TransferComparisonFilter

        Raw on-chain amount range, not the UI amount.

      • Optionaldirection?: "in" | "out" | "any"

        Transfer direction relative to the queried address. Defaults to any.

      • Optionalmint?: string

        Token mint address.

      • Optionalwith?: string

        Counterparty address on the other side of the transfer.

    limit?: number

    Max results per page.

    maxSupportedTransactionVersion?: MaxSupportedTransactionVersion

    See MaxSupportedTransactionVersion. With transactionDetails: "accounts" | "full", omitted = legacy-only and a higher-version transaction in range errors rather than being filtered; inert otherwise.

    minContextSlot?: number
    paginationToken?: string | null

    Pagination token from a previous response. null when no more pages.

    sortOrder?: "asc" | "desc"

    Sort order by slot/blockTime.