curl --request POST \
--url https://api.allium.so/api/v1/developer/wallet/balances/history \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '{
"addresses": [
{
"address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
"chain": "solana"
}
],
"end_timestamp": "2025-04-01T13:00:00Z",
"start_timestamp": "2025-04-01T12:00:00Z"
}'
{
"items": [
{
"chain": "<string>",
"address": "<string>",
"token": {
"object": "<string>",
"chain": "<string>",
"address": "<string>",
"type": "native",
"price": 123,
"decimals": 123,
"info": {
"name": "<string>",
"symbol": "<string>"
},
"attributes": {
"total_liquidity_usd": 123,
"price_diff_1d": 123,
"price_diff_pct_1d": 123,
"total_supply": 123,
"total_market_cap_usd": 123,
"volume_1h": 123,
"volume_24h": 123,
"volume_usd_1h": 123,
"volume_usd_24h": 123
}
},
"raw_balance": 123,
"block_timestamp": "2023-11-07T05:31:56Z",
"block_slot": 123,
"txn_index": 123,
"token_account": "<string>",
"block_hash": "<string>",
"txn_id": "<string>"
}
],
"cursor": "<string>"
}
Get the historical balances for a list of wallets.
curl --request POST \
--url https://api.allium.so/api/v1/developer/wallet/balances/history \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '{
"addresses": [
{
"address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
"chain": "solana"
}
],
"end_timestamp": "2025-04-01T13:00:00Z",
"start_timestamp": "2025-04-01T12:00:00Z"
}'
{
"items": [
{
"chain": "<string>",
"address": "<string>",
"token": {
"object": "<string>",
"chain": "<string>",
"address": "<string>",
"type": "native",
"price": 123,
"decimals": 123,
"info": {
"name": "<string>",
"symbol": "<string>"
},
"attributes": {
"total_liquidity_usd": 123,
"price_diff_1d": 123,
"price_diff_pct_1d": 123,
"total_supply": 123,
"total_market_cap_usd": 123,
"volume_1h": 123,
"volume_24h": 123,
"volume_usd_1h": 123,
"volume_usd_24h": 123
}
},
"raw_balance": 123,
"block_timestamp": "2023-11-07T05:31:56Z",
"block_slot": 123,
"txn_index": 123,
"token_account": "<string>",
"block_hash": "<string>",
"txn_id": "<string>"
}
],
"cursor": "<string>"
}
Max number of items returned. Default is 1000.
x > 0
Cursor to request the next page of results.
List of wallet chain+address pairs and a start and end timestamp to fetch historical balances for.
Successful Response
The response is of type object
.
Was this page helpful?