Assign an external Address as a Deposit Address

Virtual Accounts support adding existing blockchain addresses as Deposit Addresses.

• You can add an address by using the following v3 REST API endpoint.
• The most common use is for EVM-based (like Ethereum) Gas Pump.

Example request:

curl --request POST \
  --url 'https://api.tatum.io/v3/offchain/account/{id}/address/{address}' \
  --header 'x-api-key: {YOUR_API_KEY}'
//Response:
{
  address: '0x6d7abd9f164db455e5aabfb5a53307e8d5657555',
  currency: 'MATIC' // The currency will match the same as the Account
}

Good to Know

• Assigning a blockchain address to a Virtual Account created with an XPUB is impossible.
• Any on-chain assets already present in the blockchain address to bind to the Virtual Account will be ignored—more information HERE.

Disclaimer

Virtual Accounts are designed to hold a limited number of deposit addresses (1-5), similar to standard practices in Exchanges. While adding many deposit addresses may appear functional, this setup often leads to unrecoverable synchronization issues across users over time.

🚧

To avoid potential disruptions and ensure consistent performance, we recommend adhering to the intended usage of 1-5 deposit addresses per Virtual Account.