API Endpoints

Wallet - Balance Change

get
https://public-api.birdeye.so/wallet/v2/balance-change

Retrieve the balance change history of a wallet.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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.

Query Params
string
required

The address of the account.

string

The address of the token contract.

integer
0 to 10000000000

Specify the start time using unix timestamps in seconds

integer
0 to 10000000000

Specify the end time using unix timestamps in seconds

string
enum
Allowed:
string
enum
Allowed:
integer
0 to 10000
Defaults to 0

Make sure offset <= 10000

integer
1 to 100
Defaults to 20
string
enum
Defaults to scaled

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

Allowed:
Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

Updated 10 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 10 days ago

Did this page help you?