API pública da Mesa do Dólar
Os mesmos dados do portal em JSON, para planilhas, sistemas e sites. Gratuita, sem chave e só de leitura.
Como usar
Faça um GET em qualquer endereço abaixo. A lista completa, legível por máquina, está em /api/v1 e o documento OpenAPI em /api/v1/openapi.json.
Toda resposta traz dados (o resultado), fonte, atualizado_em (data ou momento do dado) e o aviso de que não é recomendação. Erros voltam em JSON, com erro.mensagem em português, e o código HTTP correspondente (400 parâmetro inválido, 404 sem dado, 429 acima do limite).
Os dados são os mesmos das ferramentas do MCP da Mesa e do chat: o que a API responde é o que o portal mostra.
Regras de uso
| Limite | 60 requisições por minuto por endereço IP |
|---|---|
| Acima do limite | HTTP 429, com Retry-After de 60 s |
| Navegador (CORS) | liberado para GET de qualquer site |
| Atribuição | “Fonte: Mesa do Dólar” com link para mesadodolar.com.br |
| Garantia | nenhuma: dado público, pode atrasar ou faltar |
Cada resposta diz por quanto tempo pode ser guardada (cabeçalho Cache-Control): de 2 s para o preço de agora a 1 dia para PTAX de datas passadas. Respeite esse tempo antes de consultar de novo. Dado público para consulta, sem garantia. Não é recomendação de investimento.
Widget de cotação
Para mostrar o dólar à vista no seu site sem programar, use o widget de cotação: um iframe pronto para copiar. Há também a variante PTAX do dia, estável, para blog e site contábil.
PTAX do mês em CSV, direto na planilha
GET /api/v1/ptax/mes.csvA PTAX de compra e de venda de cada dia útil de um mês, em CSV, para Excel, Google Planilhas e sistemas contábeis. A primeira linha do arquivo já é o cabeçalho, então a planilha lê as colunas sem ajuste. A fonte (Banco Central do Brasil) e o último dia com dado vêm nos cabeçalhos HTTP X-Fonte e X-Dados-Ate. Parâmetros: ano e mes (obrigatórios) e idioma (opcional): pt e es com ponto e vírgula entre colunas, vírgula decimal e data dd/mm/aaaa; en com vírgula entre colunas, ponto decimal e data AAAA-MM-DD. O arquivo baixado se chama ptax-AAAA-MM.csv. Mesmo limite de requisições da API em JSON.
Google Planilhas
=IMPORTDATA("https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10"; ";"; "pt_BR")Cole numa célula vazia. A planilha busca o CSV e atualiza sozinha de tempos em tempos; o terceiro argumento diz que a vírgula é a decimal.
Excel (Power Query)
let
Source = Csv.Document(Web.Contents("https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10"), [Delimiter=";", Encoding=65001]),
Ptax = Table.PromoteHeaders(Source),
Typed = Table.TransformColumnTypes(Ptax, {{"data", type date}, {"compra", type number}, {"venda", type number}}, "pt-BR")
in
TypedDados > Obter Dados > De Outras Fontes > Consulta Nula; abra o Editor Avançado, cole o código e clique em Concluído. Para atualizar, Dados > Atualizar Tudo.
Na linha de comando
curl -o ptax-2026-10.csv "https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10"
Dólar à vista agora
GET /api/v1/cotacaoguarda por 2 sO dólar à vista do topo do portal (R$ por US$). Com o pregão da B3 aberto (dia útil, das 9h às 18h30 de Brasília) é uma estimativa em tempo real: o à vista da B3 (dólar futuro menos o casado, que chega com 15 minutos de atraso) corrigido pelo movimento do dólar digital nesses 15 minutos. Com o pregão fechado (noite, fim de semana, feriado) é o fechamento do último pregão, parado, com a data em fechamento_data; o dólar digital, que negocia 24 horas, vem à parte como referência. Traz a variação e diz contra o que ela foi medida. Não é a PTAX. Pergunta sobre USDT, USDC ou a distância entre o dólar digital e o à vista é com dolar_digital, não com esta.
Sem parâmetros.
curl "https://mesadodolar.com.br/api/v1/cotacao"
Exemplo de resposta real (listas encurtadas)
{
"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.0122,
"momento": "2026-11-20T15:16:04.251Z",
"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": 63069,
"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 de uma data
GET /api/v1/ptaxguarda por 1 minTaxa PTAX de compra e de venda do dólar (R$ por US$) divulgada pelo Banco Central. Sem data, devolve a mais recente. Em fim de semana ou feriado devolve a do dia útil anterior e avisa.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| data | data AAAA-MM-DD | Data AAAA-MM-DD. Omitir para a mais recente. |
curl "https://mesadodolar.com.br/api/v1/ptax?data=2026-10-30"
Exemplo de resposta real (listas encurtadas)
{
"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 num período
GET /api/v1/ptax/periodoguarda por 5 minSérie diária da PTAX de compra e venda entre duas datas. Máximo de 400 dias úteis por chamada (cerca de 19 meses); para períodos maiores, faça mais de uma chamada.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| de * | data AAAA-MM-DD | Data inicial AAAA-MM-DD |
| ate * | data AAAA-MM-DD | Data final AAAA-MM-DD |
curl "https://mesadodolar.com.br/api/v1/ptax/periodo?de=2026-10-01&ate=2026-10-31"
Exemplo de resposta real (listas encurtadas)
{
"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 de um mês
GET /api/v1/ptax/mesguarda por 5 minResumo da PTAX de venda de um mês: média mensal, taxa do último dia útil, máxima e mínima. É a consulta usada em fechamento contábil e em contratos.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| ano * | inteiro de 1985 a 2100 | obrigatório |
| mes * | inteiro de 1 a 12 | obrigatório |
curl "https://mesadodolar.com.br/api/v1/ptax/mes?ano=2026&mes=10"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Atuações e leilões do Banco Central
GET /api/v1/atuacoesguarda por 1 minO que o Banco Central fez no câmbio: leilões de câmbio lidos dos comunicados do dia (data, teto, valor aceito, taxa de corte) e mudanças nos estoques de linhas e de swap cambial, na data de liquidação ou vencimento. Volume em US$ milhões; negativo é vencimento.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| limite | inteiro de 1 a 100 | Quantas atuações, da mais recente para trás. Padrão 20. |
curl "https://mesadodolar.com.br/api/v1/atuacoes?limite=5"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Dólar futuro na B3
GET /api/v1/futuroguarda por 15 sCotação do dólar futuro na B3: o vencimento mais negociado (preço, variação sobre o ajuste anterior), o volume do pregão somando contrato cheio (DOL) e mini (WDO) e a lista de vencimentos com contratos negociados e em aberto. Preços em reais por dólar. A cotação pública da B3 chega com 15 minutos de atraso.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| contrato | um de: DOL, WDO | Lista de vencimentos de qual contrato. Padrão: DOL (cheio, US$ 50 mil). |
curl "https://mesadodolar.com.br/api/v1/futuro?contrato=WDO"
Exemplo de resposta real (listas encurtadas)
{
"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:16:00.000Z"
},
"volume_do_pregao": {
"contratos_dol": 361900,
"contratos_wdo": 4912507,
"financeiro_brl": 397256100060,
"nocional_usd": 67220070000
},
"contrato": "WDO",
"tamanho_do_contrato_usd": 10000,
"vencimentos": [
{
"simbolo": "WDOZ26",
"vencimento": "2026-12-01",
"ultimo": 5.951,
"ajuste_anterior": 5.924052,
"minimo": 5.868,
"maximo": 5.9695,
"contratos_hoje": 4894575,
"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:16:00.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)"
}Dólar digital (USDT e USDC)
GET /api/v1/digitalguarda por 2 sPreço em reais das stablecoins de dólar (USDT e USDC) em corretoras, com variação e volume das últimas 24 horas e a distância para o dólar à vista da B3. Mercado aberto 24 horas, inclusive fim de semana; o preço é atualizado a cada 2 segundos.
Sem parâmetros.
curl "https://mesadodolar.com.br/api/v1/digital"
Exemplo de resposta real (listas encurtadas)
{
"dados": {
"usdt_brl": {
"preco": 6.0122,
"compra": 6.0122,
"venda": 6.0123,
"variacao_24h_pct": 2.1,
"consultado_em": "2026-11-20T15:16:04.251Z"
},
"volume_24h_brl": 512836567,
"corretoras": [
{
"corretora": "Binance",
"preco": 6.0122,
"volume_24h_brl": 432280486
},
{
"corretora": "Foxbit",
"preco": 6.0134,
"volume_24h_brl": 80556081
}
],
"usdc_brl": {
"preco": 6.019,
"variacao_24h_pct": 2.2
},
"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:16:04.251Z",
"aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
"atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}Fluxo cambial
GET /api/v1/fluxoguarda por 1 hSaldo do câmbio contratado no Brasil (entrada menos saída de dólares), separado em comercial e financeiro, somado por semana, mês ou ano, e o acumulado do ano até o último dia publicado contra o ano anterior até a mesma data. US$ milhões; positivo é entrada líquida. O Banco Central publica os dias em lote, com cerca de uma semana de atraso.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| periodo | um de: semana, mes, ano | Agrupamento. Padrão: semana. |
| quantos | inteiro de 1 a 120 | Quantos períodos, do mais recente para trás. Padrão 12. |
curl "https://mesadodolar.com.br/api/v1/fluxo?periodo=mes&quantos=6"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Balança comercial e fluxo comercial
GET /api/v1/balancaguarda por 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.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| meses | inteiro de 1 a 48 | Quantos meses, do mais recente para trás. Padrão 12. |
curl "https://mesadodolar.com.br/api/v1/balanca?meses=6"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Reservas internacionais
GET /api/v1/reservasguarda por 1 hÚltimos valores de uma série: "reservas" (reservas internacionais), "swaps" (estoque de swap cambial), "linhas" (estoque de linhas com recompra), todas em US$ milhões, "selic" (meta, % ao ano) e o fluxo cambial diário em US$ milhões ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positivo é entrada líquida). Sem código, lista as séries disponíveis.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| pontos | inteiro de 1 a 400 | Quantos valores, do mais recente para trás. Padrão 30. |
curl "https://mesadodolar.com.br/api/v1/reservas?pontos=5"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Séries do Banco Central
GET /api/v1/serieguarda por 1 hÚltimos valores de uma série: "reservas" (reservas internacionais), "swaps" (estoque de swap cambial), "linhas" (estoque de linhas com recompra), todas em US$ milhões, "selic" (meta, % ao ano) e o fluxo cambial diário em US$ milhões ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positivo é entrada líquida). Sem código, lista as séries disponíveis.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| codigo | um de: reservas, swaps, linhas, selic, fluxo_total, fluxo_comercial, fluxo_financeiro | opcional |
| pontos | inteiro de 1 a 400 | Quantos valores, do mais recente para trás. Padrão 30. |
curl "https://mesadodolar.com.br/api/v1/serie?codigo=swaps&pontos=5"
Exemplo de resposta real (listas encurtadas)
{
"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: projeção do dólar
GET /api/v1/focusguarda por 1 hMediana da projeção do dólar para o fim de cada ano no boletim Focus do Banco Central (pesquisa semanal com bancos, gestoras e consultorias), com a mínima, a máxima e o número de respostas. R$ por US$.
Sem parâmetros.
curl "https://mesadodolar.com.br/api/v1/focus"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Leitura do dia e panorama
GET /api/v1/leituraguarda por 5 minRetrato atual do dólar no Brasil pelos dados oficiais: última PTAX, variações, volatilidade, máxima e mínima de 12 meses, reservas, estoques de swap e de linhas, Selic, Focus e a leitura automática da Mesa do Dólar (viés, fatores de alta e de baixa, níveis e chance de atuação do BC).
Sem parâmetros.
curl "https://mesadodolar.com.br/api/v1/leitura"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Outras moedas em reais
GET /api/v1/moedasguarda por 5 minCotação de fechamento do Banco Central em reais (R$ por unidade, compra e venda) do euro, libra, iene, franco suíço, dólares canadense e australiano, coroas dinamarquesa, norueguesa e sueca (essas nove com PTAX própria), peso argentino, mexicano, chileno e colombiano, sol peruano, yuan, rupias indiana e indonésia, won, rand, lira turca, zloty e florim (taxa de fechamento: PTAX do dólar cruzada com a paridade). Sem moeda, lista todas no último fechamento com a variação no dia e em 20 dias úteis. Com moeda, traz a cotação mais recente (ou a de uma data; sem cotação na data, vale a do dia útil anterior), a variação em 1, 5 e 20 dias úteis, a paridade contra o dólar e o horário do boletim. Com valor, converte pela taxa de venda nos dois sentidos, sem spread, tarifa nem IOF. Histórico desde 2000.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| moeda | um de: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF | Sigla ISO da moeda (EUR, GBP, ARS...). Omitir para listar todas. |
| data | data AAAA-MM-DD | Data AAAA-MM-DD (precisa da moeda). Omitir para a mais recente. |
| valor | número (ponto decimal), maior que 0 | Valor a converter (precisa da moeda). |
| de | um de: moeda, BRL | Moeda do valor informado: "moeda" (a sigla pedida) ou "BRL". Padrão "moeda". |
curl "https://mesadodolar.com.br/api/v1/moedas?moeda=EUR"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Uma moeda num período
GET /api/v1/moedas/periodoguarda por 5 minSérie diária da cotação de fechamento do Banco Central de uma moeda em reais (compra, venda e unidades por US$ 1) entre duas datas, desde 2000. Máximo de 400 dias úteis por chamada; para períodos maiores, faça mais de uma chamada.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| moeda * | um de: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUF | Sigla ISO da moeda (EUR, GBP, ARS...). |
| de * | data AAAA-MM-DD | Data inicial AAAA-MM-DD |
| ate * | data AAAA-MM-DD | Data final AAAA-MM-DD |
curl "https://mesadodolar.com.br/api/v1/moedas/periodo?moeda=ARS&de=2026-10-01&ate=2026-10-31"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Converter pela PTAX
GET /api/v1/converterguarda por 5 minConverte um valor entre dólar e real pela PTAX de venda de uma data (ou a mais recente). Não inclui spread, tarifa nem IOF: o valor cobrado por bancos e casas de câmbio é maior. De dólar para real, sem data, traz também referencia_viagem: quanto o valor sai em espécie e no cartão pré-pago pela mediana do VET do Banco Central (já com spread, tarifas e IOF), quando o mês tem 5 instituições ou mais.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| valor * | número (ponto decimal), maior que 0 | obrigatório |
| de * | um de: USD, BRL | Moeda do valor informado |
| data | data AAAA-MM-DD | opcional |
curl "https://mesadodolar.com.br/api/v1/converter?valor=1000&de=USD"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Agenda do dólar
GET /api/v1/agendaguarda por 5 minPróximos eventos que podem mexer com o dólar: decisões do Copom e do Fed, payroll e CPI dos EUA, IPCA, Focus, fluxo cambial, PTAX de fim de mês, vencimento do dólar futuro na B3, recompras de linha e leilões já anunciados pelo BC. Datas de calendários oficiais, hora de Brasília, cada evento com a fonte. Filtra por tipo e por data final.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| ate | data AAAA-MM-DD | Última data AAAA-MM-DD. Omitir para os próximos seis meses. |
| tipo | um de: copom, fomc, payroll, cpi, ipca, focus, fluxo, ptax-mes, vencimento-dol, vencimento-linha, vencimento-swap, leilao | Só um tipo de evento. |
| limite | inteiro de 1 a 100 | Máximo de eventos (padrão 30). |
curl "https://mesadodolar.com.br/api/v1/agenda?tipo=copom&limite=5"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Dólar a termo e custo de travar (hedge)
GET /api/v1/hedgeguarda por 15 sPreço teórico do dólar a termo para uma data, interpolado entre os vencimentos do dólar futuro (DOL) da B3, sobre o dólar à vista de referência de agora. Devolve o custo de travar hoje contra o à vista, a conferência pelo diferencial de juros (DI futuro × SOFR) com o cupom cambial implícito e cenários de +10%, +5%, 0, −5% e −10% com e sem a trava. Preço de mercado, sem spread de banco. Não recomenda nada.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| data | data AAAA-MM-DD | Data do pagamento ou recebimento em dólar (AAAA-MM-DD). Padrão: daqui a 90 dias. |
| valor_usd | número (ponto decimal), maior que 0 | Valor em dólares. Padrão: 10.000. |
| lado | um de: pagar, receber | Se a pessoa vai pagar ou receber dólares na data. Padrão: pagar. |
curl "https://mesadodolar.com.br/api/v1/hedge?valor_usd=50000&lado=pagar"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Fundos cambiais contra o dólar (PTAX)
GET /api/v1/fundos-cambiaisguarda por 1 hQuanto rendeu a cota dos fundos cambiais de dólar abertos à pessoa física (dados da CVM) em 1, 3, 6 e 12 meses, a mediana simples entre eles e a variação da PTAX de venda nas mesmas datas. A diferença é o que o fundo rendeu acima ou abaixo do próprio dólar: entra o cupom cambial (o juro em dólar das aplicações do fundo) e sai a taxa de administração. Em janela curta a diferença também mistura horário: a cota usa o dólar do fim do dia e a PTAX é calculada até as 13h. Lista os fundos por patrimônio, não por retorno. Ficam de fora fundos exclusivos ou de investidor profissional, de euro, com patrimônio abaixo de R$ 10 milhões, com menos de 20 cotistas (em geral fundo master) e os que andam ao contrário do dólar. Não é recomendação de investimento.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| limite | inteiro de 1 a 100 | Quantos fundos listar, do maior patrimônio para o menor. Padrão 20. |
curl "https://mesadodolar.com.br/api/v1/fundos-cambiais?limite=10"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Remessas: ranking do VET
GET /api/v1/remessasguarda por 1 hRanking mensal do Banco Central do valor efetivo total (VET, reais por dólar, já com taxa, tarifas e IOF) por instituição: dinheiro em espécie, cartão pré-pago ou transferência pessoal para os EUA, na compra ou na venda, do melhor para o pior para o cliente, com a distância para a PTAX média do mesmo mês. Publicado com cerca de 2 meses de atraso.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| opcao | um de: especie, cartao, remessa | especie, cartao (pré-pago) ou remessa (transferência para os EUA). Padrão: especie. |
| operacao | um de: compra, venda | compra (ou envio) de dólar pelo cliente, ou venda (ou recebimento). Padrão: compra. |
| valor_usd | um de: 100, 1000, 5000 | Faixa de valor da operação em US$: 100, 1000 ou 5000. Padrão: 1000. |
| mes | data AAAA-MM-DD | Mês de referência, no formato AAAA-MM-01. Padrão: o mais recente publicado. |
curl "https://mesadodolar.com.br/api/v1/remessas?opcao=remessa&operacao=compra&valor_usd=1000"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Remessas hoje: quanto chega por provedor
GET /api/v1/remessas-hojeguarda por 10 minPreço de agora de uma remessa internacional, por provedor, no comparador público da Wise (coletado a cada 30 minutos): câmbio, tarifa, quanto chega e a diferença para o câmbio médio (o câmbio comercial, sem margem, que a Wise informa). Dois sentidos: usd_brl (US$ 1.000 dos EUA para o Brasil, vários provedores) e brl_usd (R$ 5.000 do Brasil para os EUA, onde o comparador só traz a própria Wise). É diferente do ranking do VET do Banco Central (remessas_vet), que é a média do que cada instituição cobrou cerca de 2 meses atrás. Lista por quanto chega, sem indicar provedor. Não é recomendação.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| sentido | um de: usd_brl, brl_usd | usd_brl: enviar US$ 1.000 dos EUA para o Brasil. brl_usd: enviar R$ 5.000 do Brasil para os EUA. Padrão: usd_brl. |
curl "https://mesadodolar.com.br/api/v1/remessas-hoje?sentido=usd_brl"
Exemplo de resposta real (listas encurtadas)
{
"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-dolarguarda por 5 minQuanto sai em reais comprar um valor em dólar hoje em cada canal: dinheiro em espécie, cartão pré-pago, cartão de crédito ou débito no exterior e transferência para conta própria nos EUA. Conta: PTAX de venda mais recente × (VET ÷ PTAX média do mês do VET), pela mediana das instituições (só com 5 instituições ou mais na faixa; com menos, vem amostra_pequena no lugar) e pelas 3 de menor VET do ranking do Banco Central, separando o IOF de cada canal e o spread com tarifas, e a diferença para a PTAX "seca". O VET sai com cerca de 2 meses de atraso: é referência, não a cotação da instituição agora. Cartão de crédito não está no ranking do VET: vem só o piso (PTAX + IOF). Não é recomendação de investimento.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| valor_usd | número (ponto decimal), maior que 0 | Valor em dólares. Padrão: 1.000. |
curl "https://mesadodolar.com.br/api/v1/comprar-dolar?valor_usd=2000"
Exemplo de resposta real (listas encurtadas)
{
"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/viagemguarda por 5 minTotal em reais de uma viagem a partir de dias, gasto por dia em dólar e a parte em dinheiro em espécie (o resto no cartão): espécie e cartão pré-pago pela mediana do VET do Banco Central aplicada à PTAX de venda mais recente, cartão de crédito pelo piso PTAX + IOF, com o IOF separado. Traz a mesma conta com o dólar 5% abaixo e 5% acima no dia da compra (sensibilidade, não previsão). Não é recomendação de investimento.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| dias | inteiro de 1 a 365 | Dias de viagem. Padrão: 7. |
| gasto_dia_usd | número (ponto decimal), maior que 0 | Gasto por dia no destino, em US$. Padrão: 200. |
| especie_pct | inteiro de 0 a 100 | Parte do gasto levada em dinheiro em espécie, em % (o resto vai no cartão). Padrão: 30. |
curl "https://mesadodolar.com.br/api/v1/viagem?dias=7&gasto_dia_usd=200&especie_pct=30"
Exemplo de resposta real (listas encurtadas)
{
"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-corrigidoguarda por 1 hPTAX de venda de uma data desde 01/07/1994 (em fim de semana ou feriado, a do dia útil anterior, e avisa) e quanto um valor em dólares daquela data vale hoje em reais corrigidos pelo IPCA (série SGS 433 do BC, variação mensal do IBGE), até o último mês publicado. Traz o "dólar real": US$ 1 da data em reais de hoje, e a comparação com a PTAX mais recente. No mês da data entra só a parte dos dias restantes; os meses seguintes, inteiros. Sem spread, tarifa nem IOF. Não diz se o dólar está caro ou barato. Não é recomendação de investimento.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| data * | data AAAA-MM-DD | Data AAAA-MM-DD, de 1994-07-01 até hoje. |
| valor_usd | número (ponto decimal), maior que 0 | Valor em dólares. Padrão: 1. |
curl "https://mesadodolar.com.br/api/v1/dolar-corrigido?data=2002-10-22&valor_usd=1000"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}Glossário de câmbio
GET /api/v1/glossarioguarda por 1 diaExplicação em linguagem simples de termos de câmbio (PTAX, swap cambial, leilão de linha, cupom cambial, VET e outros). Sem termo, lista os disponíveis.
| Parâmetro | Aceita | Para quê |
|---|---|---|
| termo | texto (até 60 caracteres) | Identificador do termo, por exemplo "swap-cambial". |
curl "https://mesadodolar.com.br/api/v1/glossario?termo=ptax"
Exemplo de resposta real (listas encurtadas)
{
"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)"
}