Get Native Balance: API Migration (v3 to v4)

This guide covers the migration from legacy v3 chain-specific Get native balance endpoints to the new unified Blockchains API endpoint Get native balance

Endpoint Change Summary

Component	v3 (Legacy)	v4 (New)
Standard Pattern	`/v3/{chain}/account/balance`, `/v3/{chain}/address/balance/{address}`	`/v4/data/blockchains/balance`

Deprecated v3 Endpoints

The following chain-specific endpoints have been consolidated:

Old v3 Endpoint	Status
`/v3/ada/account`	Deprecated
`/v3/algorand/account/balance`	Deprecated
`/v3/arb/account/balance/{address}`	Deprecated
`/v3/avalanche/account/balance`	Deprecated
`/v3/base/account/balance`	Deprecated
`/v3/bitcoin/address/balance/{address}`	Deprecated
`/v3/bsc/account/balance/{address}`	Deprecated
`/v3/celo/account/balance`	Deprecated
`/v3/cronos/account/balance`	Deprecated
`/v3/dogecoin/address/balance`	Deprecated
`/v3/egld/account/balance`	Deprecated
`/v3/ethereum/account/balance`	Deprecated
`/v3/fantom/account/balance`	Deprecated
`/v3/flare/account/balance`	Deprecated
`/v3/kcs/account/balance`	Deprecated
`/v3/klaytn/account/balance`	Deprecated
`/v3/litecoin/address/balance`	Deprecated
`/v3/one/account/balance`	Deprecated
`/v3/optimism/account/balance`	Deprecated
`/v3/polygon/account/balance`	Deprecated
`/v3/solana/account/balance`	Deprecated
`/v3/sonic/account/balance/{address}`	Deprecated
`/v3/tron/account`	Deprecated
`/v3/vet/account/balance`	Deprecated
`/v3/xdc/account/balance`	Deprecated
`/v3/xlm/account`	Deprecated
`/v3/xrp/account`	Deprecated

Migration Steps

1. Update Your Base URL

Standard endpoints:

- GET /v3/ethereum/account/balance
+ GET /v4/data/blockchains/balance?chain=ethereum-mainnet&address={address}

2. Adjust Chain Identifiers

Ensure you're using the new chain identifier format (e.g., ethereum-mainnet instead of ethereum).

3. Update Response Handling

Review your code for any response schema changes between v3 and v4.

🚧
Attention
Mind potential breaking changes.