> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxpay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Códigos de Moeda

> Códigos de par de moeda e rede usados em todos os responses da API e no dashboard da Noxpay.

## Como as moedas funcionam na Noxpay

Cada código de moeda na Noxpay representa um **par de moeda e rede** específico — não apenas um token. USDT na Tron e USDT na Ethereum são tratadas como moedas completamente separadas. Elas têm saldos separados, endereços de depósito separados e não podem ser usadas de forma intercambiável.

Isso significa que:

* Os saldos são rastreados por código. `TRX_USDT_S2UZ` e `USDT_ERC20` são dois buckets de saldo distintos, mesmo que ambos sejam USDT.
* Você não pode mover fundos entre dois códigos que compartilham o mesmo token subjacente, mas diferem em rede. Um saldo de USDT (TRX) não pode financiar uma operação que espera USDT (ERC-20).
* Ao criar uma transação ou ler um response, sempre use o código exato para a rede em que pretende operar.

Escolha o código de moeda com base na rede que sua contraparte suporta, e certifique-se de que sua configuração (Templates, entradas de whitelist, endereços de saque) utilize consistentemente o mesmo código.

***

## Códigos de moeda suportados

| Código          | Nome exibido        | Rede                                        |
| --------------- | ------------------- | ------------------------------------------- |
| `TRX_USDT_S2UZ` | USDT (TRX)          | Tron (TRC-20)                               |
| `USDT_ERC20`    | USDT (ERC-20)       | Ethereum                                    |
| `USDT2_AVAX`    | USDT (AVAX C-Chain) | Avalanche C-Chain                           |
| `USDT_TON`      | USDT (TON)          | TON                                         |
| `SOL_USDT_EWAY` | USDT (SOL)          | Solana                                      |
| `USDC`          | USDC (ERC-20)       | Ethereum                                    |
| `SOL_USDC_PTHX` | USDC (SOL)          | Solana                                      |
| `USDC_AVAX`     | USDC (AVAX)         | Avalanche C-Chain                           |
| `BRL`           | BRL (PIX)           | Sistema de pagamento instantâneo brasileiro |
| `BTC`           | Bitcoin (Mainnet)   | Bitcoin                                     |

***

## Onde esses códigos aparecem

O código aparece como está nos responses da API em campos como `currency_exit_received_code`, `currency_entry_paid_code`, `currency_receive_code` e `deposit_currency`. O nome exibido correspondente aparece na variante `_pretty_name` ou não-`_code` do mesmo campo (ex: `currency_exit_received`).

No endpoint de saldo, as chaves de nível superior do objeto `balances` usam o agrupamento pelo nome exibido (ex: `USDT`), enquanto as chaves aninhadas usam o nome exibido com a rede (ex: `USDT TRC20`). Use o campo `account.currency` do endpoint de extrato para obter o código bruto para filtragem.
