Get Wallet History

GET

wallet

{wallet}

history

Get transaction history

curl --request GET \
  --url 'https://api.helius.xyz/v1/wallet/{wallet}/history?api-key='

const options = {method: 'GET'};

fetch('https://api.helius.xyz/v1/wallet/{wallet}/history?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helius.xyz/v1/wallet/{wallet}/history?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helius.xyz/v1/wallet/{wallet}/history?api-key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.helius.xyz/v1/wallet/{wallet}/history?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "error": "Invalid wallet address",
  "code": 400,
  "details": "'invalid-address' is not a valid Solana address"
}

{
  "error": "API key required. Pass via ?api-key=xxx or X-Api-Key header",
  "code": 401
}

{
  "error": "RATE_LIMIT_EXCEEDED",
  "code": 429,
  "details": "Too many requests. Retry after 2 seconds."
}

{
  "error": "INTERNAL_ERROR",
  "code": 500,
  "details": "An unexpected error occurred. Please retry."
}

Each request costs 100 credits.

Request Parameters

string

default:"GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz"

required

Solana wallet address (base58 encoded)

number

default:"100"

Maximum number of transactions per request

string

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

string

Fetch transactions after this signature (for ascending order pagination)

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

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

default:GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz

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>

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

Show child attributes

pagination

object

required

Show child attributes

⌘I

Get transaction history

curl --request GET \
  --url 'https://api.helius.xyz/v1/wallet/{wallet}/history?api-key='

const options = {method: 'GET'};

fetch('https://api.helius.xyz/v1/wallet/{wallet}/history?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helius.xyz/v1/wallet/{wallet}/history?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helius.xyz/v1/wallet/{wallet}/history?api-key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.helius.xyz/v1/wallet/{wallet}/history?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "error": "Invalid wallet address",
  "code": 400,
  "details": "'invalid-address' is not a valid Solana address"
}

{
  "error": "API key required. Pass via ?api-key=xxx or X-Api-Key header",
  "code": 401
}

{
  "error": "RATE_LIMIT_EXCEEDED",
  "code": 429,
  "details": "Too many requests. Retry after 2 seconds."
}

{
  "error": "INTERNAL_ERROR",
  "code": 500,
  "details": "An unexpected error occurred. Please retry."
}

Get Started

Data Streaming & Event Listening

Data APIs & RPCs

Trading

Sending Transactions

Account Management

Request Parameters

Authorizations

Path Parameters

Query Parameters

Response

​Request Parameters

Authorizations

Path Parameters

Query Parameters

Response

Request Parameters