consultar_cambio
Fetch official PTAX exchange rates of foreign currencies to Brazilian Real for a given date. Returns opening, intermediary, and closing quotes with buy and sell rates.
Instructions
Consulta a cotação de câmbio oficial de uma moeda estrangeira em relação ao Real (BRL) numa data, via boletins PTAX do Banco Central (BrasilAPI). Retorna em JSON os boletins do dia (ABERTURA, INTERMEDIÁRIO, FECHAMENTO) com cotação de compra e venda em BRL, paridade e data_hora_cotacao. A fonte NÃO expõe o dia corrente: com data omitida a tool consulta ontem (a cotação mais recente disponível), e em data sem pregão a API retorna os boletins do último dia útil anterior. Use quando o usuário perguntar 'quanto tá o dólar?' (retorna a cotação mais recente, do dia útil anterior), 'cotação do euro em 26/06', 'quanto fechou a libra sexta-feira' — qualquer pergunta sobre valor de moeda estrangeira em reais. NÃO use para: criptomoedas (não está nesta API), BRL (é a moeda base), série histórica (uma data por chamada), ou moedas fora das 10 suportadas — pra descobrir as moedas disponíveis use listar_moedas.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Data da cotação no formato YYYY-MM-DD (aceita também DD/MM/YYYY). Se omitida, usa ontem (fuso de Brasília) — a fonte não expõe o dia corrente. Em data sem pregão (fim de semana, feriado) a API retorna as cotações do último dia útil anterior. | |
| moeda | Yes | Código da moeda (ISO 4217), case-insensitive. Aceitas: USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK. Ex: 'USD'. |