Skip to main content
GET
/
v1
/
wallet
/
{wallet}
/
history
Get transaction history
curl --request GET \
  --url 'https://api.helius.xyz/v1/wallet/{wallet}/history?api-key='
{
  "data": [
    {
      "signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE",
      "slot": 250000000,
      "fee": 0.000005,
      "feePayer": "GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz",
      "balanceChanges": [
        {
          "mint": "So11111111111111111111111111111111111111112",
          "amount": -0.05,
          "decimals": 9
        }
      ],
      "timestamp": 1704067200,
      "error": null
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE"
  }
}

โ€‹
Request Parameters

โ€‹
wallet
string
required
Solana wallet address (base58 encoded)
โ€‹
limit
number
default:"100"
Maximum number of transactions per request
โ€‹
before
string
Fetch transactions before this signature (use pagination.nextCursor from previous response)
โ€‹
after
string
Fetch transactions after this signature (for ascending order pagination)
โ€‹
type
string
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
โ€‹
tokenAccounts
string
default:"balanceChanged"
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

Authorizations

โ€‹
api-key
string
query
required

API key passed as query parameter

Path Parameters

โ€‹
wallet
string
required

Solana wallet address (base58 encoded)

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

Query Parameters

โ€‹
limit
integer
default:100

Maximum number of transactions per request

Required range: 1 <= x <= 100
โ€‹
before
string

Fetch transactions before this signature (use pagination.nextCursor from previous response)

โ€‹
after
string

Fetch transactions after this signature (for ascending order pagination)

โ€‹
type
enum<string>

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

Available options:
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
โ€‹
tokenAccounts
enum<string>
default:balanceChanged

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)
Available options:
none,
balanceChanged,
all

Response

Transaction history retrieved successfully

โ€‹
data
object[]
required
โ€‹
pagination
object
required