GET/global/quote

Cotar uma Conversão

Quanto um valor em reais vira em outra moeda, com câmbio, impostos, taxas e o prazo em que a cotação vale.

Em breve. Enquanto a integração não estiver ativa, esta rota responde 503. A cotação vale por poucos minutos (veja expiresAt): depois disso, peça outra. Hoje a rota só cota; a conversão de verdade ainda não está disponível pela API.

Parâmetros (query)

Parâmetro	Tipo	Descrição
`amount`*	number	Valor em reais a converter. Mínimo R$ 150.
`currency`*	string	Moeda de destino: USD, EUR, GBP, JPY, AUD, CAD ou CHF

Exemplo de Request

curlbash

curl "https://api.magnuspay.com.br/global/quote?amount=1000&currency=USD" \
  -H "X-API-Key: magnus_sua_api_key"

Resposta

200 OKjson

{
  "success": true,
  "data": {
    "id": "6f1c0a52-...",
    "inputAmount": 1000,
    "inputCurrency": "BRL",
    "outputAmount": 191.9,
    "outputCurrency": "USD",
    "exchangeRate": 5.0312,
    "vet": 5.21,
    "marketRate": 5.0289,
    "taxes": [{ "name": "IOF", "amount": 38 }],
    "fees": [],
    "createdAt": "2026-10-10T22:00:00.000Z",
    "expiresAt": "2026-10-10T22:05:00.000Z"
  }
}

Campos

Parâmetro	Tipo	Descrição
`outputAmount`	number	Quanto a pessoa recebe na moeda de destino
`exchangeRate`	number	Câmbio sem taxas e impostos (reais por 1 unidade)
`vet`	number	Câmbio efetivo, já com taxas e impostos
`taxes[] / fees[]`	array	Impostos (ex.: IOF) e taxas, em reais
`expiresAt`	string	Até quando a cotação vale (ISO 8601)

Erros

Parâmetro	Tipo	Descrição
`400`	Valor inválido	amount ausente ou não numérico
`400`	O valor mínimo é R$ 150	amount abaixo do mínimo
`400`	Moeda não suportada	currency fora da lista (o peso argentino ainda não cota)
`503`	Conversão global ainda não configurada	A integração ainda não está ativa
`502`	Falha de conexão com a Remessa	Instabilidade momentânea: tente de novo