Wallet - Balance Change

curl --request GET \
  --url https://public-api.birdeye.so/wallet/v2/balance-change \
  --header 'X-API-KEY: <api-key>'

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

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

{
  "success": true,
  "data": {
    "items": [
      {
        "time": "2026-10-13T00:00:00Z",
        "block_number": 86000000,
        "block_unix_time": 1791849600,
        "address": "0x1111111111111111111111111111111111111111",
        "token_account": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "tx_hash": "",
        "pre_balance": "1000000000000000000",
        "post_balance": "1000000000000000001",
        "amount": "1",
        "unverified_balance": false,
        "token_info": {
          "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
          "decimals": 18,
          "symbol": "ETH",
          "name": "Ether",
          "logo_uri": ""
        },
        "type": 1,
        "type_text": "NATIVE",
        "change_type": 1,
        "change_type_text": "INCR"
      }
    ]
  }
}

GET

wallet

balance-change

Wallet - Balance Change

curl --request GET \
  --url https://public-api.birdeye.so/wallet/v2/balance-change \
  --header 'X-API-KEY: <api-key>'

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

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

{
  "success": true,
  "data": {
    "items": [
      {
        "time": "2026-10-13T00:00:00Z",
        "block_number": 86000000,
        "block_unix_time": 1791849600,
        "address": "0x1111111111111111111111111111111111111111",
        "token_account": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "tx_hash": "",
        "pre_balance": "1000000000000000000",
        "post_balance": "1000000000000000001",
        "amount": "1",
        "unverified_balance": false,
        "token_info": {
          "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
          "decimals": 18,
          "symbol": "ETH",
          "name": "Ether",
          "logo_uri": ""
        },
        "type": 1,
        "type_text": "NATIVE",
        "change_type": 1,
        "change_type_text": "INCR"
      }
    ]
  }
}

Usage Note
Accessibility
Chain Supported

Balance-delta history for one Solana wallet.

Filter by token_address when you want one token only, or omit it for broader wallet activity.
token_type and change_type narrow the result to the asset class and change direction you care about.
time_from and time_to let you constrain the review window.
Pagination uses offset up to 10,000 and limit up to 100.
ui_amount_mode=scaled applies Solana Token-2022 scaled UI amount when the token supports the scaled UI extension.

Reading the numbers. Balance-change rows explain how a wallet’s token balance moved over time, which token changed, and by how much after decimal or scaled UI normalization.

Compute Unit ⚙️

This endpoint consumes 10 CU per request.

Use Cases 💡

Review how a wallet accumulated, distributed, or rotated tokens over time.
Power audit trails, treasury monitoring, and operator activity review.
Isolate changes for one token before drilling into transfer-level events.

How to Use 🛠️

Set x-chain=solana.
Pass the wallet address in wallet.
Add token_address, token_type, or change_type when you need a narrower slice.
Use time_from and time_to for bounded investigations.
Page through results with offset and limit.

Best Practices ✅

Start broad, then add token and change filters once you see the wallet’s activity pattern.
Use this endpoint to find the interesting timestamps, then pair it with transfer endpoints for exact movement details.
Keep ui_amount_mode aligned with other Solana Token-2022 analysis for consistent quantities.

Limitations ⚠️

Solana only.
Offset pagination tops out at 10,000.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana or Robinhood. Robinhood supports balance-change, current-net-worth, V1/V2 token balance and /defi/v3/token/holder. Other wallet history and transfer endpoints have separate chain support.

Available options:

solana,

robinhood

Query Parameters

address

string

required

The address of the account.

token_address

string

The address of the token contract.

time_from

integer

Specify the start time using unix timestamps in seconds

Required range: 0 <= x <= 10000000000

time_to

integer

Specify the end time using unix timestamps in seconds

Required range: 0 <= x <= 10000000000

type

enum<string>

Solana: SOL or SPL. Robinhood: NATIVE or TOKEN. Omit to include all supported token types.

Available options:

SOL,

SPL,

NATIVE,

TOKEN

change_type

enum<string>

Available options:

increase,

decrease

offset

integer

default:0

Make sure offset <= 10000

Required range: 0 <= x <= 10000

limit

integer

default:20

Required range: 1 <= x <= 100

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 a list of balance changes of an address

success

boolean

required

Whether the request succeeded.

data

object

required

Show child attributes