API Endpoints

Wallet - Balance Change

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

Retrieve wallet balance-change history on Solana or Robinhood (10 CU). Supply time_from and time_to together or omit both. On Robinhood, rows summarize block-level balance movements, not individual transfers: tx_hash can be empty for reconciliation/accrual and fee-account hashes are representative, not necessarily the cause of the change. Rows marked unverified_balance are not RPC-certified. Adjacent rows need not connect when filtered or when token balances change without Transfer events. Scaled UI applies only to Solana.

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 8 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

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

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 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.

Allowed:
Responses

Updated 13 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 13 days ago

Did this page help you?