Pular para o conteúdo
Mercado fechado (feriado) · sex, 20/11 · 12h16

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

Limite60 requisições por minuto por endereço IP
Acima do limiteHTTP 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
Garantianenhuma: 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.csv

A 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
    Typed

Dados > 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 s

O 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 min

Taxa 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âmetroAceitaPara quê
datadata AAAA-MM-DDData 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 min

Sé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âmetroAceitaPara quê
de *data AAAA-MM-DDData inicial AAAA-MM-DD
ate *data AAAA-MM-DDData 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 min

Resumo 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âmetroAceitaPara quê
ano *inteiro de 1985 a 2100obrigatório
mes *inteiro de 1 a 12obrigató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 min

O 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âmetroAceitaPara quê
limiteinteiro de 1 a 100Quantas 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 s

Cotaçã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âmetroAceitaPara quê
contratoum de: DOL, WDOLista 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 s

Preç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 h

Saldo 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âmetroAceitaPara quê
periodoum de: semana, mes, anoAgrupamento. Padrão: semana.
quantosinteiro de 1 a 120Quantos 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 h

Balanç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âmetroAceitaPara quê
mesesinteiro de 1 a 48Quantos 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âmetroAceitaPara quê
pontosinteiro de 1 a 400Quantos 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âmetroAceitaPara quê
codigoum de: reservas, swaps, linhas, selic, fluxo_total, fluxo_comercial, fluxo_financeiroopcional
pontosinteiro de 1 a 400Quantos 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 h

Mediana 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 min

Retrato 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 min

Cotaçã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âmetroAceitaPara quê
moedaum de: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUFSigla ISO da moeda (EUR, GBP, ARS...). Omitir para listar todas.
datadata AAAA-MM-DDData AAAA-MM-DD (precisa da moeda). Omitir para a mais recente.
valornúmero (ponto decimal), maior que 0Valor a converter (precisa da moeda).
deum de: moeda, BRLMoeda 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 min

Sé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âmetroAceitaPara 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, HUFSigla ISO da moeda (EUR, GBP, ARS...).
de *data AAAA-MM-DDData inicial AAAA-MM-DD
ate *data AAAA-MM-DDData 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 min

Converte 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âmetroAceitaPara quê
valor *número (ponto decimal), maior que 0obrigatório
de *um de: USD, BRLMoeda do valor informado
datadata AAAA-MM-DDopcional
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 min

Pró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âmetroAceitaPara quê
atedata AAAA-MM-DDÚltima data AAAA-MM-DD. Omitir para os próximos seis meses.
tipoum de: copom, fomc, payroll, cpi, ipca, focus, fluxo, ptax-mes, vencimento-dol, vencimento-linha, vencimento-swap, leilaoSó um tipo de evento.
limiteinteiro de 1 a 100Má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 s

Preç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âmetroAceitaPara quê
datadata AAAA-MM-DDData do pagamento ou recebimento em dólar (AAAA-MM-DD). Padrão: daqui a 90 dias.
valor_usdnúmero (ponto decimal), maior que 0Valor em dólares. Padrão: 10.000.
ladoum de: pagar, receberSe 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 h

Quanto 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âmetroAceitaPara quê
limiteinteiro de 1 a 100Quantos 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 h

Ranking 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âmetroAceitaPara quê
opcaoum de: especie, cartao, remessaespecie, cartao (pré-pago) ou remessa (transferência para os EUA). Padrão: especie.
operacaoum de: compra, vendacompra (ou envio) de dólar pelo cliente, ou venda (ou recebimento). Padrão: compra.
valor_usdum de: 100, 1000, 5000Faixa de valor da operação em US$: 100, 1000 ou 5000. Padrão: 1000.
mesdata AAAA-MM-DDMê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 min

Preç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âmetroAceitaPara quê
sentidoum de: usd_brl, brl_usdusd_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 min

Quanto 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âmetroAceitaPara quê
valor_usdnúmero (ponto decimal), maior que 0Valor 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 min

Total 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âmetroAceitaPara quê
diasinteiro de 1 a 365Dias de viagem. Padrão: 7.
gasto_dia_usdnúmero (ponto decimal), maior que 0Gasto por dia no destino, em US$. Padrão: 200.
especie_pctinteiro de 0 a 100Parte 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 h

PTAX 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âmetroAceitaPara quê
data *data AAAA-MM-DDData AAAA-MM-DD, de 1994-07-01 até hoje.
valor_usdnúmero (ponto decimal), maior que 0Valor 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 dia

Explicaçã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âmetroAceitaPara quê
termotexto (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)"
}
Parâmetro marcado com * é obrigatório. Datas em AAAA-MM-DD; números com ponto decimal; valores de preço em R$ por US$ e estoques em US$ milhões.