Teses de investimento

O chat do DataBolsa não é só "qual a cotação de X": ele encadeia screening, fundamentos, dividendos e documentos numa conversa de estudo. Este roteiro mostra como sair de uma ideia vaga e chegar a uma tese organizada — e funciona igual no chat da plataforma ou no seu agente conectado.

Com a sua carteira

Logado (ou conectado via agente), o agente também enxerga a sua carteira:

"Essa tese aumenta ou diminui a concentração setorial da minha carteira?"

"Qual posição minha está mais distante da tese original? O que mudou nos fundamentos dela?"

Salve a tese na sua conta

O estudo não precisa morrer na conversa. Peça ao agente:

"Salve isso como uma tese na minha conta."

Ele estrutura o estudo num documento de tese (capa, recomendação, cenários, riscos, fontes com data), escrito em markdown, e salva no seu perfil. As suas teses ficam em Minhas teses, onde você pode:

• Compartilhar por link: unlisted (só quem tem o link) ou public (com página própria);
• Encontrar e organizar: as mais recentes aparecem primeiro; você também pode ordenar pelas mais antigas. Arquive as antigas e use tags privadas para filtrar (as tags são só suas);
• Exportar em PDF (planos pagos): um documento A4 diagramado, publicado num link permanente;
• Editar com IA: o card abre o agente já com o ID da tese. Ele lê o documento, propõe as mudanças e pede confirmação antes de substituir a versão; depois você decide se mantém privada ou publica novamente.

Privacidade por padrão: toda tese nasce privada e só você a vê. Ao publicar, o documento vai completo para a página pública: revise o conteúdo antes, inclusive seções com dados pessoais. Compartilhar uma tese é topo de funil: quem abre o link vê só a capa e cria uma conta grátis para ler o resto. Não existe link que libere a tese inteira sem conta.

O formato: markdown

A tese é escrita em markdown com um frontmatter YAML. Só kind e title são obrigatórios — autor, capa, âncoras das seções e disclaimer o servidor preenche. O kind classifica a tese (equity, fii, etf, bdr, fundo, credito, tesouro, cripto, global, macro, setor, carteira, carta, outros) e aceita as formas naturais: "ação", "debêntures", "renda fixa", "EUA".

---
kind: equity
title: Banco do Brasil — capital para crescer
ticker: BBAS3
---

## Tese em uma página

Texto corrido em **Markdown GFM** completo: títulos, listas, links, citações e
código. Uma tabela vira tabela do relatório:

| Indicador | 2025 | 2026e |
| --- | ---: | ---: |
| ROE | 21,2% | 19,8% |

> [!risco] Inadimplência do agro
> A safra pressiona a carteira rural.

```db:rating
rating: compra
priceTarget: { value: "R$ 41,00", horizon: "12m" }
```

Os blocos ricos do relatório vão em cercas db:<tipo> com corpo YAML: rating, keyStats, summary, chart, scenarios, sources, quote, figure, table, cover e disclaimer.

Um bloco fora do formato não derruba a tese: ele vira uma caixa de atenção no documento e aparece em warnings na resposta, com a linha e o campo. O mesmo vale para qualquer rótulo fora dos valores conhecidos — rating, tom de destaque, tipo de gráfico, kind: cai no default mais honesto e reporta a troca. Uma resposta 201 com warnings é sucesso parcial — a tese está salva e você corrige em cima.

Pela API, CLI e MCP

Tudo que a plataforma faz, o contrato público também faz.

# cria uma tese a partir de um arquivo .md (a CLI codifica o arquivo p/ você)
databolsa importThesisFile --file minha-tese.md

# lista, publica e exporta
databolsa listMyTheses
databolsa publishThesis <id> --visibility public
databolsa exportThesis <id>

O getThesis devolve o markdown em md — é esse o campo para ler e editar. O documento compilado é derivado dele e só vem com include=doc, para quem vai renderizar.

Para mudar uma tese, o caminho barato é o editThesis, que troca um trecho e exige que ele apareça uma única vez (inclua as linhas ao redor até ficar inequívoco). O updateThesis substitui o markdown inteiro e serve para reescritas grandes. Mandar o doc JSON pronto continua funcionando, mas ali a validação é tudo-ou-nada.

A referência completa está em API · Teses. Os limites por plano: 1 tese no Grátis, 25 no Pro e ilimitadas no Max; o export em PDF é recurso de plano pago.

Lembrete importante

O agente explica e organiza dados — ele não recomenda compra ou venda. A tese é sua; a plataforma existe para que ela seja construída sobre números auditáveis, não sobre achismo.