> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 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.
## Request Parameters
Solana account address to retrieve transaction history for (wallet, token, program, NFT, etc.).
Level of transaction detail to return.
* `signatures`
* `full`
Sort order for returned transactions.
* `asc`
* `desc`
The commitment level for the request. The `processed` commitment is not supported.
* `confirmed`
* `finalized`
Minimum context slot to use for request (optional).
Maximum number of transactions per request. Use 1–1000 for transactionDetails:"signatures" and 1–1000 for transactionDetails:"full".
Pagination token from previous response to get next page of results (format "slot:position").
Encoding format for transaction data (applies only when transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Maximum transaction version to return (applies only when transactionDetails=full).
Advanced filters to narrow down transaction results.
Filter by slot number.
Greater than or equal to slot number.
Greater than slot number.
Less than or equal to slot number.
Less than slot number.
Filter by block timestamp (Unix timestamp).
Greater than or equal to timestamp.
Greater than timestamp.
Less than or equal to timestamp.
Less than timestamp.
Equal to timestamp.
Filter by transaction signature.
Get transactions with signatures greater than or equal to this value.
Get transactions after this signature.
Get transactions with signatures less than or equal to this value.
Get transactions before this signature.
Filter by transaction status.
* `succeeded`
* `failed`
* `any`
Filter transactions for related token accounts. Controls whether to include transactions involving token accounts owned by the address.
* `none`
* `balanceChanged`
* `all`
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.
Counterparty address. Matches transfers whose other side is this address.
Transfer direction relative to the queried address.
* `in`
* `out`
* `any`
Token mint to filter on.
Raw on-chain amount range filter. All fields are optional and can be combined.
## OpenAPI
````yaml openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
Advanced Solana transaction history API with powerful filtering, sorting,
and pagination capabilities for retrieving comprehensive transaction data
for any address.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Mainnet RPC endpoint
- url: https://devnet.helius-rpc.com
description: Devnet RPC endpoint
security: []
paths:
/:
post:
tags:
- RPC
summary: getTransactionsForAddress
description: >
Enhanced transaction history API that provides powerful filtering,
sorting, and pagination capabilities
for retrieving transaction data associated with any Solana address. This
advanced method overcomes the
limitations of getSignaturesForAddress by offering:
- Bidirectional sorting (ascending/descending chronological order)
- Advanced filtering by slot, time, signature, and transaction status
- Token account support (include transactions for associated token
accounts)
- Token transfer filtering by counterparty, direction, mint, and raw
amount
- Efficient keyset pagination using slot-based keys
- Option to return full transaction details or just signatures
- Support for time range queries and status filtering
Perfect for building comprehensive wallet histories, analytics
dashboards, audit trails,
and any application requiring detailed transaction analysis with precise
control over data retrieval.
operationId: getTransactionsForAddress
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
example: '2.0'
description: The JSON-RPC protocol version.
default: '2.0'
id:
type: string
example: '1'
description: A unique identifier for the request.
default: '1'
method:
type: string
enum:
- getTransactionsForAddress
example: getTransactionsForAddress
description: The name of the RPC method to invoke.
default: getTransactionsForAddress
params:
type: array
description: >-
Array containing the required account address and optional
configuration object.
minItems: 1
maxItems: 2
prefixItems:
- type: string
description: >-
Solana account address to retrieve transaction history
for (wallet, token, program, NFT, etc.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Advanced query configuration for filtering, sorting, and
pagination.
properties:
transactionDetails:
type: string
description: Level of transaction detail to return.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: Sort order for returned transactions.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
The commitment level for the request. The
`processed` commitment is not supported.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: Minimum context slot to use for request (optional).
example: 1000
limit:
type: integer
description: >-
Maximum number of transactions per request. Use
1–1000 for transactionDetails:"signatures" and
1–1000 for transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Pagination token from previous response to get next
page of results (format "slot:position").
example: '1053:13'
encoding:
type: string
description: >-
Encoding format for transaction data (applies only
when transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Maximum transaction version to return (applies only
when transactionDetails=full).
example: 0
filters:
type: object
description: Advanced filters to narrow down transaction results.
properties:
slot:
type: object
description: Filter by slot number.
properties:
gte:
type: integer
description: Greater than or equal to slot number.
example: 100
gt:
type: integer
description: Greater than slot number.
example: 100
lte:
type: integer
description: Less than or equal to slot number.
example: 200
lt:
type: integer
description: Less than slot number.
example: 200
additionalProperties: false
blockTime:
type: object
description: Filter by block timestamp (Unix timestamp).
properties:
gte:
type: integer
description: Greater than or equal to timestamp.
example: 1640995200
gt:
type: integer
description: Greater than timestamp.
example: 1640995200
lte:
type: integer
description: Less than or equal to timestamp.
example: 1641081600
lt:
type: integer
description: Less than timestamp.
example: 1641081600
eq:
type: integer
description: Equal to timestamp.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Filter by transaction signature.
properties:
gte:
type: string
description: >-
Get transactions with signatures greater
than or equal to this value.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: Get transactions after this signature.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Get transactions with signatures less than
or equal to this value.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: Get transactions before this signature.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Filter by transaction status.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Filter transactions for related token accounts.
Controls whether to include transactions
involving token accounts owned by the address.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Filter to transactions where the queried address
participated in a token transfer matching a
counterparty, direction, mint, or raw amount
range.
additionalProperties: false
items: false
default:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
example:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
example:
jsonrpc: '2.0'
id: '1'
method: getTransactionsForAddress
params:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 10
responses:
'200':
description: Successfully retrieved transactions for the specified address.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: The JSON-RPC protocol version.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identifier matching the request.
example: '1'
result:
type: object
description: Transaction data and pagination information.
properties:
data:
type: array
description: List of transaction information.
items:
oneOf:
- type: object
description: >-
Signature-level transaction summary (when
transactionDetails is "signatures").
properties:
signature:
type: string
description: >-
Transaction signature as a base-58 encoded
string.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: >-
The slot that contains the block with the
transaction.
example: 1054
transactionIndex:
type: integer
description: >-
The zero-based index of the transaction
within its block. Useful for determining
transaction ordering within a block.
example: 42
err:
oneOf:
- type: object
description: Error if the transaction failed
- type: 'null'
description: >-
Error if the transaction failed, or null if
successful.
example: null
memo:
oneOf:
- type: string
description: Memo associated with the transaction
- type: 'null'
description: >-
Memo associated with the transaction, or
null if none.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Estimated production time as Unix
timestamp
- type: 'null'
description: >-
Estimated production time as Unix timestamp
(seconds since epoch), or null if not
available.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Transaction's cluster confirmation
status
- type: 'null'
description: Transaction's cluster confirmation status.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Full transaction with status metadata (when
transactionDetails is "full").
properties:
slot:
type: integer
description: >-
The slot that contains the block with the
transaction.
example: 1054
transactionIndex:
type: integer
description: >-
The zero-based index of the transaction
within its block. Useful for determining
transaction ordering within a block.
example: 42
transaction:
type: object
description: >-
Encoded or parsed transaction object per the
selected encoding.
meta:
type: object
description: Transaction status metadata.
blockTime:
oneOf:
- type: integer
description: >-
Estimated production time as Unix
timestamp
- type: 'null'
description: >-
Estimated production time as Unix timestamp
(seconds since epoch), or null if not
available.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: Token for retrieving the next page of results
- type: 'null'
description: >-
Pagination token for next page, or null if no more
results.
example: '1055:5'
examples:
signaturesResponse:
summary: Response with signature details only
value:
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'
fullResponse:
summary: Response with full transaction details
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- slot: 1054
transactionIndex: 42
transaction:
signatures:
- >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
message:
accountKeys:
- ...
- ...
instructions:
- ...
meta:
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
blockTime: 1641038400
paginationToken: '1055:5'
'400':
description: Bad Request - Invalid request parameters or malformed request.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Unauthorized - Invalid or missing API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Too Many Requests - Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Internal Server Error - An error occurred on the server.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Service Unavailable - The service is temporarily unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Gateway Timeout - The request timed out.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: The JSON-RPC protocol version.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: The error code.
example: -32602
message:
type: string
description: The error message.
data:
type: object
description: Additional data about the error.
id:
type: string
description: Identifier matching the request.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Your Helius API key. You can get one for free in the
[dashboard](https://dashboard.helius.dev/api-keys).
````