Skip to main content
GET
Wallet - Balance Change

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.

  • This endpoint consumes 8 CU per request.
  • 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.
  • 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.
  • 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.
  • 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 network only.

Available options:
solana

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>
Available options:
SOL,
SPL
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