Análise · compare_returns

Quem rendeu mais?

Quem rendeu mais entre duas datas: CDI ou dólar? Mostra quanto um valor em reais virou em cada um, o retorno nominal e real, e se o vencedor ganhou ou perdeu da inflação (IPCA) no período.

Parâmetros

Nome	Tipo	Obrigatório	Limites	Descrição
`amount`	number	sim	Maior que 0 e até 1.000.000.000	Valor aplicado, em R$.
`startDate`	string	sim	YYYY-MM ou YYYY-MM-DD, a partir de 1995-01	Mês inicial.
`endDate`	string	não	YYYY-MM ou YYYY-MM-DD; padrão: mês atual	Mês final.

Schema JSON (tools/list)

{
  "type": "object",
  "properties": {
    "amount": {
      "description": "Amount in BRL, > 0 and <= 1,000,000,000.",
      "type": "number"
    },
    "startDate": {
      "description": "Start month, YYYY-MM or YYYY-MM-DD (from 1995-01).",
      "type": "string"
    },
    "endDate": {
      "description": "End month, YYYY-MM or YYYY-MM-DD; defaults to the current month.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "amount",
    "startDate"
  ]
}

Exemplo de requisição

JSON-RPC 2.0 via POST https://mcp.financialcloud.com.br (Streamable HTTP, sem autenticação).

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "compare_returns",
    "arguments": {
      "amount": 10000,
      "startDate": "2021-01"
    }
  }
}

Exemplo de resposta

Exemplo de resposta real (2026-10-14). O campo analysis vem primeiro; data traz só os números de apoio.

{
  "analysis": "Entre 2021-01 e 2026-10, o CDI foi a melhor opção e ganhou da inflação: R$ 10.000,00 viraram R$ 18.621,67 (86,22% nominal, 34,89% real). A inflação (IPCA) acumulada no período foi de 38,05%. O USD ficou atrás, com -33,73% real.",
  "signal": "vencedor:CDI",
  "data": {
    "amount": 10000,
    "startMonth": "2021-01",
    "endMonth": "2026-10",
    "winner": "CDI",
    "inflationPct": 38.05,
    "results": [
      {
        "asset": "CDI",
        "finalAmount": 18621.67,
        "returnPct": 86.22,
        "realReturnPct": 34.89
      },
      {
        "asset": "IPCA",
        "finalAmount": 13805.4,
        "returnPct": 38.05
      },
      {
        "asset": "USD",
        "finalAmount": 9148.45,
        "returnPct": -8.52,
        "realReturnPct": -33.73
      }
    ],
    "note": "Valores de fim de mês, antes de impostos e taxas. CDI capitaliza a taxa diária; IPCA usa a variação mensal; USD usa a PTAX de venda. Retorno real = deflacionado pelo IPCA."
  },
  "source": "BCB SGS",
  "asOf": "2026-09",
  "attribution": "Fonte: Banco Central do Brasil (dados abertos, licença ODbL)",
  "dashboard": "https://www.financialcloud.com.br",
  "citation": "Fonte: Banco Central do Brasil (dados abertos, licença ODbL), BCB SGS, dados até 2026-09. Análise derivada: Financial Cloud (https://www.financialcloud.com.br).",
  "sourceUrls": [
    "https://api.bcb.gov.br/dados/serie/bcdata.sgs.12/dados?formato=json",
    "https://api.bcb.gov.br/dados/serie/bcdata.sgs.433/dados?formato=json",
    "https://api.bcb.gov.br/dados/serie/bcdata.sgs.1/dados?formato=json"
  ]
}

Séries usadas

SGS 1 — USD/BRL PTAX sell rate
SGS 12 — CDI daily rate
SGS 433 — IPCA monthly change

Cobertura: 1986-03 a 2026-09. Detalhes de cada série (frequência, período, linhas) no catálogo de dados.

Metodologia

Valores de fim de mês, antes de impostos e taxas.
CDI: capitalização da taxa diária (SGS 12) dia a dia. Dólar: variação da PTAX de venda (SGS 1) entre os fins de mês. Inflação: IPCA mensal (SGS 433) encadeado.
Retorno real de cada ativo pela fórmula de Fisher: (1 + nominal) / (1 + IPCA acumulado) − 1.
Vencedor = maior retorno real; o texto diz se ele ganhou (retorno real ≥ 0) ou perdeu para a inflação, e quanto o outro ficou atrás.

Atualização

Diária, às 22:17 UTC (19:17 em Brasília). O servidor relê as análises a cada 15 minutos.

Pergunte ao seu agente

Prompt pronto, que já diz ao agente qual ferramenta usar:

Use a ferramenta compare_returns do MCP Financial Cloud para comparar quanto R$ 10.000 aplicados em janeiro de 2021 renderiam hoje no CDI e no dólar, e se ganharam da inflação. Cite a fonte.

Atribuição

Fonte: Banco Central do Brasil (dados abertos, licença ODbL) — licença ODbL. Análise derivada: Financial Cloud. Toda resposta traz esse texto no campo attribution e uma citação pronta em citation.