Assign an external Address as a Deposit Address
Assign an external address as a deposit address into a Virtual Account
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.
Updated 21 days ago