Generate custodial wallet addressDeprecated
2 credits per API call.
Generate new gas pump smart contract address on the blockchain. It's possible to enable tokens, which should be detected and supported on that address. This address enables custodial providers to
receive native assets, ERC20 / ERC721 / ERC1155 tokens on behalf of their customers on dedicated blockchain address, but in the same time it can initiate transfer of those assets away.
Gas required for the transfer from that address is going to be deducted from the providers address - the one, which was used to generate the address on the blockchain.
There are multiple options, how this address can be setup - it cannot be changed in the future:
- Native assets only - ETH, BSC, CELO, MATIC, ONE, TRX
- Native assets + ERC20 tokens
- Native assets + ERC721 tokens
- Native assets + ERC1155 tokens - TRON does not support 1155 standard
- Native assets + ERC20 + ERC721 tokens
- Native assets + ERC20 + ERC1155 tokens - TRON does not support 1155 standard
- Native assets + ERC721 + ERC1155 tokens - TRON does not support 1155 standard
- Native assets + ERC20 + ERC721 + ERC1155 tokens - TRON does not support 1155 standard
All of these options could be enabled with a batch mode as well - in 1 transaction, it is possible to transfer multiple different assets from that address, e.g. ETH + USDC + ERC721 token. Without batch mode, 3 separate transaction must have been performed.
This operation deploys a smart contract on the blockchain. More assets you will support, more intial gas will be used for address creation. Batch mode adds more gas for every type.
Supported blockchains:
- Binance Smart Chain
- Harmony.ONE
- Ethereum
- Celo
- TRON - without 1155
- Polygon (Matic)
Request Body schema: application/json
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
- Payload
- curl
- JavaScript
- Python
- PHP
- Go
- C#
{- "chain": "ETH",
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "enableFungibleTokens": false,
- "enableNonFungibleTokens": false,
- "enableSemiFungibleTokens": false,
- "enableBatchTransactions": false,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}, - "nonce": 0
}- 200
- 400
- 401
- 403
- 500
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}Generate gas pump wallet address
2 credits per API call.
Generate new gas pump smart contract address on the blockchain. This address enables custodial providers to
receive native assets, ERC20 / ERC721 / ERC1155 tokens on behalf of their customers on dedicated blockchain address, but in the same time it can initiate transfer of those assets away.
Gas required for the transfer from that address is going to be deducted from the providers address - the one, which was used to generate the address on the blockchain.
This operation deploys a smart contract on the blockchain.
For paid plans, it is possible to pay for the gas costs - you don't have to provide private key or signatureId. Blockchain fees will be covered by your credits.
Supported blockchains:
- Ethereum
- Binance Smart Chain
- Celo
- Polygon (Matic)
- Klaytn
- Harmony.ONE
- XDC Network (XinFin)
- Tron
header Parameters
Request Body schema: application/json
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
- Payload
- curl
- JavaScript
- Python
- PHP
- Go
- C#
{- "chain": "MATIC",
- "feesCovered": true,
- "batchCount": 270,
- "owner": "0x8cb76aed9c5e336ef961265c6079c14e9cd3d2ea"
}- 200
- 400
- 401
- 403
- 500
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}Get gas pump addresses from transaction
1 credit per API call.
Get gas pump smart contract addresses from deploy transaction.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
- curl
- JavaScript
- Python
- PHP
- Go
- C#
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/blockchain/sc/custodial/{chain}/{hash}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
- 200
- 400
- 401
- 403
- 500
[- "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8"
]Approve transfer of assets from gas pump wallet
2 credits per API call.
Approve transfer of assets from the gas pump smart contract wallet.
Supported blockchains:
- Binance Smart Chain
- Harmony.ONE
- Ethereum
- Klaytn
- Celo
- Harmony.ONE
- XDC Network (XinFin)
- Polygon (Matic)
Request Body schema: application/json
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
- Payload
- curl
- JavaScript
- Python
- PHP
- Go
- C#
{- "chain": "ETH",
- "custodialAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "tokenAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "contractType": 0,
- "spender": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "amount": "100000",
- "tokenId": "100000",
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}- 200
- 400
- 401
- 403
- 500
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}Transfer assets from gas pump wallet
2 credits per API call.
Transfer assets from the gas pump smart contract wallet. Originator of this transaction must be the address which created the address.
It's possible to transfer only 1 assets in 1 transaction.
Supported blockchains:
- Binance Smart Chain
- Harmony.ONE
- Ethereum
- Klaytn
- Celo
- TRON
- XDC Network (XinFin)
- Polygon (Matic)
Request Body schema: application/json
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
- Payload
- curl
- JavaScript
- Python
- PHP
- Go
- C#
{- "chain": "ETH",
- "custodialAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "tokenAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "contractType": 0,
- "recipient": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "amount": "100000",
- "tokenId": "100000",
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}- 200
- 400
- 401
- 403
- 500
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}Transfer multiple assets from gas pump wallet
2 credits per API call.
Transfer assets from the gas pump smart contract wallet. Originator of this transaction must be the address which created the address.
It's possible to transfer any amount of different assets in 1 transaction, if the wallet was generated with the batch option enabled.
Supported blockchains:
- Binance Smart Chain
- Harmony.ONE
- XDC Network (XinFin)
- Ethereum
- Klaytn
- Celo
- Tron
- Polygon (Matic)
Request Body schema: application/json
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
- Payload
- curl
- JavaScript
- Python
- PHP
- Go
- C#
{- "chain": "ETH",
- "custodialAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "tokenAddress": [
- "0x687422eEA2cB73B5d3e242bA5456b782919AFc85"
], - "contractType": [
- 0
], - "recipient": [
- "0x687422eEA2cB73B5d3e242bA5456b782919AFc85"
], - "amount": [
- "100000"
], - "tokenId": [
- "100000"
], - "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}- 200
- 400
- 401
- 403
- 500
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}