Assign an Gas Pump Address as a Deposit Address

❗️

Attention

Access to this feature is limited to existing Virtual Account users on PayGo and higher tiers who registered before November 24, 2025

Virtual Accounts (VA) support adding existing blockchain addresses as Deposit Addresses. The most common use case is adding a Gas Pump (GP) address. See the GP flow at the following link.

• v3 REST API endpoint.

Once you have your "Slave GP Contract Addresses" ready, you may create a Virtual Account and add the address as a Deposit Address.

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

• You may add an external address to a VA, as long as said account was created without an XPUB.
• Assets that may be already present in the "Slave GP Contract Addresses" to be bound to the VA won't be considered to update the available balance.