Create new virtual currency

POST {{baseUrl}}/v3/ledger/virtualCurrency

2 credits per API call.


Create new virtual currency with given supply stored in account. This will create Tatum internal virtual currency. Every virtual currency must be prefixed with VC_.
Every virtual currency must be pegged to existing FIAT or supported cryptocurrency. 1 unit of virtual currency has then the same amount as 1 unit of the base currency it is pegged to. It is possible to set a custom base rate for the virtual currency. (baseRate = 2 => 1 VC unit = 2 basePair units)
Tatum virtual currency acts as any other asset within Tatum. For creation of ERC20 token, see ERC20 .
This operation returns the newly created Tatum Ledger account with an initial balance set to the virtual currency's total supply. Total supply can be changed in the future.

Request Body

{"basePair"=>"BTC", "name"=>"VC_VIRTUAL", "supply"=>"1000000", "baseRate"=>1, "customer"=>{"externalId"=>"123654", "accountingCurrency"=>"USD", "customerCountry"=>"US", "providerCountry"=>"US"}, "description"=>"My Virtual Token description.", "accountCode"=>"AC_1011_B", "accountNumber"=>"1234567890", "accountingCurrency"=>"USD"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{"id":"5e68c66581f2ee32bc354087","active":true,"frozen":false,"currency":"BTC","balance":{"accountBalance":"1000000","availableBalance":"1000000"},"customerId":"5e68c66581f2ee32bc354087","accountCode":"03_ACC_01","xpub":"xpub6FB4LJzdKNkkpsjggFAGS2p34G48pqjtmSktmK2Ke3k1LKqm9ULsg8bGfDakYUrdhe2EHw5uGKX9DrMbrgYnVfDwrksT4ZVQ3vmgEruo3Ka"}