Get Transaction History (UTXO): API Migration (v3 to v4)

This guide covers the migration from legacy v3 chain-specific Get transaction history endpoints to the new unified Blockchains API endpoint Get UTXO transaction history

Endpoint Change Summary

Component	v3 (Legacy)	v4 (New)
Standard Pattern	`/v3/{chain}/transaction/address/{address}`	`/v4/data/blockchains/transaction/history/utxos`

Deprecated v3 Endpoints

The following chain-specific endpoints have been consolidated:

Old v3 Endpoint	Status
`/v3/ada/transaction/address/{address}`	Deprecated
`/v3/bitcoin/transaction/address/{address}`	Deprecated
`/v3/dogecoin/transaction/address/{address}`	Deprecated
`/v3/litecoin/transaction/address/{address}`	Deprecated

Migration Steps

1. Update Your Base URL

Standard endpoints:

- GET /v3/bitcoin/transaction/address/{address}
+ GET /v4/data/blockchains/transaction/history/utxos?chain=bitcoin-mainnet&addresses={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.