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ímite | 60 solicitudes por minuto por dirección IP |
|---|---|
| Por encima del límite | HTTP 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ía | ninguna: 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.csvLa 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
TypedDatos > 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 sEl 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 minTasa 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ámetro | Acepta | Para qué |
|---|---|---|
| data | fecha AAAA-MM-DD | Fecha 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 minSerie 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ámetro | Acepta | Para qué |
|---|---|---|
| de * | fecha AAAA-MM-DD | Fecha inicial AAAA-MM-DD |
| ate * | fecha AAAA-MM-DD | Fecha 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 minResumen 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ámetro | Acepta | Para qué |
|---|---|---|
| ano * | entero de 1985 a 2100 | obligatorio |
| mes * | entero de 1 a 12 | obligatorio |
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 minLo 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ámetro | Acepta | Para qué |
|---|---|---|
| limite | entero de 1 a 100 | Cuá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 sCotizació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ámetro | Acepta | Para qué |
|---|---|---|
| contrato | uno de: DOL, WDO | De 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 sPrecio 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 hSaldo 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ámetro | Acepta | Para qué |
|---|---|---|
| periodo | uno de: semana, mes, ano | Agrupación. Por defecto: semana. |
| quantos | entero de 1 a 120 | Cuá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 hBalança comercial do Brasil por mês (exportação, importação e saldo, em US$ milhões FOB, do MDIC) ao lado do fluxo cambial comercial contratado no mesmo mês (Banco Central) e a diferença entre os dois. A balança conta a mercadoria quando passa pela alfândega; o câmbio pode ser fechado antes (adiantamento) ou meses depois, então a diferença é de registro e de prazo, não prova de dólar retido. O mês mais recente da balança sai nos primeiros dias úteis do mês seguinte.
| Parámetro | Acepta | Para qué |
|---|---|---|
| meses | entero de 1 a 48 | Quantos meses, do mais recente para trás. Padrão 12. |
curl "https://mesadodolar.com.br/api/v1/balanca?meses=6"
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ámetro | Acepta | Para qué |
|---|---|---|
| pontos | entero de 1 a 400 | Cuá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ámetro | Acepta | Para qué |
|---|---|---|
| codigo | uno de: reservas, swaps, linhas, selic, fluxo_total, fluxo_comercial, fluxo_financeiro | opcional |
| pontos | entero de 1 a 400 | Cuá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 hMediana 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 minRetrato 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 minCotizació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ámetro | Acepta | Para 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, HUF | Sigla ISO de la moneda (EUR, GBP, ARS...). Omitir para listar todas. |
| data | fecha AAAA-MM-DD | Fecha AAAA-MM-DD (necesita la moneda). Omitir para la más reciente. |
| valor | número (punto decimal), mayor que 0 | Valor a convertir (necesita la moneda). |
| de | uno de: moeda, BRL | Moneda 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 minSerie 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ámetro | Acepta | Para 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, HUF | Sigla ISO de la moneda (EUR, GBP, ARS...). |
| de * | fecha AAAA-MM-DD | Fecha inicial AAAA-MM-DD |
| ate * | fecha AAAA-MM-DD | Fecha 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 minConvierte 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ámetro | Acepta | Para qué |
|---|---|---|
| valor * | número (punto decimal), mayor que 0 | obligatorio |
| de * | uno de: USD, BRL | Moneda del monto informado |
| data | fecha AAAA-MM-DD | opcional |
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 minPró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ámetro | Acepta | Para qué |
|---|---|---|
| ate | fecha AAAA-MM-DD | Última fecha AAAA-MM-DD. Omitir para los próximos seis meses. |
| tipo | uno de: copom, fomc, payroll, cpi, ipca, focus, fluxo, ptax-mes, vencimento-dol, vencimento-linha, vencimento-swap, leilao | Solo un tipo de evento. |
| limite | entero de 1 a 100 | Má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 sPrecio 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ámetro | Acepta | Para qué |
|---|---|---|
| data | fecha AAAA-MM-DD | Fecha del pago o cobro en dólares (AAAA-MM-DD). Por defecto: dentro de 90 días. |
| valor_usd | número (punto decimal), mayor que 0 | Monto en dólares. Por defecto: 10.000. |
| lado | uno de: pagar, receber | Si 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 hCuá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ámetro | Acepta | Para qué |
|---|---|---|
| limite | entero de 1 a 100 | Cuá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 hRanking 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ámetro | Acepta | Para qué |
|---|---|---|
| opcao | uno de: especie, cartao, remessa | especie (efectivo), cartao (prepaga) o remessa (transferencia a EE. UU.). Por defecto: especie. |
| operacao | uno de: compra, venda | compra (o envío) de dólares por el cliente, o venda (o cobro). Por defecto: compra. |
| valor_usd | uno de: 100, 1000, 5000 | Rango de monto de la operación en US$: 100, 1000 o 5000. Por defecto: 1000. |
| mes | fecha AAAA-MM-DD | Mes 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 minPrecio 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ámetro | Acepta | Para qué |
|---|---|---|
| sentido | uno de: usd_brl, brl_usd | usd_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 minCuá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ámetro | Acepta | Para qué |
|---|---|---|
| valor_usd | número (punto decimal), mayor que 0 | Monto 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 minTotal 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ámetro | Acepta | Para qué |
|---|---|---|
| dias | entero de 1 a 365 | Días de viaje. Por defecto: 7. |
| gasto_dia_usd | número (punto decimal), mayor que 0 | Gasto diario en el destino, en US$. Por defecto: 200. |
| especie_pct | entero de 0 a 100 | Parte 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 hPTAX 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ámetro | Acepta | Para qué |
|---|---|---|
| data * | fecha AAAA-MM-DD | Fecha AAAA-MM-DD, del 1994-07-01 a hoy. |
| valor_usd | número (punto decimal), mayor que 0 | Monto 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íaExplicació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ámetro | Acepta | Para qué |
|---|---|---|
| termo | texto (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)"
}