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

# Conversões

> Troque saldo em moeda local por USDT

<Note>**Beta** — o contrato da 1.0 em evolução, ainda não em produção. Os campos podem mudar até o lançamento.</Note>

A conversão troca o saldo de uma moeda por **USDT**. A taxa é **por par** (BRL→USDT ≠ MXN→USDT ≠ COP→USDT),
negociada por país e fixada no seu contrato. A de **saque** USDT é única para toda moeda.

## Cotar

`GET /v1/conversions/quote?from=MXN&to=USDT`

```json theme={null}
{ "from": "MXN", "to": "USDT", "rate": "18.50", "expires_at": 1781319147 }
```

## Criar conversão

`POST /v1/conversions`

```json theme={null}
{
  "from_currency": "MXN",
  "to_currency": "USDT",
  "amount": 480000,
  "quote_rate": "18.50",
  "external_id": "conv-7"
}
```

Resposta `201`:

```json theme={null}
{
  "id": "cnv_…", "status": "DONE",
  "from_currency": "MXN", "to_currency": "USDT",
  "amount_in": 480000, "amount_out": 25400, "fee": 10560,
  "rate": "18.50"
}
```

* `amount` é inteiro, na menor unidade da moeda `from` (`480000` = 4.800,00 MXN).
* `amount_out` — o USDT creditado (centavos de USDT), já líquido da taxa.
* `fee` — a taxa **deste par, deste cliente**. `quote_rate` — a cotação obtida em `/conversions/quote`.

## Estados

`DONE` — a conversão é **síncrona**: debita a moeda de origem e credita USDT no mesmo passo, atômico.

<Info>O saldo em USDT você saca em [Saques](/v1.0/payouts) com `payment_method: "USDT"`.</Info>