Mesa do Dólar public API
The same data as the site, in JSON, for spreadsheets, systems and websites. Free, no key required and read-only.
How to use it
Send a GET request to any endpoint below. The full machine-readable list is at /api/v1 and the OpenAPI document at /api/v1/openapi.json.
Every response includes dados (the result), fonte, atualizado_em (date or time of the data) and a notice that it is not investment advice. Errors come back in JSON, with erro.mensagem in Portuguese, and the matching HTTP status code (400 invalid parameter, 404 no data, 429 over the limit).
The data are the same as in the Mesa MCP tools and the chat: what the API returns is what the site shows.
Usage rules
| Limit | 60 requests per minute per IP address |
|---|---|
| Over the limit | HTTP 429, with Retry-After of 60 s |
| Browser (CORS) | allowed for GET from any site |
| Attribution | “Source: Mesa do Dólar” with a link to mesadodolar.com.br |
| Warranty | none: public data, may be delayed or missing |
Each response says how long it may be cached (Cache-Control header): from 2 s for the current price to 1 day for PTAX on past dates. Respect that time before requesting again. Public data for reference, with no warranty. Not investment advice.
Exchange rate widget
To show the USD/BRL spot rate on your site without coding, use the exchange rate widget: a ready-to-copy iframe. There is also a stable daily PTAX variant for blogs and accounting sites.
Monthly PTAX as CSV, straight into your spreadsheet
GET /api/v1/ptax/mes.csvThe PTAX buy and sell rates for every business day of a month, as CSV, for Excel, Google Sheets and accounting systems. The first line of the file is the header, so the spreadsheet reads the columns with no extra step. The source (Central Bank of Brazil) and the last day with data come in the X-Fonte and X-Dados-Ate HTTP headers. Parameters: ano and mes (required) and idioma (optional): en uses commas between columns, a decimal point and YYYY-MM-DD dates; pt and es use semicolons, a decimal comma and dd/mm/yyyy dates. The downloaded file is named ptax-YYYY-MM.csv. Same request limit as the JSON API.
Google Sheets
=IMPORTDATA("https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10&idioma=en", ",", "en_US")Paste into an empty cell. The sheet fetches the CSV and refreshes it on its own from time to time; the third argument sets the number format.
Excel (Power Query)
let
Source = Csv.Document(Web.Contents("https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10&idioma=en"), [Delimiter=",", Encoding=65001]),
Ptax = Table.PromoteHeaders(Source),
Typed = Table.TransformColumnTypes(Ptax, {{"date", type date}, {"buy", type number}, {"sell", type number}}, "en-US")
in
TypedData > Get Data > From Other Sources > Blank Query; open the Advanced Editor, paste the code and click Done. To refresh, Data > Refresh All.
From the command line
curl -o ptax-2026-10.csv "https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10&idioma=en"
USD/BRL spot rate now
GET /api/v1/cotacaocached for 2 sThe USD/BRL spot rate shown at the top of the site (R$ per US$). While the B3 session is open (business days, 9:00 to 18:30 Brasília time) it is a real-time estimate: the B3 spot rate (dollar futures minus the spot-futures spread, which arrives 15 minutes late) adjusted by the move in the digital dollar over those 15 minutes. With the session closed (evening, weekend, holiday) it is the close of the last session, frozen, with its date in fechamento_data; the digital dollar, which trades 24 hours a day, comes separately as a reference. Includes the change and what it was measured against. It is not the PTAX. Questions about USDT, USDC or the gap between the digital dollar and the spot rate go to dolar_digital, not this one.
No parameters.
curl "https://mesadodolar.com.br/api/v1/cotacao"
Real response example (lists shortened)
{
"dados": {
"preco": 5.9292,
"momento": "2026-11-19T21:44:55.000Z",
"pregao": "fechado",
"fechamento_data": "2026-11-19",
"tipo": "fechamento do último pregão",
"variacao_pct": 0.68,
"variacao_base": "PTAX de venda de 2026-11-19 (ainda não há fechamento anterior do dólar à vista gravado)",
"fechamento_anterior": null,
"fechamento_anterior_data": null,
"b3_atrasado": null,
"dolar_digital_24h": {
"preco": 6.0124,
"momento": "2026-11-20T15:28:22.243Z",
"observacao": "USDT em reais. Negocia 24 horas; é referência fora do pregão, não o dólar à vista. Para o detalhe do dólar digital, use dolar_digital."
},
"idade_segundos": 63807,
"observacao": "Mercado fechado: o preço é o fechamento do último pregão da B3 e não muda até a próxima abertura. Dólar à vista, não é a PTAX. Não é recomendação de investimento.",
"fonte": "B3 (dólar futuro menos o casado)"
},
"fonte": "B3 (dólar futuro menos o casado)",
"atualizado_em": "2026-11-19T21:44:55.000Z",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}PTAX for a date
GET /api/v1/ptaxcached for 1 minPTAX buying and selling rates for the dollar (R$ per US$) published by the Central Bank of Brazil. Without a date, returns the latest. On weekends or holidays returns the previous business day’s rate and says so.
| Parameter | Accepts | Purpose |
|---|---|---|
| data | date YYYY-MM-DD | Date YYYY-MM-DD. Leave out for the latest. |
curl "https://mesadodolar.com.br/api/v1/ptax?data=2026-10-30"
Real response example (lists shortened)
{
"dados": {
"data_pedida": "2026-10-30",
"data": "2026-10-30",
"compra": 5.4206,
"venda": 5.4212,
"houve_pregao": true,
"fonte": "Banco Central do Brasil (dados abertos)"
},
"fonte": "Banco Central do Brasil (dados abertos)",
"atualizado_em": "2026-10-30",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}PTAX over a period
GET /api/v1/ptax/periodocached for 5 minDaily PTAX buying and selling series between two dates. Up to 400 business days per call (about 19 months); for longer periods, make more than one call.
| Parameter | Accepts | Purpose |
|---|---|---|
| de * | date YYYY-MM-DD | Start date YYYY-MM-DD |
| ate * | date YYYY-MM-DD | End date YYYY-MM-DD |
curl "https://mesadodolar.com.br/api/v1/ptax/periodo?de=2026-10-01&ate=2026-10-31"
Real response example (lists shortened)
{
"dados": {
"de": "2026-10-01",
"ate": "2026-10-31",
"dias": 21,
"truncado": false,
"linhas": [
{
"data": "2026-10-01",
"compra": 5.2073,
"venda": 5.2079
},
{
"data": "2026-10-02",
"compra": 5.2232,
"venda": 5.2238
},
"… mais 19 itens"
],
"fonte": "Banco Central do Brasil (dados abertos)"
},
"fonte": "Banco Central do Brasil (dados abertos)",
"atualizado_em": "2026-10-30",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}PTAX for a month
GET /api/v1/ptax/mescached for 5 minSummary of the PTAX selling rate for a month: monthly average, last business day rate, high and low. This is the query used in accounting closes and contracts.
| Parameter | Accepts | Purpose |
|---|---|---|
| ano * | integer from 1985 to 2100 | required |
| mes * | integer from 1 to 12 | required |
curl "https://mesadodolar.com.br/api/v1/ptax/mes?ano=2026&mes=10"
Real response example (lists shortened)
{
"dados": {
"ano": 2026,
"mes": 10,
"dias_uteis": 21,
"em_curso": false,
"media_venda": 5.1294,
"media_compra": 5.1288,
"ultimo_dia_util": {
"data": "2026-10-30",
"compra": 5.4206,
"venda": 5.4212
},
"maxima_venda": 5.5007,
"minima_venda": 4.9698,
"fonte": "Banco Central do Brasil (dados abertos)"
},
"fonte": "Banco Central do Brasil (dados abertos)",
"atualizado_em": "2026-10-30",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Central Bank interventions and auctions
GET /api/v1/atuacoescached for 1 minWhat the Central Bank of Brazil did in the FX market: FX auctions read from the day’s announcements (date, cap, amount accepted, cut-off rate) and changes in the stocks of credit lines and FX swaps, on the settlement or maturity date. Volume in US$ millions; negative is a maturity.
| Parameter | Accepts | Purpose |
|---|---|---|
| limite | integer from 1 to 100 | How many interventions, from the latest backwards. Default 20. |
curl "https://mesadodolar.com.br/api/v1/atuacoes?limite=5"
Real response example (lists shortened)
{
"dados": {
"leiloes_de_cambio": [
{
"leilao": "354/2026",
"data": "2026-11-19",
"tipo": "Venda de dólar à vista",
"situacao": "realizado",
"teto_usd_milhoes": null,
"aceito_usd_milhoes": 1000,
"taxa_de_corte_pct": null,
"preco_de_venda_brl": 5.86,
"liquidacao": "2026-11-24",
"recompra": null,
"comunicado": 46328
},
{
"leilao": "353/2026",
"data": "2026-11-18",
"tipo": "Leilão de linha",
"situacao": "realizado",
"teto_usd_milhoes": 1000,
"aceito_usd_milhoes": 750,
"taxa_de_corte_pct": 6.07,
"preco_de_venda_brl": null,
"liquidacao": "2026-11-23",
"recompra": "2027-07-02",
"comunicado": 46319
},
"… mais 3 itens"
],
"liquidadas_ate": "2026-11-19",
"atuacoes": [
{
"data_liquidacao": "2026-11-04",
"instrumento": "Vencimento de linha",
"significado": "Dólar volta ao BC",
"usd_milhoes": -1000
},
{
"data_liquidacao": "2026-09-28",
"instrumento": "Leilão de linha (liquidação)",
"significado": "Liquidez no à vista",
"usd_milhoes": 1000
},
"… mais 3 itens"
],
"observacao": "leiloes_de_cambio vem dos comunicados do BC, na data do leilão; quando dois saem juntos, o teto vale para a soma. atuacoes vem dos estoques, na data de liquidação ou vencimento: o mesmo leilão de linha aparece nas duas listas depois de liquidar.",
"fonte": "Banco Central do Brasil (dados abertos), comunicados do Depin e SGS 29722 e 29723"
},
"fonte": "Banco Central do Brasil (dados abertos), comunicados do Depin e SGS 29722 e 29723",
"atualizado_em": "2026-11-19",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Dollar futures on B3
GET /api/v1/futurocached for 15 sB3 dollar futures quote: the most traded expiry (price, change over the previous settlement), the session volume adding the full contract (DOL) and the mini (WDO), and the list of expiries with contracts traded and open. Prices in reais per dollar. The public B3 quote arrives 15 minutes late.
| Parameter | Accepts | Purpose |
|---|---|---|
| contrato | one of: DOL, WDO | Which contract’s expiries to list. Default: DOL (full size, US$ 50,000). |
curl "https://mesadodolar.com.br/api/v1/futuro?contrato=WDO"
Real response example (lists shortened)
{
"dados": {
"mais_negociado": {
"simbolo": "DOLZ26",
"vencimento": "2026-12-01",
"preco": 5.952,
"ajuste_anterior": 5.924052,
"variacao_sobre_ajuste_pct": 0.47,
"consultado_em": "2026-11-20T15:28:20.000Z"
},
"volume_do_pregao": {
"contratos_dol": 361900,
"contratos_wdo": 4912549,
"financeiro_brl": 397256100060,
"nocional_usd": 67220490000
},
"contrato": "WDO",
"tamanho_do_contrato_usd": 10000,
"vencimentos": [
{
"simbolo": "WDOZ26",
"vencimento": "2026-12-01",
"ultimo": 5.9515,
"ajuste_anterior": 5.924052,
"minimo": 5.868,
"maximo": 5.9695,
"contratos_hoje": 4894617,
"contratos_em_aberto": 1812744,
"ultimo_negocio_em": "2026-11-19T21:29:00.000Z",
"ultimo_negocio_antigo": false
},
{
"simbolo": "WDOF27",
"vencimento": "2027-01-04",
"ultimo": 5.9855,
"ajuste_anterior": 5.957353,
"minimo": 5.902,
"maximo": 6.0025,
"contratos_hoje": 17508,
"contratos_em_aberto": 9119,
"ultimo_negocio_em": "2026-11-19T21:29:00.000Z",
"ultimo_negocio_antigo": false
},
"… mais 5 itens"
],
"observacao": "A cotação pública da B3 chega com 15 minutos de atraso. Vencimento com ultimo_negocio_antigo = true está parado há mais de 30 minutos no pregão: o \"ultimo\" é o preço daquele negócio, não o de agora, e não se compara com o de outro vencimento. Não é recomendação de investimento.",
"fonte": "B3, consulta pública de cotações"
},
"fonte": "B3, consulta pública de cotações",
"atualizado_em": "2026-11-20T15:28:20.000Z",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Digital dollar (USDT and USDC)
GET /api/v1/digitalcached for 2 sPrice in reais of the dollar stablecoins (USDT and USDC) on exchanges, with the last 24 hours’ change and volume and the gap to the B3 spot dollar. The market is open 24 hours, weekends included; the price updates every 2 seconds.
No parameters.
curl "https://mesadodolar.com.br/api/v1/digital"
Real response example (lists shortened)
{
"dados": {
"usdt_brl": {
"preco": 6.0124,
"compra": 6.0123,
"venda": 6.0124,
"variacao_24h_pct": 1.97,
"consultado_em": "2026-11-20T15:28:20.286Z"
},
"volume_24h_brl": 501475725,
"corretoras": [
{
"corretora": "Binance",
"preco": 6.0124,
"volume_24h_brl": 422177937
},
{
"corretora": "Foxbit",
"preco": 6.0135,
"volume_24h_brl": 79297788
}
],
"usdc_brl": {
"preco": 6.0185,
"variacao_24h_pct": 1.94
},
"dolar_a_vista_b3": 5.9412,
"distancia_para_o_a_vista_pct": 1.2,
"distancia_observacao": "USDT de 15 minutos atrás comparado com a cotação da B3 que chega agora, para os dois preços serem do mesmo instante.",
"observacao": "USDT e USDC são criptoativos que buscam valer um dólar; não são dólar em conta nem têm garantia do Banco Central. A cotação da B3 chega com 15 minutos de atraso, então parte da distância é só esse atraso. Não é recomendação de investimento.",
"fonte": "Binance e Foxbit, consultas públicas"
},
"fonte": "Binance e Foxbit, consultas públicas",
"atualizado_em": "2026-11-20T15:28:20.286Z",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}FX flows
GET /api/v1/fluxocached for 1 hBalance of FX contracted in Brazil (dollars in minus dollars out), split into trade and financial, summed by week, month or year, plus the year to date through the latest day published against the previous year through the same date. US$ millions; positive is a net inflow. The Central Bank publishes the days in batches, about a week late.
| Parameter | Accepts | Purpose |
|---|---|---|
| periodo | one of: semana, mes, ano | Grouping. Default: week. |
| quantos | integer from 1 to 120 | How many periods, from the latest backwards. Default 12. |
curl "https://mesadodolar.com.br/api/v1/fluxo?periodo=mes&quantos=6"
Real response example (lists shortened)
{
"dados": {
"periodo": "mes",
"unidade": "US$ milhões",
"observacao": "O período mais recente pode estar incompleto: veja \"fim\" e \"dias\".",
"linhas": [
{
"inicio": "2026-11-03",
"fim": "2026-11-13",
"dias": 9,
"comercial": 2715.10240398,
"financeiro": -3480.31894196,
"total": -765.2165379799999
},
{
"inicio": "2026-10-01",
"fim": "2026-10-30",
"dias": 21,
"comercial": 9269.70769821,
"financeiro": 8859.857496570003,
"total": 18129.56519478
},
"… mais 4 itens"
],
"acumulado_no_ano": {
"ano_corrente": {
"de": "2026-01-01",
"ate": "2026-11-13",
"comercial": 57602.09057130998,
"financeiro": -29645.70091734,
"total": 27956.38965397001
},
"ano_anterior_ate_a_mesma_data": {
"de": "2025-01-01",
"ate": "2025-11-13",
"comercial": 41164.848629500004,
"financeiro": -57510.192686679955,
"total": -16345.34405717999
}
},
"fonte": "Banco Central do Brasil (dados abertos), SGS 13961, 13967 e 13970"
},
"fonte": "Banco Central do Brasil (dados abertos), SGS 13961, 13967 e 13970",
"atualizado_em": "2026-11-13",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Trade balance and trade FX flows
GET /api/v1/balancacached for 1 hBalança comercial do Brasil por mês (exportação, importação e saldo, em US$ milhões FOB, do MDIC) ao lado do fluxo cambial comercial contratado no mesmo mês (Banco Central) e a diferença entre os dois. A balança conta a mercadoria quando passa pela alfândega; o câmbio pode ser fechado antes (adiantamento) ou meses depois, então a diferença é de registro e de prazo, não prova de dólar retido. O mês mais recente da balança sai nos primeiros dias úteis do mês seguinte.
| Parameter | Accepts | Purpose |
|---|---|---|
| meses | integer from 1 to 48 | Quantos meses, do mais recente para trás. Padrão 12. |
curl "https://mesadodolar.com.br/api/v1/balanca?meses=6"
Real response example (lists shortened)
{
"dados": {
"unidade": "US$ milhões",
"meses": [
{
"mes": "2026-10",
"exportacao": 37807.2,
"importacao": 28489.7,
"saldo_balanca": 9317.6,
"fluxo_comercial": 9269.7,
"diferenca": 47.8
},
{
"mes": "2026-09",
"exportacao": 33962.6,
"importacao": 26692.5,
"saldo_balanca": 7270.1,
"fluxo_comercial": 2128.7,
"diferenca": 5141.4
},
"… mais 4 itens"
],
"ultimos_12_meses": {
"de": "2025-11",
"ate": "2026-10",
"saldo_balanca": 86125.4,
"fluxo_comercial": 62379.1,
"diferenca": 23746.3
},
"observacao": "diferenca = saldo_balanca − fluxo_comercial. fluxo_comercial é null enquanto o BC não publicou o mês inteiro. Positivo: a balança ficou acima do câmbio comercial contratado no mês; parte pode ser dólar de exportação ainda não convertido, mas entram também adiantamentos, prazos de pagamento e diferenças de registro.",
"base_mdic_atualizada_em": "2026-11-06",
"fluxo_publicado_ate": "2026-11-13",
"pagina": "/fluxo-cambial",
"fonte": "Ministério do Desenvolvimento, Indústria, Comércio e Serviços (MDIC), Comex Stat (api-comexstat.mdic.gov.br); Banco Central do Brasil, fluxo cambial comercial contratado (SGS 13967)"
},
"fonte": "Ministério do Desenvolvimento, Indústria, Comércio e Serviços (MDIC), Comex Stat (api-comexstat.mdic.gov.br); Banco Central do Brasil, fluxo cambial comercial contratado (SGS 13967)",
"atualizado_em": "2026-11-06",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}International reserves
GET /api/v1/reservascached for 1 hLatest values of a series: "reservas" (international reserves), "swaps" (FX swap stock), "linhas" (stock of credit lines with repurchase), all in US$ millions, "selic" (target, % a year) and the daily FX flow in US$ millions ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positive is a net inflow). Without a code, lists the available series.
| Parameter | Accepts | Purpose |
|---|---|---|
| pontos | integer from 1 to 400 | How many values, from the latest backwards. Default 30. |
curl "https://mesadodolar.com.br/api/v1/reservas?pontos=5"
Real response example (lists shortened)
{
"dados": {
"codigo": "reservas",
"nome": "Reservas internacionais",
"unidade": "US$ milhões",
"fonte": "Banco Central do Brasil, SGS",
"codigo_fonte": "SGS 13621",
"ultima_data": "2026-11-18",
"valores": [
{
"data": "2026-11-12",
"valor": 364435
},
{
"data": "2026-11-13",
"valor": 364006
},
"… mais 3 itens"
]
},
"fonte": "Banco Central do Brasil, SGS",
"atualizado_em": "2026-11-18",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Central Bank series
GET /api/v1/seriecached for 1 hLatest values of a series: "reservas" (international reserves), "swaps" (FX swap stock), "linhas" (stock of credit lines with repurchase), all in US$ millions, "selic" (target, % a year) and the daily FX flow in US$ millions ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positive is a net inflow). Without a code, lists the available series.
| Parameter | Accepts | Purpose |
|---|---|---|
| codigo | one of: reservas, swaps, linhas, selic, fluxo_total, fluxo_comercial, fluxo_financeiro | optional |
| pontos | integer from 1 to 400 | How many values, from the latest backwards. Default 30. |
curl "https://mesadodolar.com.br/api/v1/serie?codigo=swaps&pontos=5"
Real response example (lists shortened)
{
"dados": {
"codigo": "swaps",
"nome": "Estoque de swap cambial (nocional)",
"unidade": "US$ milhões",
"fonte": "Banco Central do Brasil, SGS",
"codigo_fonte": "SGS 29723",
"ultima_data": "2026-11-19",
"valores": [
{
"data": "2026-11-13",
"valor": 90250
},
{
"data": "2026-11-16",
"valor": 90250
},
"… mais 3 itens"
]
},
"fonte": "Banco Central do Brasil, SGS",
"atualizado_em": "2026-11-19",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Focus: dollar forecast
GET /api/v1/focuscached for 1 hMedian forecast for the dollar at the end of each year in the Central Bank of Brazil’s Focus survey (a weekly survey of banks, asset managers and consultancies), with the low, the high and the number of responses. R$ per US$.
No parameters.
curl "https://mesadodolar.com.br/api/v1/focus"
Real response example (lists shortened)
{
"dados": {
"pesquisa": "2026-11-13",
"anos": [
{
"fim_de": 2026,
"mediana": 5.4,
"minima": 4.9,
"maxima": 6,
"respostas": 121
},
{
"fim_de": 2027,
"mediana": 5.45,
"minima": 4.7,
"maxima": 6.3,
"respostas": 120
},
"… mais 3 itens"
],
"observacao": "Projeção de mercado coletada pelo Banco Central; não é previsão da Mesa do Dólar nem recomendação de investimento.",
"fonte": "Banco Central do Brasil (dados abertos), Focus (expectativas de mercado)"
},
"fonte": "Banco Central do Brasil (dados abertos), Focus (expectativas de mercado)",
"atualizado_em": "2026-11-13",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Daily reading and overview
GET /api/v1/leituracached for 5 minCurrent snapshot of the dollar in Brazil from official data: latest PTAX, changes, volatility, 12-month high and low, reserves, swap and credit line stocks, Selic, Focus and Mesa do Dólar’s automatic reading (bias, upward and downward factors, levels and the chance of Central Bank intervention).
No parameters.
curl "https://mesadodolar.com.br/api/v1/leitura"
Real response example (lists shortened)
{
"dados": {
"ptax": {
"data": "2026-11-19",
"compra": 5.8883,
"venda": 5.8889
},
"variacao": {
"um_pregao": 0.013545144745447546,
"cinco_pregoes": 0.04891081702082167,
"vinte_pregoes": 0.1712910475963163,
"unidade": "fração (0,01 = 1%)"
},
"volatilidade_anualizada": {
"vinte_dias": 0.3373973540082303,
"sessenta_dias": 0.2337921309346451
},
"altas_seguidas_ou_quedas": 6,
"extremos_12_meses": {
"minimo": {
"data": "2026-05-11",
"valor": 4.8973
},
"maximo": {
"data": "2026-11-19",
"valor": 5.8889
}
},
"banco_central": {
"reservas_usd_milhoes": {
"data": "2026-11-18",
"valor": 363644
},
"estoque_swaps_usd_milhoes": {
"data": "2026-11-19",
"valor": 90250
},
"estoque_linhas_usd_milhoes": {
"data": "2026-11-19",
"valor": 3000
},
"swaps_sem_mudanca_desde": "2026-09-16",
"meta_selic_pct_aa": {
"data": "2026-11-20",
"valor": 13.75
}
},
"focus_cambio_fim_de_ano": {
"data": "2026-11-13",
"ano_referencia": 2026,
"mediana": 5.4,
"minimo": 4.9,
"maximo": 6,
"respondentes": 121
},
"leitura": {
"vies": "alta",
"intensidade": "forte",
"manchete": "Dólar sobe pelo 6º dia útil seguido e renova a máxima de 12 meses. O BC vendeu US$ 1,0 bi das reservas à vista para segurar o preço.",
"resumo": "A PTAX de 19/11, média da manhã que o Banco Central divulga por volta das 13h, saiu em 5,8889 (+1,35% sobre a do dia útil anterior). Em 5 dias úteis a variação é de +4,89%; em 20, de +17,13%. A volatilidade de 20 dias está em 33,7% ao ano, contra 23,4% em 60 dias: o dólar está oscilando bem mais que o normal. Em 18/11 o BC aceitou US$ 1,0 bi em leilão de linha, que é venda com compromisso de recompra: dá liquidez, mas não reduz as reservas de forma definitiva. O estoque de swaps cambiais do Banco Central está em US$ 90,25 bi, sem mudança desde 16/09.",
"cima": [
"6 altas seguidas na PTAX: o movimento ainda não perdeu força.",
"O preço está na máxima de 12 meses.",
"… mais 1 item"
],
"baixo": [
"Os economistas ouvidos pelo BC (pesquisa Focus) projetam 5,4000 no fim de 2026, 8,9% abaixo do preço atual.",
"Juro alto no Brasil (Selic em 13,75% ao ano) torna caro apostar na alta do dólar.",
"… mais 1 item"
],
"niveis": [
{
"valor": 6,
"motivo": "número redondo"
},
{
"valor": 5.9,
"motivo": "degrau de 10 centavos abaixo"
},
"… mais 1 item"
],
"chanceAtuacao": {
"nivel": "alta",
"pontos": 5,
"motivos": [
"6 altas seguidas",
"alta de 4,9% em 5 dias úteis",
"… mais 3 itens"
],
"sinais": [
{
"codigo": "seguidas",
"valor": 6
},
{
"codigo": "alta5",
"valor": 0.04891081702082167
},
"… mais 3 itens"
]
},
"referencia": 5.9292,
"baseNiveis": {
"maximo": {
"data": "2026-11-19",
"valor": 5.8889
},
"ptax": {
"venda": 5.8889,
"data": "2026-11-19"
},
"focus": {
"mediana": 5.4,
"ano": 2026
}
},
"focus": {
"texto": "Os economistas ouvidos pelo BC (pesquisa Focus) projetam 5,4000 no fim de 2026, 8,9% abaixo do preço atual.",
"mediana": 5.4,
"ano": 2026
},
"metodo": "Regras fixas sobre dados do Banco Central. Esta leitura não usa manchetes; as manchetes de câmbio do dia estão na ferramenta noticias_cambio.",
"chance_niveis": "chanceAtuacao.nivel tem dois valores: 'alta' (4 ou mais dos 5 sinais) e 'baixa', que se escreve 'sem sinal forte'. Não existe mais 'média' (fundida em 'baixa' em 19/11/2026). É contexto, não previsão."
},
"fonte": "Banco Central do Brasil (dados abertos)",
"aviso": "Dado público para consulta. Não é recomendação de investimento."
},
"fonte": "Banco Central do Brasil (dados abertos)",
"atualizado_em": "2026-11-19",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Other currencies in reais
GET /api/v1/moedascached for 5 minCentral Bank of Brazil closing rate in reais (R$ per unit, buying and selling) for the euro, pound, yen, Swiss franc, Canadian and Australian dollars, Danish, Norwegian and Swedish kroner (these nine have their own PTAX), Argentine, Mexican, Chilean and Colombian pesos, Peruvian sol, yuan, Indian rupee and Indonesian rupiah, won, rand, Turkish lira, zloty and forint (closing rate: the dollar PTAX crossed with the parity). Without a currency, lists all of them at the latest close with the daily and 20 business day change. With a currency, returns the latest rate (or the rate on a date; with no rate that day, the previous business day applies), the 1, 5 and 20 business day change, the parity against the dollar and the bulletin time. With an amount, converts at the selling rate both ways, with no spread, fee or IOF tax. History since 2000.
| Parameter | Accepts | Purpose |
|---|---|---|
| moeda | one of: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF | ISO currency code (EUR, GBP, ARS...). Leave out to list all. |
| data | date YYYY-MM-DD | Date YYYY-MM-DD (needs the currency). Leave out for the latest. |
| valor | number (decimal point), greater than 0 | Amount to convert (needs the currency). |
| de | one of: moeda, BRL | Currency of the amount: "moeda" (the requested code) or "BRL". Default "moeda". |
curl "https://mesadodolar.com.br/api/v1/moedas?moeda=EUR"
Real response example (lists shortened)
{
"dados": {
"moeda": "EUR",
"data": "2026-11-19",
"compra": 6.4659,
"venda": 6.4672,
"taxa_tipo": "PTAX de fechamento",
"horario_boletim": "13:04 (Brasília)",
"unidades_por_usd": 0.910581,
"usd_por_unidade": 1.0982,
"variacao_pct": {
"dia_util": 1.49,
"cinco_dias_uteis": 4.09,
"vinte_dias_uteis": 14.64
},
"pagina": "/euro",
"observacao": "R$ por unidade da moeda. Variação da taxa de venda; positivo = a moeda ficou mais cara em reais.",
"fonte": "Banco Central do Brasil, cotações de fechamento de todas as moedas (www4.bcb.gov.br/Download/fechamento)"
},
"fonte": "Banco Central do Brasil, cotações de fechamento de todas as moedas (www4.bcb.gov.br/Download/fechamento)",
"atualizado_em": "2026-11-19",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}A currency over a period
GET /api/v1/moedas/periodocached for 5 minDaily Central Bank of Brazil closing rate of one currency in reais (buying, selling and units per US$ 1) between two dates, since 2000. Up to 400 business days per call; for longer periods, make more than one call.
| Parameter | Accepts | Purpose |
|---|---|---|
| moeda * | one of: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF | ISO currency code (EUR, GBP, ARS...). |
| de * | date YYYY-MM-DD | Start date YYYY-MM-DD |
| ate * | date YYYY-MM-DD | End date YYYY-MM-DD |
curl "https://mesadodolar.com.br/api/v1/moedas/periodo?moeda=ARS&de=2026-10-01&ate=2026-10-31"
Real response example (lists shortened)
{
"dados": {
"moeda": "ARS",
"de": "2026-10-01",
"ate": "2026-10-31",
"dias": 21,
"truncado": false,
"unidade": "R$ por unidade da moeda",
"taxa_tipo": "Taxa de fechamento do BC (PTAX do dólar cruzada com a paridade)",
"linhas": [
{
"data": "2026-10-01",
"compra": 0.003414,
"venda": 0.003416,
"unidades_por_usd": 1525.5
},
{
"data": "2026-10-02",
"compra": 0.003424,
"venda": 0.003427,
"unidades_por_usd": 1525.5
},
"… mais 19 itens"
],
"fonte": "Banco Central do Brasil, cotações de fechamento de todas as moedas (www4.bcb.gov.br/Download/fechamento)"
},
"fonte": "Banco Central do Brasil, cotações de fechamento de todas as moedas (www4.bcb.gov.br/Download/fechamento)",
"atualizado_em": "2026-10-30",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Convert at the PTAX
GET /api/v1/convertercached for 5 minConverts an amount between dollars and reais at the PTAX selling rate for a date (or the latest). Does not include spread, fees or IOF tax: what banks and exchange houses charge is higher.
| Parameter | Accepts | Purpose |
|---|---|---|
| valor * | number (decimal point), greater than 0 | required |
| de * | one of: USD, BRL | Currency of the amount given |
| data | date YYYY-MM-DD | optional |
curl "https://mesadodolar.com.br/api/v1/converter?valor=1000&de=USD"
Real response example (lists shortened)
{
"dados": {
"valor": 1000,
"de": "USD",
"para": "BRL",
"resultado": 5888.9,
"taxa": 5.8889,
"taxa_tipo": "PTAX de venda",
"data_da_taxa": "2026-11-19",
"observacao": "Sem spread, tarifa ou IOF.",
"fonte": "Banco Central do Brasil (dados abertos)",
"referencia_viagem": {
"mes_do_vet": "2026-09-01",
"canais": [
{
"canal": "Dinheiro em espécie",
"total_brl": 6293.39,
"reais_por_dolar": 6.2934,
"instituicoes_na_mediana": 47,
"faixa_do_vet_usd": 1000
},
{
"canal": "Cartão pré-pago",
"total_brl": 6300.49,
"reais_por_dolar": 6.3005,
"instituicoes_na_mediana": 9,
"faixa_do_vet_usd": 1000
}
],
"conta": "PTAX de venda de 19/11/2026 × (VET mediano ÷ PTAX média de 09/2026). O VET já inclui spread, tarifas e IOF. Só entra mediana de 5 instituições ou mais.",
"observacao": "Referência do mercado (ranking do VET do Banco Central, cerca de 2 meses de atraso), não o preço de uma casa. Não é recomendação de investimento.",
"fonte": "Banco Central do Brasil, Ranking do VET (www3.bcb.gov.br/vet)"
}
},
"fonte": "Banco Central do Brasil (dados abertos)",
"atualizado_em": "2026-11-19",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Dollar calendar
GET /api/v1/agendacached for 5 minUpcoming events that may move the dollar: Copom and Fed decisions, US payroll and CPI, IPCA, Focus, FX flows, the month-end PTAX, B3 dollar futures expiry, credit line repurchases and auctions already announced by the Central Bank. Dates from official calendars, Brasília time, each event with its source. Filters by type and end date.
| Parameter | Accepts | Purpose |
|---|---|---|
| ate | date YYYY-MM-DD | Last date YYYY-MM-DD. Leave out for the next six months. |
| tipo | one of: copom, fomc, payroll, cpi, ipca, focus, fluxo, ptax-mes, vencimento-dol, vencimento-linha, vencimento-swap, leilao | Only one type of event. |
| limite | integer from 1 to 100 | Maximum number of events (default 30). |
curl "https://mesadodolar.com.br/api/v1/agenda?tipo=copom&limite=5"
Real response example (lists shortened)
{
"dados": {
"de": "2026-11-20",
"ate": "2027-05-22",
"fuso": "America/Sao_Paulo",
"eventos": [
{
"data": "2026-12-09",
"inicio": "2026-12-08",
"hora": "18:30",
"a_partir_da_hora": true,
"tipo": "copom",
"pais": "Brasil",
"evento": "Decisão da Selic (Copom)",
"por_que_importa": "A Selic define quanto rende o real frente ao dólar: mudança ou sinal novo do Copom mexe com a entrada e a saída de dólares.",
"data_por_regra": false,
"toda_semana": false,
"fonte": "Banco Central, calendário das reuniões do Copom",
"url": "https://www.bcb.gov.br/api/exportarics/sitebcb/agendaics?lista=Reuni%C3%B5es+do+Copom",
"conferido_em": "2026-11-20"
},
{
"data": "2027-01-27",
"inicio": "2027-01-26",
"hora": "18:30",
"a_partir_da_hora": true,
"tipo": "copom",
"pais": "Brasil",
"evento": "Decisão da Selic (Copom)",
"por_que_importa": "A Selic define quanto rende o real frente ao dólar: mudança ou sinal novo do Copom mexe com a entrada e a saída de dólares.",
"data_por_regra": false,
"toda_semana": false,
"fonte": "Banco Central, calendário das reuniões do Copom",
"url": "https://www.bcb.gov.br/api/exportarics/sitebcb/agendaics?lista=Reuni%C3%B5es+do+Copom",
"conferido_em": "2026-11-20"
},
"… mais 2 itens"
],
"calendarios_nao_publicados": [
"As datas do Relatório Focus depois de 28/12/2026 ainda não foram publicadas na fonte oficial.",
"As datas do IPCA depois de 12/01/2027 ainda não foram publicadas na fonte oficial.",
"… mais 2 itens"
],
"aviso": "Dado público para consulta. Não é recomendação de investimento."
},
"fonte": "Calendários oficiais; a fonte de cada evento vem no próprio evento (campos fonte e url)",
"atualizado_em": "2026-11-20",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Forward dollar and the cost of locking in (hedge)
GET /api/v1/hedgecached for 15 sTheoretical forward price of the dollar for a date, interpolated between the B3 dollar futures (DOL) expiries, applied to the current reference spot rate. Returns the cost of locking in today against spot, the check by interest rate differential (DI futures × SOFR) with the implied FX coupon, and scenarios of +10%, +5%, 0, −5% and −10% with and without locking in. Market price, without bank spread. Makes no recommendation.
| Parameter | Accepts | Purpose |
|---|---|---|
| data | date YYYY-MM-DD | Date of the dollar payment or receipt (YYYY-MM-DD). Default: 90 days from now. |
| valor_usd | number (decimal point), greater than 0 | Amount in dollars. Default: 10,000. |
| lado | one of: pagar, receber | Whether the person will pay or receive dollars on the date. Default: pagar (pay). |
curl "https://mesadodolar.com.br/api/v1/hedge?valor_usd=50000&lado=pagar"
Real response example (lists shortened)
{
"dados": {
"data": "2027-02-18",
"dias_corridos": 90,
"dias_uteis": 59,
"valor_usd": 50000,
"lado": "pagar",
"dolar_a_vista": {
"preco": 5.9292,
"momento": "2026-11-19T21:44:55.000Z",
"fonte": "B3"
},
"dolar_a_termo": 6.0249,
"custo_de_travar": {
"reais": 4783.02,
"sobre_o_a_vista_pct": 1.613,
"ao_ano_pct": 6.71
},
"conferencia_por_juros": {
"juro_brasil_pct_aa": 13.858,
"fonte_juro_brasil": "DI futuro da B3",
"sofr_pct_aa": 3.9,
"termo_pelos_juros": 6.0531,
"cupom_cambial_implicito_pct_aa": 5.794
},
"cenarios": [
{
"variacao_do_dolar_pct": 10,
"dolar_na_data": 6.5221,
"sem_trava_brl": 326106,
"com_trava_brl": 301243.02,
"resultado_da_trava_brl": 24862.98
},
{
"variacao_do_dolar_pct": 5,
"dolar_na_data": 6.2257,
"sem_trava_brl": 311283,
"com_trava_brl": 301243.02,
"resultado_da_trava_brl": 10039.98
},
"… mais 3 itens"
],
"vencimentos_usados": [
{
"simbolo": "DOLZ26",
"vencimento": "2026-12-01",
"dolar_a_termo": 5.94
},
{
"simbolo": "DOLF27",
"vencimento": "2027-01-04",
"dolar_a_termo": 5.9734
},
"… mais 22 itens"
],
"referencia": "Preço de mercado, não o do banco: sem spread, tarifas, margem nem impostos. Curva pelos ajustes do pregão anterior do dólar futuro (DOL) e do casado (FRP0), sobre o dólar à vista de 19/11/2026 às 18h44 (Brasília); a B3 pública chega com 15 minutos de atraso.",
"observacao": "resultado_da_trava_brl positivo = a pessoa ficou melhor com a trava. Simulação; não é recomendação de investimento.",
"pagina": "/hedge",
"fonte": "B3 (dólar futuro, casado e DI futuro) e Federal Reserve de Nova York (SOFR)"
},
"fonte": "B3 (dólar futuro, casado e DI futuro) e Federal Reserve de Nova York (SOFR)",
"atualizado_em": "2026-11-19T21:44:55.000Z",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}FX funds against the dollar (PTAX)
GET /api/v1/fundos-cambiaiscached for 1 hHow much the units of Brazilian dollar FX funds open to individuals returned (CVM data) over 1, 3, 6 and 12 months, the simple median across them and the change in the PTAX selling rate on the same dates. The difference is what the fund returned above or below the dollar itself: it adds the FX coupon (the dollar interest on the fund’s holdings) and subtracts the management fee. Over short windows the difference also mixes timing: the unit price uses the end-of-day dollar and the PTAX is set by 1 p.m. Funds are listed by net assets, not by return. Left out: exclusive or professional-investor funds, euro funds, funds under R$ 10 million in net assets, with fewer than 20 unitholders (usually a master fund) and funds that move against the dollar. Not investment advice.
| Parameter | Accepts | Purpose |
|---|---|---|
| limite | integer from 1 to 100 | How many funds to list, from the largest to the smallest by net assets. Default: 20. |
curl "https://mesadodolar.com.br/api/v1/fundos-cambiais?limite=10"
Real response example (lists shortened)
{
"dados": {
"data": "2026-11-18",
"ptax_venda_na_data": 5.8102,
"janelas": [
{
"meses": 1,
"de": "2026-10-16",
"ate": "2026-11-18",
"ptax_venda_inicio": 5.0826,
"variacao_ptax_pct": 14.32,
"mediana_fundos_pct": 15.66,
"diferenca_pp": 1.35,
"fundos_na_conta": 30
},
{
"meses": 3,
"de": "2026-08-18",
"ate": "2026-11-18",
"ptax_venda_inicio": 5.2043,
"variacao_ptax_pct": 11.64,
"mediana_fundos_pct": 13.24,
"diferenca_pp": 1.6,
"fundos_na_conta": 30
},
"… mais 2 itens"
],
"fundos_na_conta": 30,
"patrimonio_total_brl": 5839774555,
"captacao_liquida_mes_brl": -95317941,
"mes_da_captacao": "2026-11",
"fora_da_conta": {
"exclusivo": 4,
"euro": 2,
"patrimonio": 9,
"cotistas": 18,
"inverso": 1
},
"fundos": [
{
"nome": "ITAÚ CAMBIAL FUNDO DE INVESTIMENTO FINANCEIRO DA CLASSE DE INVESTIMENTO EM COTAS RESP LIMITADA",
"cnpj": "01.623.535/0001-81",
"so_investidor_qualificado": false,
"patrimonio_brl": 1314127063,
"cotistas": 129,
"retorno_pct": {
"1m": 15.67,
"3m": 13.36,
"6m": 19.29,
"12m": 15.05
},
"captacao_liquida_mes_brl": -89582095
},
{
"nome": "SANTANDER VIP CAMBIAL - FIF RESP LIMITADA",
"cnpj": "10.362.043/0001-70",
"so_investidor_qualificado": false,
"patrimonio_brl": 925360556,
"cotistas": 113,
"retorno_pct": {
"1m": 15.52,
"3m": 13.27,
"6m": 19.22,
"12m": 15.25
},
"captacao_liquida_mes_brl": -100380243
},
"… mais 8 itens"
],
"observacao": "Retorno da cota, já descontadas as taxas do fundo e antes do imposto de renda. diferenca_pp = mediana dos fundos − variação da PTAX, em pontos percentuais. Retorno null: o fundo não tinha cota na data inicial. Rentabilidade passada não garante rentabilidade futura. Não é recomendação de investimento.",
"pagina": "/fundos-cambiais",
"fonte": "Comissão de Valores Mobiliários (CVM), dados abertos: cadastro de classes e informe diário de fundos (dados.cvm.gov.br); Banco Central do Brasil, PTAX de venda"
},
"fonte": "Comissão de Valores Mobiliários (CVM), dados abertos: cadastro de classes e informe diário de fundos (dados.cvm.gov.br); Banco Central do Brasil, PTAX de venda",
"atualizado_em": "2026-11-18",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Remittances: VET ranking
GET /api/v1/remessascached for 1 hThe Central Bank of Brazil’s monthly ranking of the effective total cost (VET, reais per dollar, including rate, fees and IOF tax) by provider: cash, prepaid card or personal transfer to the US, buying or selling, from best to worst for the customer, with the gap to the same month’s average PTAX. Published about 2 months late.
| Parameter | Accepts | Purpose |
|---|---|---|
| opcao | one of: especie, cartao, remessa | especie (cash), cartao (prepaid card) or remessa (transfer to the US). Default: especie. |
| operacao | one of: compra, venda | compra (customer buys or sends dollars) or venda (sells or receives). Default: compra. |
| valor_usd | one of: 100, 1000, 5000 | Operation amount range in US$: 100, 1000 or 5000. Default: 1000. |
| mes | date YYYY-MM-DD | Reference month, as YYYY-MM-01. Default: the latest published. |
curl "https://mesadodolar.com.br/api/v1/remessas?opcao=remessa&operacao=compra&valor_usd=1000"
Real response example (lists shortened)
{
"dados": {
"mes_de_referencia": "2026-09-01",
"opcao": "Transferência pessoal para os EUA",
"operacao": "compra",
"faixa_usd": 1000,
"ptax_media_do_mes": 5.1447,
"ptax_usada": "venda",
"instituicoes": [
{
"posicao": 1,
"instituicao": "BCO RENDIMENTO S.A.",
"cnpj_base": "68900810",
"vet": 5.1973,
"distancia_da_ptax_pct": 1.02,
"operacoes": 42
},
{
"posicao": 2,
"instituicao": "WISE",
"cnpj_base": "36588217",
"vet": 5.3586,
"distancia_da_ptax_pct": 4.16,
"operacoes": 990
},
"… mais 19 itens"
],
"total_de_instituicoes": 21,
"meses_disponiveis": [
"2026-09-01",
"2026-08-01",
"… mais 1 item"
],
"observacao": "Média do que cada instituição cobrou no mês de referência, não o preço de hoje. Na compra, a distância da PTAX inclui IOF, tarifas e spread. Não é recomendação de investimento.",
"pagina": "/remessas",
"fonte": "Banco Central do Brasil, Ranking do VET (www3.bcb.gov.br/vet)"
},
"fonte": "Banco Central do Brasil, Ranking do VET (www3.bcb.gov.br/vet)",
"atualizado_em": "2026-09-01",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Remittances today: how much arrives, by provider
GET /api/v1/remessas-hojecached for 10 minToday’s price of an international transfer, by provider, from Wise’s public comparison tool (collected every 30 minutes): exchange rate, fee, amount received and the gap to the mid-market rate (the rate without a margin, as reported by Wise). Two directions: usd_brl (US$ 1,000 from the US to Brazil, several providers) and brl_usd (R$ 5,000 from Brazil to the US, where the tool only lists Wise itself). It is not the Central Bank of Brazil’s VET ranking (remessas_vet), which is the average each provider charged about 2 months ago. Listed by amount received, with no provider singled out. Not a recommendation.
| Parameter | Accepts | Purpose |
|---|---|---|
| sentido | one of: usd_brl, brl_usd | usd_brl: send US$ 1,000 from the US to Brazil. brl_usd: send R$ 5,000 from Brazil to the US. Default: usd_brl. |
curl "https://mesadodolar.com.br/api/v1/remessas-hoje?sentido=usd_brl"
Real response example (lists shortened)
{
"dados": {
"sentido": "USD para BRL",
"valor_enviado": 1000,
"moeda_enviada": "USD",
"moeda_recebida": "BRL",
"coletado_em": "2026-11-20T15:07:40.001Z",
"cambio_medio_reais_por_dolar": 5.9453,
"provedores": [
{
"provedor": "Remitly",
"cambio_reais_por_dolar": 5.9373,
"tarifa": 0,
"recebe": 5937.29,
"diferenca_para_o_cambio_medio_pct": -0.13,
"custo_total_pct": 0.13,
"cotado_em": "2026-11-20T14:45:42.943Z"
},
{
"provedor": "Instarem",
"cambio_reais_por_dolar": 5.9053,
"tarifa": 0,
"recebe": 5905.35,
"diferenca_para_o_cambio_medio_pct": -0.67,
"custo_total_pct": 0.67,
"cotado_em": "2026-11-20T12:20:54.030Z"
},
"… mais 4 itens"
],
"observacao": "tarifa em USD, recebe em BRL. diferenca_para_o_cambio_medio_pct = câmbio do provedor ÷ câmbio médio − 1 (negativo: o provedor entrega menos BRL por USD). custo_total_pct = quanto chega a menos do que o valor enviado convertido no câmbio médio, somando margem e tarifa. cotado_em é quando a Wise consultou aquele provedor, e pode ser horas antes da coleta. Valores como o comparador informa; o provedor pode cobrar outros custos (IOF, banco intermediário). Ordem por quanto chega. Não é recomendação.",
"pagina": "/remessas",
"fonte": "Wise (comparador público), api.wise.com/v4/comparisons"
},
"fonte": "Wise (comparador público), api.wise.com/v4/comparisons",
"atualizado_em": "2026-11-20T15:07:40.001Z",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Custo de comprar dólar hoje, por canal
GET /api/v1/comprar-dolarcached for 5 minHow much buying a dollar amount costs in reais today through each channel: cash, prepaid card, credit or debit card abroad and transfer to your own account in the US. Calculation: latest PTAX selling rate × (VET ÷ that month’s average PTAX), using the median provider and the 3 lowest VETs in the Central Bank of Brazil ranking, splitting out each channel’s IOF tax and the spread with fees, and the gap to the bare PTAX. The VET comes out about 2 months late: it is a reference, not the provider’s rate right now. Credit cards are not in the VET ranking: only the floor (PTAX + IOF) is given. Not investment advice.
| Parameter | Accepts | Purpose |
|---|---|---|
| valor_usd | number (decimal point), greater than 0 | Amount in dollars. Default: 1,000. |
curl "https://mesadodolar.com.br/api/v1/comprar-dolar?valor_usd=2000"
Real response example (lists shortened)
{
"dados": {
"valor_usd": 2000,
"ptax": {
"data": "2026-11-19",
"venda": 5.8889,
"fonte": "Banco Central do Brasil (dados abertos)"
},
"vet": {
"mes_de_referencia": "2026-09-01",
"ptax_media_do_mes": 5.1447,
"consultado_em": "2026-11-20T10:40:07.709Z",
"fonte": "Banco Central do Brasil, Ranking do VET (www3.bcb.gov.br/vet)"
},
"canais": [
{
"canal": "Dinheiro em espécie",
"iof_pct": 3.5,
"iof_incisos": [
"XX"
],
"faixa_do_vet_usd": 1000,
"mediana": {
"total_brl": 12586.78,
"ptax_seca_brl": 11777.8,
"iof_brl": 425.64,
"spread_e_tarifas_brl": 383.34,
"diferenca_para_ptax_brl": 808.98,
"reais_por_dolar": 6.2934,
"acima_da_ptax_pct": 6.87,
"vet": 5.4981,
"instituicoes": 47
},
"tres_menores_vet": [
{
"instituicao": "BANCO BTG PACTUAL S.A.",
"vet": 5.4133,
"total_brl": 12392.65,
"ptax_seca_brl": 11777.8,
"iof_brl": 419.08,
"spread_e_tarifas_brl": 195.78,
"diferenca_para_ptax_brl": 614.85,
"reais_por_dolar": 6.1963,
"acima_da_ptax_pct": 5.22
},
{
"instituicao": "BRX SOCIEDADE CC S.A.",
"vet": 5.4227,
"total_brl": 12414.17,
"ptax_seca_brl": 11777.8,
"iof_brl": 419.8,
"spread_e_tarifas_brl": 216.57,
"diferenca_para_ptax_brl": 636.37,
"reais_por_dolar": 6.2071,
"acima_da_ptax_pct": 5.4
},
"… mais 1 item"
],
"piso_ptax_mais_iof": null
},
{
"canal": "Cartão pré-pago",
"iof_pct": 3.5,
"iof_incisos": [
"X"
],
"faixa_do_vet_usd": 1000,
"mediana": {
"total_brl": 12600.98,
"ptax_seca_brl": 11777.8,
"iof_brl": 426.12,
"spread_e_tarifas_brl": 397.06,
"diferenca_para_ptax_brl": 823.18,
"reais_por_dolar": 6.3005,
"acima_da_ptax_pct": 6.99,
"vet": 5.5043,
"instituicoes": 9
},
"tres_menores_vet": [
{
"instituicao": "BPY CCTVM S.A.",
"vet": 5.4446,
"total_brl": 12464.31,
"ptax_seca_brl": 11777.8,
"iof_brl": 421.5,
"spread_e_tarifas_brl": 265.01,
"diferenca_para_ptax_brl": 686.51,
"reais_por_dolar": 6.2322,
"acima_da_ptax_pct": 5.83
},
{
"instituicao": "BCO DO BRASIL S.A.",
"vet": 5.4588,
"total_brl": 12496.81,
"ptax_seca_brl": 11777.8,
"iof_brl": 422.6,
"spread_e_tarifas_brl": 296.42,
"diferenca_para_ptax_brl": 719.01,
"reais_por_dolar": 6.2484,
"acima_da_ptax_pct": 6.1
},
"… mais 1 item"
],
"piso_ptax_mais_iof": null
},
"… mais 2 itens"
],
"iof": {
"norma": "Decreto 6.306/2007, art. 15-B",
"redacao": "Decreto 12.499/2025",
"vigente_desde": "2025-06-11",
"conferido_em": "2026-11-19",
"url": "https://www.planalto.gov.br/ccivil_03/_ato2007-2010/2007/decreto/d6306.htm"
},
"referencia": "Conta de referência, não o preço de agora: PTAX de venda de 19/11/2026 com a distância que cada instituição cobrou sobre a PTAX em 09/2026 (o ranking do VET sai com cerca de 2 meses de atraso). Antes de fechar, a instituição é obrigada a informar o VET da operação.",
"observacao": "VET é o valor efetivo total: o preço final por dólar, já com taxa, tarifas e IOF. Não é recomendação de investimento.",
"pagina": "/comprar-dolar",
"fonte": "Banco Central do Brasil (PTAX e Ranking do VET) e Decreto 6.306/2007 (IOF)"
},
"fonte": "Banco Central do Brasil (PTAX e Ranking do VET) e Decreto 6.306/2007 (IOF)",
"atualizado_em": "2026-11-19",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Calculadora de viagem
GET /api/v1/viagemcached for 5 minTotal cost in reais of a trip from days, daily spending in dollars and the share taken in cash (the rest on card): cash and prepaid card at the median Central Bank VET applied to the latest PTAX selling rate, credit card at the PTAX + IOF floor, with IOF shown separately. Includes the same calculation with the dollar 5% lower and 5% higher on the purchase day (sensitivity, not a forecast). Not investment advice.
| Parameter | Accepts | Purpose |
|---|---|---|
| dias | integer from 1 to 365 | Days of travel. Default: 7. |
| gasto_dia_usd | number (decimal point), greater than 0 | Daily spending at the destination, in US$. Default: 200. |
| especie_pct | integer from 0 to 100 | Share of spending taken in cash, in % (the rest on card). Default: 30. |
curl "https://mesadodolar.com.br/api/v1/viagem?dias=7&gasto_dia_usd=200&especie_pct=30"
Real response example (lists shortened)
{
"dados": {
"dias": 7,
"gasto_dia_usd": 200,
"especie_pct": 30,
"total_usd": 1400,
"ptax": {
"data": "2026-11-19",
"venda": 5.8889,
"fonte": "Banco Central do Brasil (dados abertos)"
},
"vet_mes_de_referencia": "2026-09-01",
"especie": {
"usd": 420,
"total_brl": 2643.22,
"iof_brl": 89.38,
"faixa_do_vet_usd": 1000
},
"cartao_pre_pago": {
"usd": 980,
"total_brl": 6174.48,
"iof_brl": 208.8,
"faixa_do_vet_usd": 1000
},
"cartao_de_credito_piso": {
"usd": 980,
"total_brl": 5973.11,
"iof_brl": 201.99,
"faixa_do_vet_usd": null
},
"total_especie_mais_pre_pago": {
"total_brl": 8817.7,
"iof_brl": 298.18,
"diferenca_para_ptax_brl": 573.24
},
"total_especie_mais_credito_piso": {
"total_brl": 8616.34,
"iof_brl": 291.37,
"diferenca_para_ptax_brl": 371.88
},
"sensibilidade": [
{
"dolar_no_dia_da_compra_pct": -5,
"ptax_considerada": 5.5945,
"especie_mais_pre_pago_brl": 8376.82,
"especie_mais_credito_piso_brl": 8185.52
},
{
"dolar_no_dia_da_compra_pct": 0,
"ptax_considerada": 5.8889,
"especie_mais_pre_pago_brl": 8817.7,
"especie_mais_credito_piso_brl": 8616.34
},
"… mais 1 item"
],
"observacao": "Espécie e pré-pago pela mediana do VET do mês de referência (cerca de 2 meses de atraso) aplicada à PTAX mais recente; parte com total_brl nulo não tem VET com 5 instituições ou mais na faixa; cartão de crédito sem o spread do emissor, que o BC não publica no ranking. A sensibilidade de 5% é uma conta, não previsão do dólar. Não é recomendação de investimento.",
"pagina": "/viagem",
"fonte": "Banco Central do Brasil (PTAX e Ranking do VET) e Decreto 6.306/2007 (IOF)"
},
"fonte": "Banco Central do Brasil (PTAX e Ranking do VET) e Decreto 6.306/2007 (IOF)",
"atualizado_em": "2026-11-19",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Dólar corrigido pela inflação (IPCA)
GET /api/v1/dolar-corrigidocached for 1 hPTAX selling rate for a date since 1994-07-01 (on weekends or holidays, the previous business day’s rate, flagged) and what a dollar amount on that date is worth today in reais adjusted by IPCA (Central Bank SGS series 433, IBGE monthly change), up to the latest month published. Includes the “real dollar”: US$ 1 of that date in today’s reais, compared with the latest PTAX. In the month of the date only the remaining days count; the following months count in full. No spread, fees or IOF. It does not say whether the dollar is expensive or cheap. Not investment advice.
| Parameter | Accepts | Purpose |
|---|---|---|
| data * | date YYYY-MM-DD | Date YYYY-MM-DD, from 1994-07-01 to today. |
| valor_usd | number (decimal point), greater than 0 | Amount in dollars. Default: 1. |
curl "https://mesadodolar.com.br/api/v1/dolar-corrigido?data=2002-10-22&valor_usd=1000"
Real response example (lists shortened)
{
"dados": {
"data_pedida": "2002-10-22",
"valor_usd": 1000,
"ptax": {
"data": "2002-10-22",
"venda": 3.9552,
"dia_util_anterior": false
},
"reais_na_data": 3955.2,
"ipca": {
"fator": 3.990757,
"acumulado_pct": 299.08,
"ate_mes": "2026-10",
"meses_cheios": 288,
"dias_no_mes_da_data": "10/31",
"mes_sem_ipca_publicado": false
},
"reais_corrigidos": 15784.24,
"dolar_real": {
"reais_de_hoje_por_us$1": 15.7842,
"observacao": "US$ 1 de 2002-10-22 em reais de 2026-10"
},
"ptax_mais_recente": {
"data": "2026-11-19",
"venda": 5.8889,
"mesmo_valor_hoje_brl": 5888.9,
"dolar_real_sobre_ptax_pct": 168.03
},
"observacao": "Correção pelo IPCA, produto de (1 + variação do mês). No mês da data entra a fração dos dias restantes, contando o próprio dia. Sem spread, tarifa nem IOF. Não é recomendação de investimento.",
"pagina": "/dolar-corrigido?data=2002-10-22&valor=1000",
"fonte": "Banco Central do Brasil: PTAX de venda e série SGS 433 (IPCA mensal, do IBGE)"
},
"fonte": "Banco Central do Brasil: PTAX de venda e série SGS 433 (IPCA mensal, do IBGE)",
"atualizado_em": "2026-10",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}FX glossary
GET /api/v1/glossariocached for 1 dayPlain-language explanation of FX terms (PTAX, FX swap, credit line auction, FX coupon, VET and others). Without a term, lists the available ones.
| Parameter | Accepts | Purpose |
|---|---|---|
| termo | text (up to 60 characters) | Term identifier, for example "swap-cambial". |
curl "https://mesadodolar.com.br/api/v1/glossario?termo=ptax"
Real response example (lists shortened)
{
"dados": {
"termo": "ptax",
"titulo": "PTAX",
"resumo": "Taxa de câmbio de referência calculada e divulgada pelo Banco Central em cada dia útil. É a taxa usada em contratos, balanços e impostos.",
"texto": [
"A PTAX é a média das taxas de compra e de venda de dólar informadas por instituições credenciadas (os dealers de câmbio) em quatro consultas que o Banco Central faz ao longo da manhã, por volta das 10h, 11h, 12h e 13h. Cada consulta gera um boletim parcial; a PTAX do dia é a média dos quatro e sai pouco depois das 13h.",
"Ela não é o preço pelo qual alguém compra dólar no banco ou na casa de câmbio. É uma referência: serve para liquidar contratos futuros na B3, converter valores em balanços de empresas, calcular impostos e corrigir contratos atrelados ao dólar.",
"… mais 2 itens"
],
"relacionados": [
"dolar-comercial",
"dolar-futuro",
"… mais 1 item"
]
},
"atualizado_em": null,
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}