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 21 Aug 2026

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 21 Aug 2026, 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.

Alternatives to AwesomeAPI Economia API

If AwesomeAPI Economia does not fit, these finance & crypto apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.

API	What it does	Auth	CORS	Last verified
CoinGecko	Free cryptocurrency price API covering 10,000+ coins. Live prices, market cap and volume in any currency, no API key on the public tier. Tested curl example.	No key	Yes	19 Aug 2026
Binance Public API	Binance public market data API needs no API key: live ticker prices, order books, klines and 24h stats for every trading pair. Tested curl example and response.	No key	Yes	19 Aug 2026
Coinbase Exchange Rates	Coinbase public exchange rates API with no key: convert any cryptocurrency to 100+ fiat currencies in a single request. Tested curl example and live JSON.	No key	Yes	19 Aug 2026
Frankfurter	Free currency exchange rate API with no key, built on European Central Bank data. Latest and historical rates, time series and conversion. Tested curl example.	No key	Yes	19 Aug 2026
Bank of Canada Valet	Free Bank of Canada Valet API with no key: official exchange rates, interest rates, bond yields and economic series with decades of history. Tested example.	No key	Yes	20 Aug 2026
Bank of England IADB	Free Bank of England Interactive Database with no key: SONIA, Bank Rate, gilt yields and UK monetary series as CSV by series code and date range. Tested example.	No key	No	21 Aug 2026

All Finance & Crypto APIs

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