---
title: "Create new supply of virtual currency"
method: PUT
path: "/v3/ledger/virtualCurrency/mint"
tags: ["Virtual Currency"]
---

# Create new supply of virtual currency

`PUT /v3/ledger/virtualCurrency/mint`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/ledger/virtualCurrency/mint`
- Auth: API key in header `x-api-key`

/v3/ledger/virtualCurrency/mint

**2 credits per API call**

Create new supply of virtual currency linked on the given accountId. Method increases the total supply of the currency.

This method creates Ledger transaction with operationType MINT with undefined counterAccountId.

## Request body

- VirtualCurrencyOperation
  - `accountId` string, required: Ledger account with currency of the virtual currency, on which the operation will be performed.
  - `amount` string, required: Amount of virtual currency to operate within this operation.
  - `paymentId` string: Identifier of the payment, shown for created Transaction within Tatum sender account.
  - `reference` string: Reference of the payment.
  - `transactionCode` string: For bookkeeping to distinct transaction purpose.
  - `recipientNote` string: Note visible to both, sender and recipient. Available for both Mint and Revoke operations
  - `counterAccount` string: External account identifier. By default, there is no counterAccount present in the transaction.
  - `senderNote` string: Note visible to sender. Available in Revoke operation.

## Response `200`

OK

- TransactionResult
  - `reference` string: The internal reference to the transaction (a unique identifier of the transaction within the virtual account); if the transaction fails, use this reference to search through the logs

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/tatum/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/virtual-accounts/revisions/ba220553084b?raw)
