getTransactionsForAddress

Enhanced transaction history API with powerful filtering, sorting, and pagination capabilities for retrieving comprehensive transaction data for any address. Supports bidirectional sorting, time/slot/status filtering, and efficient keyset pagination.

POST /

getTransactionsForAddress

cURL

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getTransactionsForAddress",
  "params": [
    "Vote111111111111111111111111111111111111111",
    {
      "transactionDetails": "signatures",
      "limit": 10
    }
  ]
}
'

200

signaturesResponse

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "data": [
      {
        "signature": "5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1054,
        "transactionIndex": 42,
        "err": null,
        "memo": null,
        "blockTime": 1641038400,
        "confirmationStatus": "finalized"
      },
      {
        "signature": "kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv",
        "slot": 1055,
        "transactionIndex": 15,
        "err": null,
        "memo": null,
        "blockTime": 1641038460,
        "confirmationStatus": "finalized"
      }
    ],
    "paginationToken": "1055:5"
  }
}

Request Parameters

address · string · required

Solana account address to retrieve transaction history for (wallet, token, program, NFT, etc.).

transactionDetails · string · default: "signatures"

Level of transaction detail to return.

• signatures
• full

sortOrder · string · default: "desc"

Sort order for returned transactions.

• asc
• desc

commitment · string · default: "finalized"

The commitment level for the request. The processed commitment is not supported.

• confirmed
• finalized

minContextSlot · number

Minimum context slot to use for request (optional).

limit · number · default: "1000"

Maximum number of transactions per request. Use 1–1000 for transactionDetails:“signatures” and 1–1000 for transactionDetails:“full”.

paginationToken · string

Pagination token from previous response to get next page of results (format “slot:position”).

encoding · string · default: "json"

Encoding format for transaction data (applies only when transactionDetails=full).

• json
• jsonParsed
• base58
• base64

maxSupportedTransactionVersion · number

Maximum transaction version to return (applies only when transactionDetails=full).

filters · object

Advanced filters to narrow down transaction results.

filters.slot · object

Filter by slot number.

filters.slot.gte · number

Greater than or equal to slot number.

filters.slot.gt · number

Greater than slot number.

filters.slot.lte · number

Less than or equal to slot number.

filters.slot.lt · number

Less than slot number.

filters.blockTime · object

Filter by block timestamp (Unix timestamp).

filters.blockTime.gte · number

Greater than or equal to timestamp.

filters.blockTime.gt · number

Greater than timestamp.

filters.blockTime.lte · number

Less than or equal to timestamp.

filters.blockTime.lt · number

Less than timestamp.

filters.blockTime.eq · number

Equal to timestamp.

filters.signature · object

Filter by transaction signature.

filters.signature.gte · string

Get transactions with signatures greater than or equal to this value.

filters.signature.gt · string

Get transactions after this signature.

filters.signature.lte · string

Get transactions with signatures less than or equal to this value.

filters.signature.lt · string

Get transactions before this signature.

filters.status · string · default: "any"

Filter by transaction status.

• succeeded
• failed
• any

filters.tokenAccounts · string · default: "none"

Filter transactions for related token accounts. Controls whether to include transactions involving token accounts owned by the address.

• none
• balanceChanged
• all

filters.tokenTransfer · object

Narrows results to transactions where the queried address participated in a token transfer matching specific criteria. All fields are optional and combined with AND semantics.

filters.tokenTransfer.with · string

Counterparty address. Matches transfers whose other side is this address.

filters.tokenTransfer.direction · string · default: "any"

Transfer direction relative to the queried address.

• in
• out
• any

filters.tokenTransfer.mint · string

Token mint to filter on.

filters.tokenTransfer.amount · object

Raw on-chain amount range filter. All fields are optional and can be combined.

Authorizations

api-key · string · query · required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json

jsonrpc · enum<string> · default: 2.0 · required

The JSON-RPC protocol version.

Available options: 2.0

Example:

"2.0"

id · string · default: 1 · required

A unique identifier for the request.

Example:

"1"

method · enum<string> · default: getTransactionsForAddress · required

The name of the RPC method to invoke.

Available options: getTransactionsForAddress

Example:

"getTransactionsForAddress"

params · tuple · required

Array containing the required account address and optional configuration object.

Show child attributes

Example:

[
  "Vote111111111111111111111111111111111111111",
  {
    "transactionDetails": "signatures",
    "limit": 50,
    "sortOrder": "desc",
    "filters": {
      "status": "succeeded",
      "slot": { "gte": 1000, "lt": 2000 },
      "tokenTransfer": {
        "direction": "in",
        "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
      }
    }
  }
]

Response

200

application/json

Successfully retrieved transactions for the specified address.

jsonrpc · enum<string>

The JSON-RPC protocol version.

Available options: 2.0

Example:

"2.0"

id · string

Identifier matching the request.

Example:

"1"

result · object

Transaction data and pagination information.

Show child attributes