> ## 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.
# Get Wallet History
> Retrieve the full transaction history for a Solana wallet with pagination.
Each request costs **100 credits**.
## Request Parameters
Solana wallet address (base58 encoded)
Maximum number of transactions per request
Fetch transactions before this signature (use `pagination.nextCursor` from previous response)
Fetch transactions after this signature (for ascending order pagination)
Filter by transaction type. Available types: SWAP, TRANSFER, NFT\_SALE, NFT\_BID, NFT\_LISTING,
NFT\_MINT, NFT\_CANCEL\_LISTING, TOKEN\_MINT, BURN, COMPRESSED\_NFT\_MINT, COMPRESSED\_NFT\_TRANSFER,
COMPRESSED\_NFT\_BURN, CREATE\_STORE, WHITELIST\_CREATOR, ADD\_TO\_WHITELIST, REMOVE\_FROM\_WHITELIST,
AUCTION\_MANAGER\_CLAIM\_BID, EMPTY\_PAYMENT\_ACCOUNT, UPDATE\_PRIMARY\_SALE\_METADATA, ADD\_TOKEN\_TO\_VAULT,
ACTIVATE\_VAULT, INIT\_VAULT, INIT\_BANK, INIT\_STAKE, MERGE\_STAKE, SPLIT\_STAKE, CREATE\_AUCTION\_MANAGER,
START\_AUCTION, CREATE\_AUCTION\_MANAGER\_V2, UPDATE\_EXTERNAL\_PRICE\_ACCOUNT, EXECUTE\_TRANSACTION
* `SWAP`
* `TRANSFER`
* `NFT_SALE`
* `NFT_BID`
* `NFT_LISTING`
* `NFT_MINT`
* `NFT_CANCEL_LISTING`
* `TOKEN_MINT`
* `BURN`
* `COMPRESSED_NFT_MINT`
* `COMPRESSED_NFT_TRANSFER`
* `COMPRESSED_NFT_BURN`
* `CREATE_STORE`
* `WHITELIST_CREATOR`
* `ADD_TO_WHITELIST`
* `REMOVE_FROM_WHITELIST`
* `AUCTION_MANAGER_CLAIM_BID`
* `EMPTY_PAYMENT_ACCOUNT`
* `UPDATE_PRIMARY_SALE_METADATA`
* `ADD_TOKEN_TO_VAULT`
* `ACTIVATE_VAULT`
* `INIT_VAULT`
* `INIT_BANK`
* `INIT_STAKE`
* `MERGE_STAKE`
* `SPLIT_STAKE`
* `CREATE_AUCTION_MANAGER`
* `START_AUCTION`
* `CREATE_AUCTION_MANAGER_V2`
* `UPDATE_EXTERNAL_PRICE_ACCOUNT`
* `EXECUTE_TRANSACTION`
Filter transactions involving token accounts owned by the wallet.
* `balanceChanged` (recommended): Includes transactions that changed token balances, filters spam
* `none`: Only transactions directly referencing the wallet
* `all`: All transactions including token accounts (may include spam)
* `none`
* `balanceChanged`
* `all`
## OpenAPI
````yaml openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/history
openapi: 3.0.3
info:
title: Wallet API
description: >
A high-performance REST API for querying Solana wallet data including
balances, transaction history, transfers, and identity information.
## Authentication
All requests require an API key passed either as:
- Query parameter: `?api-key=YOUR_API_KEY`
- Header: `X-Api-Key: YOUR_API_KEY`
version: 1.0.0
contact:
name: API Support
url: https://helius.dev
servers:
- url: https://api.helius.xyz
description: Production server
security:
- ApiKeyQuery: []
- ApiKeyHeader: []
tags:
- name: Identity
description: Lookup wallet identities and known addresses
- name: Balances
description: Query token and NFT balances
- name: History
description: Transaction history and balance changes
- name: Transfers
description: Token transfer activity
- name: Funding
description: Wallet funding information
paths:
/v1/wallet/{wallet}/history:
get:
tags:
- History
summary: Get transaction history
description: >
Retrieve transaction history for a wallet using the Enhanced
Transactions API.
Returns human-readable, parsed transactions with balance changes for
each transaction.
**Pagination is manual** - the API returns up to 100 transactions per
request.
Returns transactions in reverse chronological order (newest first).
**Associated Token Accounts (ATAs):** The `tokenAccounts` parameter
controls whether transactions
involving token accounts owned by the wallet are included:
- `balanceChanged` (recommended): Includes transactions that changed
token account balances, filtering spam
- `none`: Only direct wallet interactions
- `all`: All token account transactions including spam
**Pagination:** Use the `before` parameter with `pagination.nextCursor`
to fetch the next page.
The response includes `pagination.hasMore` to indicate if more results
are available.
Each request makes a single API call and costs 100 credits.
operationId: getWalletHistory
parameters:
- $ref: '#/components/parameters/WalletAddress'
- name: limit
in: query
description: Maximum number of transactions per request
schema:
type: integer
minimum: 1
maximum: 100
default: 100
example: 100
- name: before
in: query
description: >-
Fetch transactions before this signature (use
`pagination.nextCursor` from previous response)
schema:
type: string
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
- name: after
in: query
description: >-
Fetch transactions after this signature (for ascending order
pagination)
schema:
type: string
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
- name: type
in: query
description: >
Filter by transaction type. Available types: SWAP, TRANSFER,
NFT_SALE, NFT_BID, NFT_LISTING,
NFT_MINT, NFT_CANCEL_LISTING, TOKEN_MINT, BURN, COMPRESSED_NFT_MINT,
COMPRESSED_NFT_TRANSFER,
COMPRESSED_NFT_BURN, CREATE_STORE, WHITELIST_CREATOR,
ADD_TO_WHITELIST, REMOVE_FROM_WHITELIST,
AUCTION_MANAGER_CLAIM_BID, EMPTY_PAYMENT_ACCOUNT,
UPDATE_PRIMARY_SALE_METADATA, ADD_TOKEN_TO_VAULT,
ACTIVATE_VAULT, INIT_VAULT, INIT_BANK, INIT_STAKE, MERGE_STAKE,
SPLIT_STAKE, CREATE_AUCTION_MANAGER,
START_AUCTION, CREATE_AUCTION_MANAGER_V2,
UPDATE_EXTERNAL_PRICE_ACCOUNT, EXECUTE_TRANSACTION
schema:
type: string
enum:
- SWAP
- TRANSFER
- NFT_SALE
- NFT_BID
- NFT_LISTING
- NFT_MINT
- NFT_CANCEL_LISTING
- TOKEN_MINT
- BURN
- COMPRESSED_NFT_MINT
- COMPRESSED_NFT_TRANSFER
- COMPRESSED_NFT_BURN
- CREATE_STORE
- WHITELIST_CREATOR
- ADD_TO_WHITELIST
- REMOVE_FROM_WHITELIST
- AUCTION_MANAGER_CLAIM_BID
- EMPTY_PAYMENT_ACCOUNT
- UPDATE_PRIMARY_SALE_METADATA
- ADD_TOKEN_TO_VAULT
- ACTIVATE_VAULT
- INIT_VAULT
- INIT_BANK
- INIT_STAKE
- MERGE_STAKE
- SPLIT_STAKE
- CREATE_AUCTION_MANAGER
- START_AUCTION
- CREATE_AUCTION_MANAGER_V2
- UPDATE_EXTERNAL_PRICE_ACCOUNT
- EXECUTE_TRANSACTION
example: SWAP
- name: tokenAccounts
in: query
description: >
Filter transactions involving token accounts owned by the wallet.
- `balanceChanged` (recommended): Includes transactions that changed
token balances, filters spam
- `none`: Only transactions directly referencing the wallet
- `all`: All transactions including token accounts (may include
spam)
schema:
type: string
enum:
- none
- balanceChanged
- all
default: balanceChanged
example: balanceChanged
responses:
'200':
description: Transaction history retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/HistoryResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
parameters:
WalletAddress:
name: wallet
in: path
required: true
description: Solana wallet address (base58 encoded)
schema:
type: string
pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
example: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
schemas:
HistoryResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/HistoryTransaction'
pagination:
$ref: '#/components/schemas/Pagination'
required:
- data
- pagination
HistoryTransaction:
type: object
properties:
signature:
type: string
description: Transaction signature
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
timestamp:
type: integer
nullable: true
description: Unix timestamp in seconds
example: 1704067200
slot:
type: integer
description: Slot number
example: 250000000
fee:
type: number
description: Transaction fee in SOL
example: 0.000005
feePayer:
type: string
description: Address that paid the transaction fee
example: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
error:
type: string
nullable: true
description: Error message if transaction failed
example: null
balanceChanges:
type: array
items:
$ref: '#/components/schemas/BalanceChange'
description: All balance changes in this transaction
required:
- signature
- slot
- fee
- feePayer
- balanceChanges
Pagination:
type: object
properties:
hasMore:
type: boolean
description: Whether more results are available
example: true
nextCursor:
type: string
nullable: true
description: Cursor to fetch the next page of results
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
required:
- hasMore
Error:
type: object
properties:
error:
type: string
description: Error message
example: Invalid wallet address
code:
type: integer
description: HTTP status code
example: 400
details:
type: string
description: Additional error details
example: '''invalid-address'' is not a valid Solana address'
required:
- error
- code
BalanceChange:
type: object
properties:
mint:
type: string
description: Token mint address (or 'SOL' for native)
example: So11111111111111111111111111111111111111112
amount:
type: number
description: Change amount (positive for increase, negative for decrease)
example: -0.05
decimals:
type: integer
description: Token decimals
example: 9
required:
- mint
- amount
- decimals
responses:
BadRequest:
description: Invalid request parameters
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Invalid wallet address
code: 400
details: '''invalid-address'' is not a valid Solana address'
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: API key required. Pass via ?api-key=xxx or X-Api-Key header
code: 401
RateLimited:
description: Rate limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: RATE_LIMIT_EXCEEDED
code: 429
details: Too many requests. Retry after 2 seconds.
InternalError:
description: Transient server error. Retryable with exponential backoff.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: INTERNAL_ERROR
code: 500
details: An unexpected error occurred. Please retry.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: API key passed as query parameter
ApiKeyHeader:
type: apiKey
in: header
name: X-Api-Key
description: API key passed in request header
````