Skip to main content
POST
getTransactionsForAddress
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
    }
  ]
}
'
{
  "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
Base-58 encoded public key of the account to query transaction history for
​
transactionDetails
string
default:"signatures"
Level of transaction detail to return:
  • signatures: Basic signature info (faster)
  • full: Complete transaction data (eliminates need for getTransaction calls, requires limit ≤ 100)
​
sortOrder
string
default:"desc"
Sort order for results:
  • desc: Newest first (default)
  • asc: Oldest first (chronological, great for historical analysis)
​
limit
number
default:"1000"
Maximum transactions to return:
  • Up to 1000 when transactionDetails: "signatures"
  • Up to 100 when transactionDetails: "full"
​
paginationToken
string
Pagination token from previous response (format: "slot:position")
​
commitment
string
default:"finalized"
Commitment level: finalized or confirmed. The processed commitment is not supported.
​
filters
object
Advanced filtering options for narrowing down results.
​
filters.slot
object
Filter by slot number using comparison operators: gte, gt, lte, ltExample: { "slot": { "gte": 1000, "lte": 2000 } }
​
filters.blockTime
object
Filter by Unix timestamp using comparison operators: gte, gt, lte, lt, eqExample: { "blockTime": { "gte": 1640995200, "lte": 1641081600 } }
​
filters.signature
object
Filter by transaction signature using comparison operators: gte, gt, lte, ltExample: { "signature": { "lt": "SIGNATURE_STRING" } }
​
filters.status
string
Filter by transaction success/failure status:
  • succeeded: Only successful transactions
  • failed: Only failed transactions
  • any: Both successful and failed (default)
Example: { "status": "succeeded" }
​
filters.tokenAccounts
string
default:"none"
Filter transactions for related token accounts:
  • none: Only return transactions that reference the provided address (default)
  • balanceChanged: Return transactions that reference either the provided address or modify the balance of a token account owned by the provided address (recommended)
  • all: Return transactions that reference either the provided address or any token account owned by the provided address
Example: { "tokenAccounts": "balanceChanged" }
​
encoding
string
Encoding format for transaction data (only applies when transactionDetails: "full"). Same as getTransaction API. Options: json, jsonParsed, base64, base58
​
maxSupportedTransactionVersion
number
Set the max transaction version to return. If omitted, only legacy transactions will be returned. Set to 0 to include all versioned transactions.
​
minContextSlot
number
The minimum slot that the request can be evaluated at

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.

Example:
[
  "Vote111111111111111111111111111111111111111",
  {
    "transactionDetails": "signatures",
    "limit": 50,
    "sortOrder": "desc",
    "filters": {
      "status": "succeeded",
      "slot": { "gte": 1000, "lt": 2000 }
    }
  }
]

Response

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.