AwesomeAPI Economia API

Free Brazilian currency API with no key: real-time bid and ask for USD-BRL, EUR-BRL, crypto and 150+ pairs, plus daily history. Tested curl example and live response.

No API key requiredCORS enabledHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-21

What is the AwesomeAPI Economia API?

AwesomeAPI Economia is a free Brazilian currency API requiring no key. One request returns bid, ask, 24-hour high and low, and percentage change for as many comma-separated pairs as you ask for, updated through the trading day.

Unlike a central bank fixing, this feed tracks the market intraday, which makes it the usual choice for a live rate on a Brazilian site where PTAX would be a day stale. Several pairs can be fetched in one call by comma-separating them, and the response is keyed by the concatenated pair name — `USD-BRL` in the request becomes `USDBRL` in the response object, a small asymmetry worth handling once rather than everywhere.

Every numeric field is a string. That includes `bid`, `ask`, `pctChange` and even `timestamp`, which arrives as `"1787294631"` — seconds since epoch, quoted. The choice is deliberate for money, and it means a JSON deserialiser mapping into typed structs needs explicit string-to-decimal conversion. Note also that `pctChange` is already a percentage (`0.042362` means 0.042 percent, not 4.2 percent), while `varBid` is an absolute move in the quote currency.

Quick facts

Base URL: https://economia.awesomeapi.com.br/json
Authentication: No key for the public endpoints. A free account raises limits and unlocks longer history, but is not required.
Rate limit: Public use is throttled per IP rather than by a published number. Cache for a few seconds and batch pairs into one call.
Pricing: Free for the public endpoints, with paid plans for higher volume and deeper history.
CORS: Enabled — callable directly from browser JavaScript
Official docs: Read the docs

How to use the AwesomeAPI Economia API

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

1. Live USD-BRL and EUR-BRL rates in one request

GET https://economia.awesomeapi.com.br/json/last/USD-BRL,EUR-BRL

curl

curl 'https://economia.awesomeapi.com.br/json/last/USD-BRL,EUR-BRL'

JavaScript (fetch)

const res = await fetch("https://economia.awesomeapi.com.br/json/last/USD-BRL,EUR-BRL");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://economia.awesomeapi.com.br/json/last/USD-BRL,EUR-BRL", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200

{
  "USDBRL": {
    "code": "USD",
    "codein": "BRL",
    "name": "Dólar Americano/Real Brasileiro",
    "high": "5.1951",
    "low": "5.1929",
    "varBid": "0.0022",
    "pctChange": "0.042362",
    "bid": "5.1951",
    "ask": "5.1955",
    "timestamp": "1787294631",
    "create_date": "2026-08-21 03:43:51"
  },
  "EURBRL": {
    "code": "EUR",
    "codein": "BRL",
    "name": "Euro/Real Brasileiro",
    "high": "6.0783",
    "low": "6.0678",
    "varBid": "0.0037",
    "pctChange": "0.060953",
    "bid": "6.0737",
    "ask": "6.0757",
    "timestamp": "1787298299",
    "create_date": "2026-08-21 04:44:59"
  }
}

Parameters

Parameter	Type	Required	Description
`pairs`	path segment	Required	Comma-separated currency pairs in `FROM-TO` form. Crypto codes such as `BTC-BRL` work alongside fiat. `USD-BRL,EUR-BRL`
`/last/`	path segment	Required	The endpoint returning current quotes. `/daily/` returns a history instead. `last`
`days`	path segment	Optional	On the daily endpoint, how many days of history to return. `30`

Response fields

{PAIR}object: Keyed by the pair with the hyphen removed — `USD-BRL` becomes `USDBRL`.
bid / askstring: Current bid and ask, as strings. The gap is the spread.
high / lowstring: Highest and lowest quotes over the current session.
varBidstring: Absolute change in the bid, expressed in the quote currency.
pctChangestring: Percentage change already expressed as a percentage — `0.042362` is 0.042 percent.
timestampstring: Unix seconds, quoted as a string. Multiply by 1000 for JavaScript Date.
create_datestring: Human-readable timestamp in Brasília local time.
namestring: Pair description in Portuguese, for display only.

What you can build with the AwesomeAPI Economia API

Show a live USD-BRL rate on a Brazilian e-commerce or finance site
Fetch several pairs in one request for a multi-currency price table
Chart a 30-day rate history from the daily endpoint
Display both fiat and crypto quotes through a single interface

Common errors and how to fix them

404

A pair is not supported or is misspelled.

Fix: Pairs use `FROM-TO` with a hyphen. Check the supported-pairs endpoint before assuming a currency exists.

429

Per-IP throttling kicked in.

Fix: Batch pairs into one request rather than looping, and cache for a few seconds — the underlying quote does not update faster than that.

Percentage looks 100x too small

`pctChange` was multiplied by 100 as if it were a decimal fraction.

Fix: It is already a percentage. Render it directly.

AwesomeAPI Economia API — frequently asked questions

Is AwesomeAPI free without an API key?

Yes, the public quote endpoints work with no key or account. A free registration raises the rate limit and unlocks longer historical windows, but nothing in the basic quote flow requires it.

Why is the response key different from the pair I requested?

The request uses `USD-BRL` with a hyphen and the response key is `USDBRL` without one. Normalise by stripping the hyphen when you look up the result.

Are the values numbers or strings?

Strings, including the timestamp. This avoids floating-point drift on monetary values, but means you must parse explicitly before doing arithmetic.

Does it cover cryptocurrencies?

Yes. Crypto pairs such as `BTC-BRL` use exactly the same endpoint and response shape as fiat pairs, so one code path handles both.

Tools that pair with this API

Percentage Change Calculator

Work out the percentage increase or decrease between an old and a new value. See the absolute change and whether it went up or down, instantly and privately.

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

Timestamp Converter

Convert timestamps to human-readable dates and dates back to timestamps. Auto-detects seconds vs milliseconds, shows local, UTC and ISO 8601 formats.

AwesomeAPI Economia is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-21; always check the official documentation before relying on this API in production, as terms and limits can change.