GET
/global/ratesCotações
Quanto vale 1 unidade de cada moeda em reais agora, com variação em 24h e um histórico curto pra gráfico.
Em breve. Sem a integração ativa, a resposta vem com
available: false e a lista rates vazia. As cotações são atualizadas a cada 1 minuto (consultas dentro desse prazo recebem o mesmo valor). O histórico começa a se formar quando a cotação entra no ar e guarda os últimos 7 dias.Exemplo de Request
curlbash
curl "https://api.magnuspay.com.br/global/rates" \
-H "X-API-Key: magnus_sua_api_key"Resposta
200 OKjson
{
"success": true,
"data": {
"available": true,
"updatedAt": 1791700000000,
"rates": [
{
"code": "USD",
"name": "Dólar americano",
"country": "us",
"rate": 5.0312,
"effective": 5.2104,
"change": -0.34,
"series": [
{ "t": 1791690000000, "v": 5.0481 },
{ "t": 1791700000000, "v": 5.0312 }
]
}
]
}
}Campos
| Parâmetro | Tipo | Descrição |
|---|---|---|
updatedAt | number | Quando a cotação foi calculada (timestamp em milissegundos) |
rates[].code | string | Código da moeda |
rates[].rate | number | Reais por 1 unidade da moeda, câmbio comercial (sem taxas e impostos) |
rates[].effective | number | Reais por 1 unidade já com taxas e impostos (o que a pessoa realmente paga) |
rates[].change | number | null | Variação em % nas últimas 24h. null enquanto não há histórico. |
rates[].series | array | Pontos { t, v } do histórico (até 48), do mais antigo ao mais novo |