Desenvolvedores

Uma API de câmbio gratuita e sem chave, e um widget conversor incorporável. Para apps, dashboards, blogs — onde houver necessidade de taxas em tempo real.

API pública

REST + JSON. CORS aberto a todas as origens. Resultados em cache ~60s no Redis.

URL base: https://ratata.money/api/v1
Limite: 60 req / min · IP
Auth: Nenhuma — sem chave

GET/currencies?lang=pt

Lista todas as moedas suportadas (código, nome localizado, bandeira, decimais).

Exemplo

curl https://ratata.money/api/v1/currencies?lang=pt

Resposta

[
  { "code": "USD", "name": "US Dollar", "flag": "🇺🇸", "decimals": 2 },
  { "code": "EUR", "name": "Euro", "flag": "🇪🇺", "decimals": 2 }
]

GET/rates/latest?base=USD&symbols=CNY,JPY,EUR

Cotações mais recentes para uma base contra qualquer conjunto de símbolos.

Exemplo

curl "https://ratata.money/api/v1/rates/latest?base=USD&symbols=CNY,JPY,EUR"

Resposta

{
  "base": "USD",
  "timestamp": 1714464000,
  "rates": { "CNY": 7.2456, "JPY": 156.43, "EUR": 0.9321 },
  "source": "frankfurter"
}

GET/rates/convert?from=USD&to=CNY&amount=100

Conversão no servidor — sem erros de ponto flutuante.

Exemplo

curl "https://ratata.money/api/v1/rates/convert?from=USD&to=CNY&amount=100"

Resposta

{ "from": "USD", "to": "CNY", "amount": 100, "result": 724.56, "rate": 7.2456 }

GET/rates/history?base=USD&symbol=CNY&range=30d

Histórico diário. Faixa: 7d / 30d / 90d / 1y.

Exemplo

curl "https://ratata.money/api/v1/rates/history?base=USD&symbol=CNY&range=30d"

Resposta

{
  "base": "USD",
  "symbol": "CNY",
  "range": "30d",
  "points": [
    { "date": "2026-04-01", "rate": 7.2310 },
    { "date": "2026-04-02", "rate": 7.2401 }
  ]
}

Erros

Todos os erros retornam JSON com um code estável e uma message legível.

{ "error": { "code": "UNSUPPORTED_CURRENCY", "message": "..." } }

Widget incorporável

Adicione um conversor a qualquer site com um único iframe. Escolha par, idioma, tema e tamanho — copie o trecho.

OrigemDestinoValorIdiomaTema

Mostrar atribuição"Powered by Ratata"Largura (px)Altura (px)

Prévia

Código

<iframe src="https://ratata.money/embed?from=USD&to=CNY&amount=100&lang=pt"
  width="420" height="320"
  style="border:0;max-width:100%;border-radius:16px;overflow:hidden"
  loading="lazy"
  title="Ratata currency converter"
  referrerpolicy="no-referrer"
  allow="clipboard-write"></iframe>

Hoje é grátis e sem cota — use com responsabilidade. Pode haver limite diário se houver abuso. Para uso comercial intenso, fale com a gente.