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

Componentv3 (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 EndpointStatus
/v3/ada/accountDeprecated
/v3/algorand/account/balanceDeprecated
/v3/arb/account/balance/{address}Deprecated
/v3/avalanche/account/balanceDeprecated
/v3/base/account/balanceDeprecated
/v3/bitcoin/address/balance/{address}Deprecated
/v3/bsc/account/balance/{address}Deprecated
/v3/celo/account/balanceDeprecated
/v3/cronos/account/balanceDeprecated
/v3/dogecoin/address/balanceDeprecated
/v3/egld/account/balanceDeprecated
/v3/ethereum/account/balanceDeprecated
/v3/fantom/account/balanceDeprecated
/v3/flare/account/balanceDeprecated
/v3/kcs/account/balanceDeprecated
/v3/klaytn/account/balanceDeprecated
/v3/litecoin/address/balanceDeprecated
/v3/one/account/balanceDeprecated
/v3/optimism/account/balanceDeprecated
/v3/polygon/account/balanceDeprecated
/v3/solana/account/balanceDeprecated
/v3/sonic/account/balance/{address}Deprecated
/v3/tron/accountDeprecated
/v3/vet/account/balanceDeprecated
/v3/xdc/account/balanceDeprecated
/v3/xlm/accountDeprecated
/v3/xrp/accountDeprecated

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.