Wallet - Transaction History (Beta)

curl --request GET \
  --url https://public-api.birdeye.so/v1/wallet/tx_list \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-chain: <x-chain>'

import requests

url = "https://public-api.birdeye.so/v1/wallet/tx_list"

headers = {
    "x-chain": "<x-chain>",
    "X-API-KEY": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-chain': '<x-chain>', 'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/v1/wallet/tx_list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "solana": [
      {
        "txHash": "3MvG4bVz7HF76hWSGeGtcSkVAtDnLA5PmUVC97S22GPpGGvxbv7UqKEh91MVsAHJ35zSw4RkW9NBiHLfZbJm8xFn",
        "blockNumber": 328889251,
        "blockTime": "2025-03-24T15:06:14+00:00",
        "status": true,
        "from": "Gt4RRcMg2mzEN9SDtSUjEjezC9b1nXjEGDQyEVbrc7Sk",
        "to": "11111111111111111111111111111111",
        "fee": 80000,
        "mainAction": "send",
        "balanceChange": [
          {
            "amount": -165604794,
            "symbol": "SOL",
            "name": "Wrapped SOL",
            "decimals": 9,
            "address": "So11111111111111111111111111111111111111112",
            "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
            "isScaledUiToken": false,
            "multiplier": null
          }
        ],
        "contractLabel": {
          "address": "11111111111111111111111111111111",
          "name": "System Program",
          "metadata": {
            "icon": ""
          }
        },
        "tokenTransfers": [
          {
            "fromTokenAccount": "Gt4RRcMg2mzEN9SDtSUjEjezC9b1nXjEGDQyEVbrc7Sk",
            "toTokenAccount": "2YiHgAV2SaJYkLy63N3TMLZHKwkPKhWd3EUzAMZuay4T",
            "fromUserAccount": "Gt4RRcMg2mzEN9SDtSUjEjezC9b1nXjEGDQyEVbrc7Sk",
            "toUserAccount": "2YiHgAV2SaJYkLy63N3TMLZHKwkPKhWd3EUzAMZuay4T",
            "tokenAmount": 0.165524794,
            "mint": "So11111111111111111111111111111111111111111",
            "transferNative": true,
            "isScaledUiToken": false,
            "multiplier": null
          }
        ]
      }
    ]
  }
}

GET

wallet

tx_list

Wallet - Transaction History (Beta)

curl --request GET \
  --url https://public-api.birdeye.so/v1/wallet/tx_list \
  --header 'X-API-KEY: <api-key>' \
  --header 'x-chain: <x-chain>'

import requests

url = "https://public-api.birdeye.so/v1/wallet/tx_list"

headers = {
    "x-chain": "<x-chain>",
    "X-API-KEY": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-chain': '<x-chain>', 'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/v1/wallet/tx_list', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "solana": [
      {
        "txHash": "3MvG4bVz7HF76hWSGeGtcSkVAtDnLA5PmUVC97S22GPpGGvxbv7UqKEh91MVsAHJ35zSw4RkW9NBiHLfZbJm8xFn",
        "blockNumber": 328889251,
        "blockTime": "2025-03-24T15:06:14+00:00",
        "status": true,
        "from": "Gt4RRcMg2mzEN9SDtSUjEjezC9b1nXjEGDQyEVbrc7Sk",
        "to": "11111111111111111111111111111111",
        "fee": 80000,
        "mainAction": "send",
        "balanceChange": [
          {
            "amount": -165604794,
            "symbol": "SOL",
            "name": "Wrapped SOL",
            "decimals": 9,
            "address": "So11111111111111111111111111111111111111112",
            "logoURI": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png",
            "isScaledUiToken": false,
            "multiplier": null
          }
        ],
        "contractLabel": {
          "address": "11111111111111111111111111111111",
          "name": "System Program",
          "metadata": {
            "icon": ""
          }
        },
        "tokenTransfers": [
          {
            "fromTokenAccount": "Gt4RRcMg2mzEN9SDtSUjEjezC9b1nXjEGDQyEVbrc7Sk",
            "toTokenAccount": "2YiHgAV2SaJYkLy63N3TMLZHKwkPKhWd3EUzAMZuay4T",
            "fromUserAccount": "Gt4RRcMg2mzEN9SDtSUjEjezC9b1nXjEGDQyEVbrc7Sk",
            "toUserAccount": "2YiHgAV2SaJYkLy63N3TMLZHKwkPKhWd3EUzAMZuay4T",
            "tokenAmount": 0.165524794,
            "mint": "So11111111111111111111111111111111111111111",
            "transferNative": true,
            "isScaledUiToken": false,
            "multiplier": null
          }
        ]
      }
    ]
  }
}

Usage Note
Accessibility
Chain Supported

Beta wallet transaction history.

This endpoint returns transaction history for one wallet.
It is useful for quick wallet-history inspection, but it is still a beta endpoint.
ui_amount_mode controls Solana Token-2022 scaled amounts; other chains are normalized to scaled.

Compute Unit ⚙️

This endpoint consumes 50 CU per request.

Use Cases 💡

Review a wallet’s recent transaction history in a lightweight explorer flow.
Investigate funding, movement, and activity patterns around one wallet.
Support beta wallet-history views before deeper transfer or balance-change analysis.

How to Use 🛠️

Set x-chain=solana.
Pass the wallet address in wallet.
Use the endpoint’s pagination parameters to step backward through history.

Best Practices ✅

Cache wallet-history responses because they can be expensive to recompute repeatedly.
Use this endpoint for inspection, then move to newer transfer/balance-change endpoints for structured analysis.

Limitations ⚠️

Beta endpoint.
Solana only.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

required

A chain name listed in supported networks.

Available options:

solana

Query Parameters

wallet

string

required

The address of a wallet.

limit

integer

default:100

Limit the number of records returned.

Required range: 1 <= x <= 100

before

string

A transaction hash to traverse starting from. Only works with Solana.

ui_amount_mode

enum<string>

default:scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:

raw,

scaled

Response

JSON object containing the wallet's recent transaction history across supported chains.

success

boolean

required

Whether the request succeeded.

data

object

required

Transactions grouped by chain family or source bucket.

Show child attributes