Brasil API icon

Brasil API

Consulta endpoints públicos da BrasilAPI
Join our community

Actions24

Overview

This node integrates with BrasilAPI, a public API service providing various Brazilian data endpoints. Specifically, the "Câmbio – Cotação" operation fetches currency exchange rate quotations for a specified currency and date.

Use cases include:

  • Retrieving historical or current exchange rates for financial applications.
  • Automating currency conversion workflows based on official Brazilian exchange rates.
  • Integrating exchange rate data into reports or dashboards.

For example, you can get the USD to BRL exchange rate for January 2, 2025, by specifying the currency as "USD" and the date as "2025-01-02".

Properties

Name Meaning
Moeda (USD) The currency code (e.g., USD, EUR, etc.) for which to retrieve the exchange rate.
Data (YYYY-MM-DD) The date for the exchange rate quotation in the format year-month-day (e.g., 2025-01-02).

Output

The node outputs JSON data containing the exchange rate quotation for the requested currency and date. The structure typically includes fields such as the currency code, date, and the exchange rate value(s).

Example output JSON (simplified):

{
  "code": "USD",
  "date": "2025-01-02",
  "rate": 5.25,
  "source": "official"
}

No binary data is produced by this operation.

Dependencies

  • This node requires internet access to call the BrasilAPI public endpoints.
  • No authentication or API keys are needed since BrasilAPI is a free public API.
  • The node uses the HTTP client library internally to perform GET requests with a 10-second timeout.

Troubleshooting

  • Timeouts or network errors: Ensure your environment has internet connectivity and that brasilapi.com.br is reachable.
  • Unsupported operation error: This occurs if an invalid operation name is set; verify the operation is exactly "cambioCotacao".
  • Invalid date or currency code: If the API returns an error due to invalid parameters, check that the currency code is valid and the date is formatted as YYYY-MM-DD.
  • Empty or unexpected response: Confirm the API endpoint is operational and the parameters correspond to available data.

Links and References

Discussion