Send ETH from a virtual account to the blockchain

/v3/offchain/ethereum/transfer

4 credits per API call.


Send ETH (Ethereum) from a virtual account to the blockchain. This will create Tatum internal withdrawal request with ID. If every system works as expected, withdrawal request is marked as complete and transaction id is assigned to it.

  • If Ethereum server connection is unavailable, withdrawal request is cancelled.
  • If blockchain transfer is successful, but is it not possible to reach Tatum, transaction id of blockchain transaction is returned and withdrawal request must be completed manually, otherwise all other withdrawals will be pending.
It is possible to perform ledger to blockchain transaction for ledger accounts without blockchain address assigned to them.
This operation needs the private key of the blockchain address. Every time the funds are transferred, the transaction must be signed with the corresponding private key. No one should ever send it's own private keys to the internet because there is a strong possibility of stealing keys and losing funds. In this method, it is possible to enter privateKey or signatureId. PrivateKey should be used only for quick development on testnet versions of blockchain when there is no risk of losing funds. In production, Tatum KMS should be used for the highest security standards, and signatureId should be present in the request. Alternatively, using the Tatum client library for supported languages.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
number
≥ 0

The nonce to be set to the transaction; if not present, the last known nonce will be used

string
required
length between 42 and 42

Blockchain address to send assets

string
required
length ≤ 38

Amount to be sent in Ether | MATIC | XDC | KCS.

boolean

Compliance check, if withdrawal is not compliant, it will not be processed.

string
required
length between 66 and 66

Private key of sender address. Either mnemonic and index, privateKey or signature Id must be present - depends on the type of account and xpub.

string
length between 1 and 100

Identifier of the payment, shown for created Transaction within Tatum sender account.

string
required
length between 24 and 24

Sender account ID

string
length between 1 and 500

Note visible to owner of withdrawing account

string

Gas limit for transaction in gas price. If not set, automatic calculation will be used.

string

Gas price in Gwei. If not set, automatic calculation will be used.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json