Ir al contenido
Mercado cerrado (feriado) · vie, 20/11 · 12:28 de Brasilia

API pública de Mesa do Dólar

Los mismos datos del portal en JSON, para planillas, sistemas y sitios. Gratuita, sin clave y solo de lectura.

Cómo usarla

Haga un GET en cualquier dirección de abajo. La lista completa, legible por máquina, está en /api/v1 y el documento OpenAPI en /api/v1/openapi.json.

Toda respuesta trae dados (el resultado), fonte, atualizado_em (fecha o momento del dato) y el aviso de que no es una recomendación. Los errores vuelven en JSON, con erro.mensagem en portugués, y el código HTTP correspondiente (400 parámetro inválido, 404 sin dato, 429 por encima del límite).

Los datos son los mismos de las herramientas del MCP de la Mesa y del chat: lo que responde la API es lo que muestra el portal.

Reglas de uso

Límite60 solicitudes por minuto por dirección IP
Por encima del límiteHTTP 429, con Retry-After de 60 s
Navegador (CORS)permitido para GET desde cualquier sitio
Atribución“Fuente: Mesa do Dólar” con enlace a mesadodolar.com.br
Garantíaninguna: dato público, puede atrasarse o faltar

Cada respuesta indica por cuánto tiempo puede guardarse (encabezado Cache-Control): de 2 s para el precio de ahora a 1 día para la PTAX de fechas pasadas. Respete ese tiempo antes de volver a consultar. Dato público para consulta, sin garantía. No es una recomendación de inversión.

Widget de cotización

Para mostrar el dólar al contado en su sitio sin programar, use el widget de cotización: un iframe listo para copiar. También existe la variante PTAX del día, estable, para blogs y sitios contables.

PTAX del mes en CSV, directo en la hoja de cálculo

GET /api/v1/ptax/mes.csv

La PTAX de compra y de venta de cada día hábil de un mes, en CSV, para Excel, Hojas de cálculo de Google y sistemas contables. La primera línea del archivo ya es el encabezado, así que la hoja lee las columnas sin ajustes. La fuente (Banco Central de Brasil) y el último día con datos vienen en los encabezados HTTP X-Fonte y X-Dados-Ate. Parámetros: ano y mes (obligatorios) y idioma (opcional): es y pt con punto y coma entre columnas, coma decimal y fecha dd/mm/aaaa; en con coma entre columnas, punto decimal y fecha AAAA-MM-DD. El archivo descargado se llama ptax-AAAA-MM.csv. Mismo límite de solicitudes que la API en JSON.

Hojas de cálculo de Google

=IMPORTDATA("https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10&idioma=es"; ";"; "es_ES")

Péguelo en una celda vacía. La hoja busca el CSV y se actualiza sola cada cierto tiempo; el tercer argumento indica que la coma es la decimal.

Excel (Power Query)

let
    Source = Csv.Document(Web.Contents("https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10&idioma=es"), [Delimiter=";", Encoding=65001]),
    Ptax = Table.PromoteHeaders(Source),
    Typed = Table.TransformColumnTypes(Ptax, {{"fecha", type date}, {"compra", type number}, {"venta", type number}}, "es-ES")
in
    Typed

Datos > Obtener datos > De otras fuentes > Consulta en blanco; abra el Editor avanzado, pegue el código y haga clic en Listo. Para actualizar, Datos > Actualizar todo.

En la línea de comandos

curl -o ptax-2026-10.csv "https://mesadodolar.com.br/api/v1/ptax/mes.csv?ano=2026&mes=10&idioma=es"

Dólar al contado ahora

GET /api/v1/cotacaose guarda por 2 s

El dólar al contado de la parte superior del portal (R$ por US$). Con la sesión de B3 abierta (días hábiles, de 9:00 a 18:30, hora de Brasilia) es una estimación en tiempo real: el contado de B3 (dólar futuro menos el diferencial contado-futuro, que llega con 15 minutos de retraso) corregido por el movimiento del dólar digital en esos 15 minutos. Con la sesión cerrada (noche, fin de semana, feriado) es el cierre de la última sesión, fijo, con la fecha en fechamento_data; el dólar digital, que opera las 24 horas, viene aparte como referencia. Trae la variación y dice contra qué se midió. No es la PTAX. Pregunta sobre USDT, USDC o la distancia entre el dólar digital y el spot va con dolar_digital, no con esta.

Sin parámetros.

curl "https://mesadodolar.com.br/api/v1/cotacao"
Ejemplo de respuesta real (listas acortadas)
{
  "dados": {
    "preco": 5.9292,
    "momento": "2026-11-19T21:44:55.000Z",
    "pregao": "fechado",
    "fechamento_data": "2026-11-19",
    "tipo": "fechamento do último pregão",
    "variacao_pct": 0.68,
    "variacao_base": "PTAX de venda de 2026-11-19 (ainda não há fechamento anterior do dólar à vista gravado)",
    "fechamento_anterior": null,
    "fechamento_anterior_data": null,
    "b3_atrasado": null,
    "dolar_digital_24h": {
      "preco": 6.0124,
      "momento": "2026-11-20T15:28:22.243Z",
      "observacao": "USDT em reais. Negocia 24 horas; é referência fora do pregão, não o dólar à vista. Para o detalhe do dólar digital, use dolar_digital."
    },
    "idade_segundos": 63807,
    "observacao": "Mercado fechado: o preço é o fechamento do último pregão da B3 e não muda até a próxima abertura. Dólar à vista, não é a PTAX. Não é recomendação de investimento.",
    "fonte": "B3 (dólar futuro menos o casado)"
  },
  "fonte": "B3 (dólar futuro menos o casado)",
  "atualizado_em": "2026-11-19T21:44:55.000Z",
  "aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
  "atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}

PTAX de una fecha

GET /api/v1/ptaxse guarda por 1 min

Tasa PTAX de compra y de venta del dólar (R$ por US$) publicada por el Banco Central de Brasil. Sin fecha, devuelve la más reciente. En fin de semana o feriado devuelve la del día hábil anterior y lo avisa.

ParámetroAceptaPara qué
datafecha AAAA-MM-DDFecha AAAA-MM-DD. Omitir para la más reciente.
curl "https://mesadodolar.com.br/api/v1/ptax?data=2026-10-30"
Ejemplo de respuesta real (listas acortadas)
{
  "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 en un período

GET /api/v1/ptax/periodose guarda por 5 min

Serie diaria de la PTAX de compra y venta entre dos fechas. Máximo de 400 días hábiles por llamada (unos 19 meses); para períodos mayores, haga más de una llamada.

ParámetroAceptaPara qué
de *fecha AAAA-MM-DDFecha inicial AAAA-MM-DD
ate *fecha AAAA-MM-DDFecha final AAAA-MM-DD
curl "https://mesadodolar.com.br/api/v1/ptax/periodo?de=2026-10-01&ate=2026-10-31"
Ejemplo de respuesta real (listas acortadas)
{
  "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 un mes

GET /api/v1/ptax/messe guarda por 5 min

Resumen de la PTAX de venta de un mes: promedio mensual, tasa del último día hábil, máxima y mínima. Es la consulta usada en cierres contables y en contratos.

ParámetroAceptaPara qué
ano *entero de 1985 a 2100obligatorio
mes *entero de 1 a 12obligatorio
curl "https://mesadodolar.com.br/api/v1/ptax/mes?ano=2026&mes=10"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Intervenciones y subastas del Banco Central

GET /api/v1/atuacoesse guarda por 1 min

Lo que hizo el Banco Central de Brasil en el mercado cambiario: subastas de cambio leídas de los comunicados del día (fecha, tope, monto aceptado, tasa de corte) y cambios en los saldos de líneas y de swap cambiario, en la fecha de liquidación o vencimiento. Volumen en millones de US$; negativo es vencimiento.

ParámetroAceptaPara qué
limiteentero de 1 a 100Cuántas intervenciones, de la más reciente hacia atrás. Por defecto 20.
curl "https://mesadodolar.com.br/api/v1/atuacoes?limite=5"
Ejemplo de respuesta real (listas acortadas)
{
  "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 en B3

GET /api/v1/futurose guarda por 15 s

Cotización del dólar futuro en B3: el vencimiento más negociado (precio, variación sobre el ajuste anterior), el volumen de la sesión sumando el contrato lleno (DOL) y el mini (WDO) y la lista de vencimientos con contratos negociados y abiertos. Precios en reales por dólar. La cotización pública de B3 llega con 15 minutos de retraso.

ParámetroAceptaPara qué
contratouno de: DOL, WDODe qué contrato listar los vencimientos. Por defecto: DOL (lleno, US$ 50.000).
curl "https://mesadodolar.com.br/api/v1/futuro?contrato=WDO"
Ejemplo de respuesta real (listas acortadas)
{
  "dados": {
    "mais_negociado": {
      "simbolo": "DOLZ26",
      "vencimento": "2026-12-01",
      "preco": 5.952,
      "ajuste_anterior": 5.924052,
      "variacao_sobre_ajuste_pct": 0.47,
      "consultado_em": "2026-11-20T15:28:20.000Z"
    },
    "volume_do_pregao": {
      "contratos_dol": 361900,
      "contratos_wdo": 4912549,
      "financeiro_brl": 397256100060,
      "nocional_usd": 67220490000
    },
    "contrato": "WDO",
    "tamanho_do_contrato_usd": 10000,
    "vencimentos": [
      {
        "simbolo": "WDOZ26",
        "vencimento": "2026-12-01",
        "ultimo": 5.9515,
        "ajuste_anterior": 5.924052,
        "minimo": 5.868,
        "maximo": 5.9695,
        "contratos_hoje": 4894617,
        "contratos_em_aberto": 1812744,
        "ultimo_negocio_em": "2026-11-19T21:29:00.000Z",
        "ultimo_negocio_antigo": false
      },
      {
        "simbolo": "WDOF27",
        "vencimento": "2027-01-04",
        "ultimo": 5.9855,
        "ajuste_anterior": 5.957353,
        "minimo": 5.902,
        "maximo": 6.0025,
        "contratos_hoje": 17508,
        "contratos_em_aberto": 9119,
        "ultimo_negocio_em": "2026-11-19T21:29:00.000Z",
        "ultimo_negocio_antigo": false
      },
      "… mais 5 itens"
    ],
    "observacao": "A cotação pública da B3 chega com 15 minutos de atraso. Vencimento com ultimo_negocio_antigo = true está parado há mais de 30 minutos no pregão: o \"ultimo\" é o preço daquele negócio, não o de agora, e não se compara com o de outro vencimento. Não é recomendação de investimento.",
    "fonte": "B3, consulta pública de cotações"
  },
  "fonte": "B3, consulta pública de cotações",
  "atualizado_em": "2026-11-20T15:28:20.000Z",
  "aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
  "atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}

Dólar digital (USDT y USDC)

GET /api/v1/digitalse guarda por 2 s

Precio en reales de las stablecoins de dólar (USDT y USDC) en exchanges, con variación y volumen de las últimas 24 horas y la distancia al dólar al contado de B3. Mercado abierto 24 horas, incluso fines de semana; el precio se actualiza cada 2 segundos.

Sin parámetros.

curl "https://mesadodolar.com.br/api/v1/digital"
Ejemplo de respuesta real (listas acortadas)
{
  "dados": {
    "usdt_brl": {
      "preco": 6.0124,
      "compra": 6.0123,
      "venda": 6.0124,
      "variacao_24h_pct": 1.97,
      "consultado_em": "2026-11-20T15:28:20.286Z"
    },
    "volume_24h_brl": 501475725,
    "corretoras": [
      {
        "corretora": "Binance",
        "preco": 6.0124,
        "volume_24h_brl": 422177937
      },
      {
        "corretora": "Foxbit",
        "preco": 6.0135,
        "volume_24h_brl": 79297788
      }
    ],
    "usdc_brl": {
      "preco": 6.0185,
      "variacao_24h_pct": 1.94
    },
    "dolar_a_vista_b3": 5.9412,
    "distancia_para_o_a_vista_pct": 1.2,
    "distancia_observacao": "USDT de 15 minutos atrás comparado com a cotação da B3 que chega agora, para os dois preços serem do mesmo instante.",
    "observacao": "USDT e USDC são criptoativos que buscam valer um dólar; não são dólar em conta nem têm garantia do Banco Central. A cotação da B3 chega com 15 minutos de atraso, então parte da distância é só esse atraso. Não é recomendação de investimento.",
    "fonte": "Binance e Foxbit, consultas públicas"
  },
  "fonte": "Binance e Foxbit, consultas públicas",
  "atualizado_em": "2026-11-20T15:28:20.286Z",
  "aviso": "Dado público para consulta, sem garantia. Não é recomendação de investimento.",
  "atribuicao": "Fonte: Mesa do Dólar (https://mesadodolar.com.br)"
}

Flujo cambiario

GET /api/v1/fluxose guarda por 1 h

Saldo del cambio contratado en Brasil (entrada menos salida de dólares), separado en comercial y financiero, sumado por semana, mes o año, y el acumulado del año hasta el último día publicado frente al año anterior hasta la misma fecha. Millones de US$; positivo es entrada neta. El Banco Central publica los días en lote, con alrededor de una semana de retraso.

ParámetroAceptaPara qué
periodouno de: semana, mes, anoAgrupación. Por defecto: semana.
quantosentero de 1 a 120Cuántos períodos, del más reciente hacia atrás. Por defecto 12.
curl "https://mesadodolar.com.br/api/v1/fluxo?periodo=mes&quantos=6"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Balanza comercial y flujo cambiario comercial

GET /api/v1/balancase guarda 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ámetroAceptaPara qué
mesesentero de 1 a 48Quantos meses, do mais recente para trás. Padrão 12.
curl "https://mesadodolar.com.br/api/v1/balanca?meses=6"
Ejemplo de respuesta real (listas acortadas)
{
  "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 internacionales

GET /api/v1/reservasse guarda por 1 h

Últimos valores de una serie: "reservas" (reservas internacionales), "swaps" (saldo de swap cambiario), "linhas" (saldo de líneas con recompra), todas en millones de US$, "selic" (meta, % anual) y el flujo cambiario diario en millones de US$ ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positivo es entrada neta). Sin código, lista las series disponibles.

ParámetroAceptaPara qué
pontosentero de 1 a 400Cuántos valores, del más reciente hacia atrás. Por defecto 30.
curl "https://mesadodolar.com.br/api/v1/reservas?pontos=5"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Series del Banco Central

GET /api/v1/seriese guarda por 1 h

Últimos valores de una serie: "reservas" (reservas internacionales), "swaps" (saldo de swap cambiario), "linhas" (saldo de líneas con recompra), todas en millones de US$, "selic" (meta, % anual) y el flujo cambiario diario en millones de US$ ("fluxo_total", "fluxo_comercial", "fluxo_financeiro"; positivo es entrada neta). Sin código, lista las series disponibles.

ParámetroAceptaPara qué
codigouno de: reservas, swaps, linhas, selic, fluxo_total, fluxo_comercial, fluxo_financeiroopcional
pontosentero de 1 a 400Cuántos valores, del más reciente hacia atrás. Por defecto 30.
curl "https://mesadodolar.com.br/api/v1/serie?codigo=swaps&pontos=5"
Ejemplo de respuesta real (listas acortadas)
{
  "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: proyección del dólar

GET /api/v1/focusse guarda por 1 h

Mediana de la proyección del dólar para el fin de cada año en el boletín Focus del Banco Central de Brasil (encuesta semanal a bancos, gestoras y consultoras), con la mínima, la máxima y el número de respuestas. R$ por US$.

Sin parámetros.

curl "https://mesadodolar.com.br/api/v1/focus"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Lectura del día y panorama

GET /api/v1/leiturase guarda por 5 min

Retrato actual del dólar en Brasil con datos oficiales: última PTAX, variaciones, volatilidad, máxima y mínima de 12 meses, reservas, saldos de swap y de líneas, Selic, Focus y la lectura automática de Mesa do Dólar (sesgo, factores al alza y a la baja, niveles y probabilidad de intervención del Banco Central).

Sin parámetros.

curl "https://mesadodolar.com.br/api/v1/leitura"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Otras monedas en reales

GET /api/v1/moedasse guarda por 5 min

Cotización de cierre del Banco Central de Brasil en reales (R$ por unidad, compra y venta) del euro, libra, yen, franco suizo, dólares canadiense y australiano, coronas danesa, noruega y sueca (estas nueve con PTAX propia), pesos argentino, mexicano, chileno y colombiano, sol peruano, yuan, rupias india e indonesia, won, rand, lira turca, esloti y forinto (tasa de cierre: PTAX del dólar cruzada con la paridad). Sin moneda, lista todas en el último cierre con la variación en el día y en 20 días hábiles. Con moneda, trae la cotización más reciente (o la de una fecha; sin cotización ese día, vale la del día hábil anterior), la variación en 1, 5 y 20 días hábiles, la paridad frente al dólar y la hora del boletín. Con valor, convierte por la tasa de venta en los dos sentidos, sin spread, comisión ni IOF. Historial desde 2000.

ParámetroAceptaPara qué
moedauno de: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUFSigla ISO de la moneda (EUR, GBP, ARS...). Omitir para listar todas.
datafecha AAAA-MM-DDFecha AAAA-MM-DD (necesita la moneda). Omitir para la más reciente.
valornúmero (punto decimal), mayor que 0Valor a convertir (necesita la moneda).
deuno de: moeda, BRLMoneda del valor informado: "moeda" (la sigla pedida) o "BRL". Por defecto "moeda".
curl "https://mesadodolar.com.br/api/v1/moedas?moeda=EUR"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Una moneda en un período

GET /api/v1/moedas/periodose guarda por 5 min

Serie diaria de la cotización de cierre del Banco Central de Brasil de una moneda en reales (compra, venta y unidades por US$ 1) entre dos fechas, desde 2000. Hasta 400 días hábiles por llamada; para períodos más largos, haga más de una llamada.

ParámetroAceptaPara qué
moeda *uno de: EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK, ARS, MXN, CLP, COP, PEN, CNY, INR, IDR, KRW, ZAR, TRY, PLN, HUFSigla ISO de la moneda (EUR, GBP, ARS...).
de *fecha AAAA-MM-DDFecha inicial AAAA-MM-DD
ate *fecha AAAA-MM-DDFecha final AAAA-MM-DD
curl "https://mesadodolar.com.br/api/v1/moedas/periodo?moeda=ARS&de=2026-10-01&ate=2026-10-31"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Convertir por la PTAX

GET /api/v1/converterse guarda por 5 min

Convierte un monto entre dólar y real por la PTAX de venta de una fecha (o la más reciente). No incluye spread, comisiones ni IOF: lo que cobran bancos y casas de cambio es mayor.

ParámetroAceptaPara qué
valor *número (punto decimal), mayor que 0obligatorio
de *uno de: USD, BRLMoneda del monto informado
datafecha AAAA-MM-DDopcional
curl "https://mesadodolar.com.br/api/v1/converter?valor=1000&de=USD"
Ejemplo de respuesta real (listas acortadas)
{
  "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 del dólar

GET /api/v1/agendase guarda por 5 min

Próximos eventos que pueden mover el dólar: decisiones del Copom y de la Fed, payroll y CPI de EE. UU., IPCA, Focus, flujo cambiario, PTAX de fin de mes, vencimiento del dólar futuro en B3, recompras de líneas y subastas ya anunciadas por el Banco Central. Fechas de calendarios oficiales, hora de Brasilia, cada evento con su fuente. Filtra por tipo y por fecha final.

ParámetroAceptaPara qué
atefecha AAAA-MM-DDÚltima fecha AAAA-MM-DD. Omitir para los próximos seis meses.
tipouno de: copom, fomc, payroll, cpi, ipca, focus, fluxo, ptax-mes, vencimento-dol, vencimento-linha, vencimento-swap, leilaoSolo un tipo de evento.
limiteentero de 1 a 100Máximo de eventos (por defecto 30).
curl "https://mesadodolar.com.br/api/v1/agenda?tipo=copom&limite=5"
Ejemplo de respuesta real (listas acortadas)
{
  "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 plazo y costo de fijarlo (cobertura)

GET /api/v1/hedgese guarda por 15 s

Precio teórico del dólar a plazo para una fecha, interpolado entre los vencimientos del dólar futuro (DOL) de B3, sobre el dólar al contado de referencia de ahora. Devuelve el costo de fijar hoy frente al contado, la verificación por el diferencial de tasas (DI futuro × SOFR) con el cupón cambiario implícito y escenarios de +10%, +5%, 0, −5% y −10% con y sin cobertura. Precio de mercado, sin spread bancario. No recomienda nada.

ParámetroAceptaPara qué
datafecha AAAA-MM-DDFecha del pago o cobro en dólares (AAAA-MM-DD). Por defecto: dentro de 90 días.
valor_usdnúmero (punto decimal), mayor que 0Monto en dólares. Por defecto: 10.000.
ladouno de: pagar, receberSi la persona va a pagar o recibir dólares en la fecha. Por defecto: pagar.
curl "https://mesadodolar.com.br/api/v1/hedge?valor_usd=50000&lado=pagar"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Fondos cambiarios frente al dólar (PTAX)

GET /api/v1/fundos-cambiaisse guarda por 1 h

Cuánto rindió la cuota de los fondos cambiarios de dólar de Brasil abiertos a personas físicas (datos de la CVM) en 1, 3, 6 y 12 meses, la mediana simple entre ellos y la variación de la PTAX de venta en las mismas fechas. La diferencia es lo que el fondo rindió por encima o por debajo del propio dólar: suma el cupón cambiario (el interés en dólares de las inversiones del fondo) y resta la comisión de administración. En ventanas cortas la diferencia también mezcla horarios: la cuota usa el dólar del cierre del día y la PTAX se calcula hasta las 13 h. Lista los fondos por patrimonio, no por rendimiento. Quedan fuera los fondos exclusivos o de inversor profesional, los de euro, los de menos de R$ 10 millones de patrimonio, los de menos de 20 cuotistas (en general, fondo master) y los que se mueven al revés del dólar. No es recomendación de inversión.

ParámetroAceptaPara qué
limiteentero de 1 a 100Cuántos fondos listar, del mayor patrimonio al menor. Por defecto: 20.
curl "https://mesadodolar.com.br/api/v1/fundos-cambiais?limite=10"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Remesas: ranking del VET

GET /api/v1/remessasse guarda por 1 h

Ranking mensual del Banco Central de Brasil del valor efectivo total (VET, reales por dólar, ya con tasa, comisiones e IOF) por institución: efectivo, tarjeta prepaga o transferencia personal a EE. UU., en la compra o en la venta, del mejor al peor para el cliente, con la distancia a la PTAX promedio del mismo mes. Se publica con unos 2 meses de retraso.

ParámetroAceptaPara qué
opcaouno de: especie, cartao, remessaespecie (efectivo), cartao (prepaga) o remessa (transferencia a EE. UU.). Por defecto: especie.
operacaouno de: compra, vendacompra (o envío) de dólares por el cliente, o venda (o cobro). Por defecto: compra.
valor_usduno de: 100, 1000, 5000Rango de monto de la operación en US$: 100, 1000 o 5000. Por defecto: 1000.
mesfecha AAAA-MM-DDMes de referencia, en formato AAAA-MM-01. Por defecto: el más reciente publicado.
curl "https://mesadodolar.com.br/api/v1/remessas?opcao=remessa&operacao=compra&valor_usd=1000"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Remesas hoy: cuánto llega por proveedor

GET /api/v1/remessas-hojese guarda por 10 min

Precio de ahora de una remesa internacional, por proveedor, en el comparador público de Wise (recolectado cada 30 minutos): tipo de cambio, comisión, cuánto llega y la diferencia frente al tipo de cambio medio (el cambio sin margen que informa Wise). Dos sentidos: usd_brl (US$ 1.000 de EE. UU. a Brasil, varios proveedores) y brl_usd (R$ 5.000 de Brasil a EE. UU., donde el comparador solo trae a la propia Wise). No es el ranking del VET del Banco Central de Brasil (remessas_vet), que es el promedio de lo que cobró cada institución hace unos 2 meses. Ordenado por cuánto llega, sin señalar proveedor. No es una recomendación.

ParámetroAceptaPara qué
sentidouno de: usd_brl, brl_usdusd_brl: enviar US$ 1.000 de EE. UU. a Brasil. brl_usd: enviar R$ 5.000 de Brasil a EE. UU. Predeterminado: usd_brl.
curl "https://mesadodolar.com.br/api/v1/remessas-hoje?sentido=usd_brl"
Ejemplo de respuesta real (listas acortadas)
{
  "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-dolarse guarda por 5 min

Cuánto cuesta en reales comprar un monto en dólares hoy por cada canal: efectivo, tarjeta prepaga, tarjeta de crédito o débito en el exterior y transferencia a una cuenta propia en EE. UU. Cálculo: PTAX de venta más reciente × (VET ÷ PTAX promedio del mes del VET), por la mediana de las instituciones y las 3 de menor VET del ranking del Banco Central de Brasil, separando el IOF de cada canal y el spread con comisiones, y la diferencia con la PTAX "seca". El VET sale con unos 2 meses de retraso: es referencia, no la cotización de la institución ahora. La tarjeta de crédito no está en el ranking del VET: solo se da el piso (PTAX + IOF). No es una recomendación de inversión.

ParámetroAceptaPara qué
valor_usdnúmero (punto decimal), mayor que 0Monto en dólares. Por defecto: 1.000.
curl "https://mesadodolar.com.br/api/v1/comprar-dolar?valor_usd=2000"
Ejemplo de respuesta real (listas acortadas)
{
  "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/viagemse guarda por 5 min

Total en reales de un viaje a partir de días, gasto diario en dólares y la parte llevada en efectivo (el resto con tarjeta): efectivo y tarjeta prepaga por la mediana del VET del Banco Central aplicada a la PTAX de venta más reciente, tarjeta de crédito por el piso PTAX + IOF, con el IOF separado. Incluye el mismo cálculo con el dólar 5% más bajo y 5% más alto el día de la compra (sensibilidad, no previsión). No es una recomendación de inversión.

ParámetroAceptaPara qué
diasentero de 1 a 365Días de viaje. Por defecto: 7.
gasto_dia_usdnúmero (punto decimal), mayor que 0Gasto diario en el destino, en US$. Por defecto: 200.
especie_pctentero de 0 a 100Parte del gasto llevada en efectivo, en % (el resto con tarjeta). Por defecto: 30.
curl "https://mesadodolar.com.br/api/v1/viagem?dias=7&gasto_dia_usd=200&especie_pct=30"
Ejemplo de respuesta real (listas acortadas)
{
  "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-corrigidose guarda por 1 h

PTAX de venta de una fecha desde el 1994-07-01 (en fin de semana o feriado, la del día hábil anterior, con aviso) y cuánto vale hoy un monto en dólares de esa fecha en reales corregidos por el IPCA (serie SGS 433 del Banco Central, variación mensual del IBGE), hasta el último mes publicado. Incluye el “dólar real”: US$ 1 de la fecha en reales de hoy, comparado con la PTAX más reciente. En el mes de la fecha entra solo la parte de los días restantes; los meses siguientes, completos. Sin spread, comisiones ni IOF. No dice si el dólar está caro o barato. No es recomendación de inversión.

ParámetroAceptaPara qué
data *fecha AAAA-MM-DDFecha AAAA-MM-DD, del 1994-07-01 a hoy.
valor_usdnúmero (punto decimal), mayor que 0Monto en dólares. Por defecto: 1.
curl "https://mesadodolar.com.br/api/v1/dolar-corrigido?data=2002-10-22&valor_usd=1000"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}

Glosario de cambio

GET /api/v1/glossariose guarda por 1 día

Explicación en lenguaje sencillo de términos de cambio (PTAX, swap cambiario, subasta de líneas, cupón cambiario, VET y otros). Sin término, lista los disponibles.

ParámetroAceptaPara qué
termotexto (hasta 60 caracteres)Identificador del término, por ejemplo "swap-cambial".
curl "https://mesadodolar.com.br/api/v1/glossario?termo=ptax"
Ejemplo de respuesta real (listas acortadas)
{
  "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)"
}
El parámetro marcado con * es obligatorio. Fechas en AAAA-MM-DD; números con punto decimal; precios en R$ por US$ y saldos en millones de US$.