Get Native Balance (batch): API Migration (v3 to v4)

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


Endpoint Change Summary

Componentv3 (Legacy)v4 (New)
Standard Pattern/v3/{chain}/address/balance/batch/v4/data/blockchains/balance/batch

Deprecated v3 Endpoints

The following chain-specific endpoints have been consolidated:

Old v3 EndpointStatus
/v3/bitcoin/address/balance/batchDeprecated
/v3/dogecoin/address/balance/batchDeprecated
/v3/litecoin/address/balance/batchDeprecated

Migration Steps

1. Update Your Base URL

Standard endpoints:

- POST /v3/bitcoin/address/balance/batch
+ POST /v4/data/blockchains/balance/batch?chain=bitcoin-mainnet

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.