Currency codes and amounts
Currency codes
Fiat currencies and most crypto assets use a single code, such as USD, EUR, BTC, ETH, or TON.
A stablecoin exists on several networks, so its code depends on what the field refers to:
- Funds that move on a blockchain. Pass the stablecoin with its network after an underscore, for example
USDT_TRC20for USDT on Tron, so the payment or payout goes through the network you intend. These fields aresenderCurrencyin crypto invoices,destCurrencyin crypto payouts,currencyanddesiredCurrencyin Get exchange rate, andcurrencyandcurrencyConvertedin Get minimum limits. - Your wallets. Use the plain ticker,
USDTorUSDC. A stablecoin has one balance for all networks, sosrcCurrencyand both currencies of a transfer between Volet.com wallets have no network.
Stablecoin codes by network
| Network | USDT | USDC |
|---|---|---|
| Ethereum (ERC-20) | USDT_ERC20 | USDC_ERC20 |
| BNB Smart Chain (BEP-20) | USDT_BEP20 | USDC_BEP20 |
| Tron (TRC-20) | USDT_TRC20 | Not accepted |
| Solana | USDT_SOL | USDC_SOL |
| TON | USDT_TON | Not accepted |
| Polygon | USDT_POL | USDC_POL |
| Arbitrum | USDT_ARB | USDC_ARB |
| Optimism | USDT_OP | USDC_OP |
| Avalanche C-Chain | USDT_AVAXC | USDC_AVAXC |
Other crypto assets
Coins that live on one network use their ticker: BTC (Bitcoin), ETH (Ethereum), LTC (Litecoin), XRP (XRP Ledger), TRX (Tron), TON (TON), SOL (Solana), BNB (BNB Smart Chain), AVAX (Avalanche C-Chain), and POL (Polygon). There are no wallets in BNB, AVAX, and POL, so these codes are accepted only where funds move on a blockchain, such as crypto invoices and crypto payouts with conversion.
Each method page lists exactly which codes each field accepts.
Some assets, such as XRP and TON, need a destination tag or memo:
- In a crypto payout, pass it in
address.memo, next to the recipient address inaddress.address. - A crypto invoice returns it in
destinationTag. Show it to the customer next to the address.
Wallet IDs
Requests that send funds from your account use the ID of the source wallet, for example srcWalletId. A wallet ID is the wallet number: the currency code followed by 12 digits, for example USD123456789012. Get wallet IDs from Get wallet balances.
GIVE and GET
Methods that convert currency need to know which side the amount refers to.
| Value | The amount is |
|---|---|
GIVE | The amount on the sender's side: what the customer sends for an invoice, or what you send for a payout. |
GET | The amount on the receiver's side: what is credited to your account for an invoice, or what the recipient receives for a payout. |
The field is transferAction in crypto invoices and action in payouts. The other side of the amount is calculated at the current exchange rate, minus applicable fees. To see both amounts before you create a transaction, use Check crypto invoice or Get exchange rate.
Related
- Introduction — base URL, authentication, and request format
- Create crypto invoice —
senderCurrency: the coin and network the customer pays with - Send crypto payout —
destCurrencyandaddress.memoin a payout request