# fintay

> Dados financeiros e econômicos do Brasil e do mundo (Banco Central, CVM, B3, Tesouro, ANBIMA, Focus, FRED e outros) no terminal web, no Excel, em IAs via MCP e por API HTTP.

API: `https://api.fintay.com.br/v1`, autenticação pelo cabeçalho `X-API-Key` (chave criada em https://fintay.com.br/dashboard/api-keys). Respostas JSON no envelope `{ success, data, meta }`. Conector MCP: `https://mcp.fintay.com.br/mcp` (login OAuth).

---

# Primeiros passos

Fonte: https://fintay.com.br/docs/primeiros-passos

> Da criação da chave à primeira consulta, em poucos minutos.

Este guia leva você da conta recém-criada até a primeira série consultada pela API. Se preferir não programar, o [terminal](https://fintay.com.br/docs/terminal), o [Excel](https://fintay.com.br/docs/excel) e a [IA](https://fintay.com.br/docs/ia-e-conectores) usam os mesmos dados sem nenhuma linha de código.

## Veja um dado real agora

Antes de criar qualquer coisa, consulte a meta da Selic direto da base:

```bash
curl "https://api.fintay.com.br/v1/public/indicadores/selic-meta"
```

## Crie uma chave

1. [Crie sua conta](https://fintay.com.br/register) e confirme o e-mail.
2. No painel, abra **Conta e API → API Keys** e clique em criar chave.
3. Copie a chave na hora: ela só aparece completa no momento da criação.

> Guarde a chave em uma variável de ambiente ou em um cofre de segredos. Se ela vazar, revogue em API Keys e crie outra.

## Faça a primeira consulta

Toda chamada usa a origem `https://api.fintay.com.br` e envia a chave no cabeçalho `X-API-Key`. O exemplo abaixo traz os dois pontos mais recentes da meta da Selic (código 432 do Banco Central):

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/series/bacen/432/quotes?limit=2"
```

## Leia a resposta

As respostas em JSON seguem sempre o mesmo envelope:

```json
{
  "success": true,
  "data": {
    "series_id": "d1e42164-fa05-422f-8f81-66ebe24b3be1",
    "points": [
      { "reference_date": "2026-09-25", "value": 13.75 },
      { "reference_date": "2026-09-26", "value": 13.75 }
    ]
  },
  "meta": { "request_id": "…", "format": "json" }
}
```

- `data.points` traz a série em ordem de data: `reference_date` é o dia (ou mês) a que o valor se refere e `value`, o valor. Em ativos da B3 vêm também `open_price`, `high_price`, `low_price`, `close_price` e `volume`.
- `meta.request_id` identifica a chamada. Informe esse código ao falar com o suporte.

> Uma resposta **202** significa que a série está sendo carregada pela primeira vez. Espere o tempo indicado em `retry_after` e repita a consulta.

## Próximos passos

- Entenda [chaves e limites](https://fintay.com.br/docs/autenticacao) antes de colocar a integração em produção.
- Veja como [encontrar a série certa](https://fintay.com.br/docs/series) pelo catálogo.
- Consulte a [referência da API](https://fintay.com.br/docs/api) com todas as rotas, exemplos reais e o botão **Testar**.

---

# Chaves e limites

Fonte: https://fintay.com.br/docs/autenticacao

> Como autenticar, quanto cada plano consulta e o que fazer quando uma chamada é recusada.

## Autentique com a chave

Envie a chave no cabeçalho `X-API-Key` em todas as chamadas. Nunca coloque a chave na URL, em capturas de tela ou em código que roda no navegador.

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/series/sources"
```

As rotas de conta, como criar chaves e ver o faturamento, usam a sessão do painel e não aceitam chave de API.

## Limites por plano

Cada plano tem um limite por minuto e uma cota mensal de consultas:

| Plano | Por minuto | Por mês |
| --- | --- | --- |
| Free | 60 | 5.000 |
| Individual | 200 | 20.000 |
| Pro | 600 | 75.000 |
| Empresas | sob consulta | sob consulta |

Acompanhe o consumo em **Conta e API → Uso da API** ou pela própria API:

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/auth/usage/api-key"
```

> As consultas feitas pelo ChatGPT ou pelo Claude conectados à sua conta entram na mesma cota mensal.

## Quando a chamada é recusada

| Código | O que significa | O que fazer |
| --- | --- | --- |
| 401 | Chave ausente, inválida ou revogada | Confira o cabeçalho `X-API-Key` e se a chave está ativa |
| 403 | Conta sem confirmação ou sem acesso ao recurso | Confirme o e-mail ou verifique o plano |
| 404 | Série ou identificador não encontrado | Busque o código certo no [catálogo](https://fintay.com.br/docs/series) |
| 429 | Limite do minuto ou cota do mês atingidos | Espere e reduza a frequência; leia a mensagem do erro |

Guarde o código HTTP e o `meta.request_id` ao abrir um chamado: com eles o suporte encontra a sua chamada.

## Proteja e revogue chaves

- Crie uma chave por integração, com um nome que identifique onde ela é usada.
- Se uma chave vazar, revogue em **API Keys**. As chamadas com ela param na hora.
- Revogar uma chave não afeta as outras.

---

# Séries e cotações

Fonte: https://fintay.com.br/docs/series

> Encontre a série certa no catálogo e consulte o histórico com filtros de data e formato.

## Encontre a série no catálogo

O catálogo lista as séries com fonte, identificador, frequência e unidade. Busque por nome e filtre pela fonte:

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/series/catalog?search=selic&per_page=10"
```

Cada item informa `series_id`, `source`, `id_type`, `id_value`, `frequency` e `unit`. A lista de fontes disponíveis sai de `GET /v1/series/sources`.

## Três formas de identificar uma série

| Forma | Exemplo | Quando usar |
| --- | --- | --- |
| UUID | `/v1/series/{series_id}/quotes` | A mais estável; prefira em integrações |
| Fonte e código | `/v1/series/bacen/432/quotes` | Códigos do Banco Central, ANBIMA, B3 e FRED |
| Fonte, tipo e código | `/v1/series/cvm/cnpj_fundo_classe/{cnpj}/quotes` | Fontes com mais de um tipo de identificador, como a cota de um fundo |

> Não presuma que um ticker exista em todas as fontes. Confirme no catálogo antes de montar a integração.

## Filtre o período

- `date_from` e `date_to`, no formato `AAAA-MM-DD`, limitam o período.
- `limit` devolve só os pontos mais recentes depois do filtro.

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/series/bacen/11/quotes?date_from=2025-01-01&limit=30"
```

## Escolha o formato

O padrão é JSON. Para levar direto para uma planilha, peça CSV ou Excel com o parâmetro `format`:

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/series/bacen/432/quotes?format=csv&limit=100"
```

## Respostas que pedem atenção

- **202 com status discovering ou ingesting**: a série está sendo carregada. Espere `retry_after` segundos e repita.
- **200 com `points` vazio**: a série existe, mas não há dados no período pedido. Amplie as datas.
- **404**: o identificador não foi encontrado. Volte ao catálogo.

## Fundamentos de empresas

Ações e outras séries com dados de balanço trazem fundamentos em `/fundamentals`:

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/series/b3/PETR4/fundamentals"
```

A cobertura e a data de referência variam por empresa. Campo ausente não significa zero; veja como interpretar em [Qualidade dos dados](https://fintay.com.br/docs/dados-e-qualidade).

---

# Qualidade dos dados

Fonte: https://fintay.com.br/docs/dados-e-qualidade

> Como ler data de referência, frequência, unidade e cobertura antes de usar um número.

Disponibilidade, atualização e precisão são propriedades de cada conjunto de dados, não da plataforma inteira. Antes de usar um número em uma análise, confira o contexto dele.

## Verifique o contexto

- **Fonte**: o órgão, a bolsa ou a entidade que publica o dado, e o identificador original.
- **Data de referência**: o dia ou o mês a que o valor se refere. É diferente do dia em que o dado foi publicado.
- **Frequência e unidade**: diária ou mensal; percentual, pontos, reais ou outra medida.
- **Cobertura**: primeiro e último registro, lacunas e possíveis revisões da fonte.

## Dados ausentes

Uma resposta vazia pode significar que a fonte não publicou o dado, que a cobertura não chega ao período pedido ou que o filtro de datas é estreito demais.

> Não preencha lacunas com zero. Um valor ausente é desconhecido, não nulo.

## Compare sem distorcer

Antes de comparar ativos ou indicadores, alinhe:

- frequência e janela de tempo;
- moeda e ajuste pela inflação;
- convenção de retorno e ajuste por proventos e desdobramentos;
- em fundos, a classe, a subclasse e a data do documento.

## Reproduza a consulta

Registre a rota, os parâmetros, o identificador, a fonte e a data da extração. Com isso você refaz a mesma consulta depois e compara com a fonte primária se surgir alguma divergência.

---

# Fundos de investimento

Fonte: https://fintay.com.br/docs/fundos

> Busque um fundo, acompanhe a cota diária, abra a carteira e descubra quais fundos têm um ativo.

Os dados de fundos vêm dos documentos que os fundos entregam à CVM: o informe diário (cota, patrimônio, captação, resgates e cotistas), a carteira mensal (CDA) e os informes de FIIs.

## Encontre o fundo

Busque por nome ou CNPJ. Ordene por patrimônio com `sort=aum`:

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/funds?search=credito&sort=aum&per_page=5"
```

Cada item traz o `cnpj_fundo`, o patrimônio e os cotistas do último informe, a data desse informe em `latest_reference_date` e a situação em `data_status` (`ativo`, `atrasado`, `dormente`, `encerrado` ou `sem_dados`).

## Cadastro, classes e cotas

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/funds/07593972000186?limit=5"
```

Desde a Resolução CVM 175, um fundo pode ter várias classes, cada uma com cota própria, listadas em `classes`.

## A cota como série

Use o CNPJ da classe para tratar a cota como qualquer série:

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/series/cvm/cnpj_fundo_classe/08771962000156/quotes?date_from=2026-01-01"
```

> A CVM publica o informe diário a cada dia útil, com cerca de dois dias úteis de defasagem.

## A carteira do fundo

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/funds/08771962000156/portfolio?competence=2026-08-01&limit=20"
```

As carteiras saem mensalmente, algumas semanas depois do fim do mês; posições podem ficar em sigilo por até 90 dias.

## Quais fundos têm um ativo

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/assets/34f27cc6-1076-46c0-aeb7-b5e85499b799/fund-holders?limit=10"
```

## Fundos imobiliários

```bash
curl -H "X-API-Key: SUA_CHAVE" "https://api.fintay.com.br/v1/fiis/HGLG11/monthly"
```

## Veja também

- [Buscar fundos](https://fintay.com.br/docs/api/fundos-busca), [Detalhes e cotas](https://fintay.com.br/docs/api/fundos-detalhe) e [Carteira de um fundo](https://fintay.com.br/docs/api/fundos-carteira).
- [Captação líquida da indústria](https://fintay.com.br/docs/api/fundos-fluxo).

---

# Painel

Fonte: https://fintay.com.br/docs/ferramentas

> Onde encontrar pesquisa, ativos, carteiras, mercado e conta no menu do painel.

O menu lateral do painel agrupa as ferramentas pelo trabalho que você quer fazer. **Início** e **Terminal** ficam sempre visíveis; os outros grupos se abrem ao clicar. Quem chega por um link encontra o grupo da página já aberto.

## Pesquisar e analisar

- **Screener**: filtra ações, FIIs, ETFs, fundos e títulos por indicadores.
- **Comparador**: põe ativos e séries lado a lado, com retorno, risco e indicadores.
- **Valuation DCF**: monta o fluxo de caixa descontado com premissas editáveis e mostra o preço-alvo.
- **DCF reverso**: parte do preço e mostra o crescimento, a margem, o retorno e a perpetuidade que ele já embute, com as demais premissas ajustáveis. Fica na seção DCF reverso do valuation, na aba Valuation do ativo e no terminal (`reverso WEGE3`).
- **Busca com IA**: encontra ativos a partir de uma descrição em português. Veja [IA e conectores](https://fintay.com.br/docs/ia-e-conectores).

## Ativos e fundos

- Ações, ETFs, fundos, FIIs, gestoras e índices têm páginas próprias, com gráfico, indicadores e notícias.
- **Tesouro Direto** reúne os títulos públicos e o histórico de preços e taxas.
- **Risco de crédito** mostra a probabilidade de inadimplência dos emissores.

## Carteiras

- **Gestão de carteiras**: registre as operações e acompanhe cota, posições e resultado diário.
- **Ferramentas de carteira**: backtest, otimização, risco e relatórios a partir de pesos informados.
- **Para você**: o que mudou nos ativos que você acompanha.

## Mercado e dados

Juros e derivativos, expectativas do Focus, notícias, agenda de eventos, séries e bases de dados.

## Conta e API

Chaves de API, uso do mês, plano e faturamento, indicações e configurações.

> Tudo o que está no painel também abre como painel no [terminal](https://fintay.com.br/docs/terminal), lado a lado com outros dados.

## Opções e cenários de juros

- **Precificar opções** (`precificar`): BS para europeias sem dividendos, Merton para dividend yield contínuo, Garman-Kohlhagen para câmbio, Black-76 para futuros e árvore CRR para exercício americano. Bachelier normal é uma escolha explícita para futuros/forwards e aceita preço/strike negativos.
- **Monitor de volatilidade** (`smile PETR4`): contratos carregados com preço no mesmo pregão do ativo; separa vencimento e estilo, mostra IV perto do spot e razões de exclusão. Não é uma superfície calibrada ou ranking a prazo constante.
- **Cenários de juros e Copom** (`copom`): datas de vigência e choques no CDI informados pelo usuário, com capitalização por intervalos e comparação com a curva DI. Não infere decisões nem probabilidades.
- **Estratégias com opções** (`estrategia PETR4`): exercício por perna, multiplicador financeiro, custos e cenário por preço/tempo/volatilidade. Limites globais de ganho/perda somente para vencimento comum. Pernas com vencimentos diferentes são marcadas teoricamente no primeiro vencimento.

As ferramentas usam dias úteis/252. Juros e dividend yield são informados como percentuais efetivos anuais e convertidos a taxas contínuas. Gregas: theta por dia útil, rho por 1 p.p. de taxa contínua e vega por 1 p.p. de vol lognormal; Bachelier usa vega por uma unidade de vol normal. Vol normal é expressa em unidades de preço/raiz de ano, e não em %. Dividendos discretos, ajustes de strike, liquidação por exercício e opções com prêmio ajustado diariamente não são inferidos.

Na API, `POST /v1/analytics/option_calculator`, `/option_surface` e `/copom` seguem o mesmo esquema de autenticação das outras ferramentas. As rotas `/{ferramenta}/export?format=pdf|xlsx|html` usam o módulo comum de relatórios. Em `options_strategy`, cada perna de opção exige `style: european|american`; `underlying_kind` é `spot`, `future` ou `fx`. O modo `auto` seleciona o modelo pela natureza e pelo estilo. Sem curva DI e sem taxa informada, o cálculo recusa assumir juros zero.

---

# Terminal

Fonte: https://fintay.com.br/docs/terminal

> Comandos, abas e painéis para acompanhar o mercado em uma tela só.

O terminal reúne cotações, fundamentos, curvas, Focus, carteiras e notícias em painéis lado a lado. Você abre cada painel com um comando curto e organiza tudo em abas que ficam salvas na sua conta.

## Como usar

1. Abra o terminal pelo menu do painel ou em [fintay.com.br/terminal](https://fintay.com.br/terminal).
2. Comece a digitar na barra de comandos. O terminal sugere o comando, o ativo e a série.
3. Tecle Enter para abrir o painel. Arraste para mover e puxe a borda para redimensionar.
4. Crie abas por tema com `aba Bancos`, `aba Juros` e assim por diante.

> Cada comando aceita apelidos. `cotacao VALE3` e `ativo VALE3` abrem o mesmo painel.

## Argumentos

- Entre colchetes, como `[ticker]`, o argumento é opcional: sem ele, o comando abre a visão geral.
- Para várias séries, separe por vírgula: `comparativo IPCA, IGP-M`.
- Carteiras salvas entram com arroba: `backtest @previdencia vs CDI`.

## Todos os comandos

| Comando | O que faz | Exemplo |
| --- | --- | --- |
| `calendario` | Calendário econômico de Brasil e EUA com filtros e horários de Brasília | `calendario` |
| `ettj` | ETTJ ANBIMA: curvas, múltiplas datas, vértices e fórmulas Excel | `ettj` |
| `curvas` | Curvas de mercado: pré, juro real e inflação implícita pelos futuros, com comparação entre datas | `curvas implicita` |
| `tpf` | Taxas e PU de títulos públicos; histórico de um ativo | `tpf NTN-B 2055` |
| `vna` | Histórico de VNA por família ou título | `vna NTN-B 2055` |
| `proventos` | Proventos de um ativo; sem ticker, agenda do mercado | `proventos PETR4` |
| `analisar` | Aba pronta para estudar um ativo: cotação, DCF, DCF reverso, volatilidade e notícias ligados no mesmo grupo | `analisar WEGE3` |
| `ativo` | Visão completa: cotação, retornos, fundamentos e notícias | `ativo VALE3` |
| `fundamentos` | Indicadores fundamentalistas e histórico | `fundamentos ITUB4` |
| `dcf` | Valuation por fluxo de caixa: preço-alvo, upside e premissas | `dcf LREN3` |
| `reverso` | DCF reverso: crescimento, margem e retorno que o preço atual embute | `reverso WEGE3` |
| `screener` | Filtra ativos por indicadores | `screener fii` |
| `brasil` | Aba pronta do mercado local: monitor, curva DI, histórico de prazos, setores e títulos públicos | `brasil` |
| `setorial` | Desempenho de 1 dia a 12 meses por setor e por ativo | `setorial IBOV` |
| `comparar` | Desempenho, risco e indicadores lado a lado | `comparar PETR4 VALE3 ITUB4` |
| `grafico` | Gráfico com indicadores técnicos | `grafico IPCA` |
| `noticias` | Notícias de um ativo ou de um assunto | `noticias copom` |
| `heatmap` | Análise de retornos: mapa, acumulado, quedas, distribuição e sazonalidade | `heatmap BOVA11 vs CDI` |
| `sazonalidade` | Ano corrente contra os anteriores: trajetória, média e faixa na mesma data | `sazonalidade IBOV` |
| `comparativo` | Várias séries no mesmo gráfico | `comparativo IPCA, IGP-M` |
| `kpi` | Valor atual e variação em destaque | `kpi Selic` |
| `focus` | Expectativas de mercado: quadro, histórico das revisões e trajetória | `focus Selic` |
| `curva` | Curva de juros DI: comparação entre datas; "historico" mostra a taxa de prazos fixos ao longo do tempo | `curva historico` |
| `agenda` | Próximas datas-ex e pagamentos do mercado | `agenda` |
| `cripto` | Histórico de criptomoedas | `cripto BTC` |
| `futuro` | Histórico de um contrato futuro | `futuro WINZ26` |
| `opcoes` | Cadeia de opções do ativo | `opcoes PETR4` |
| `monitor` | Monitor com variação e z-score; "global" e "brasil" trazem listas prontas | `monitor global` |
| `idka` | Curva de juros pelos índices IDkA | `idka` |
| `anbima` | Tabela de índices ANBIMA com retorno e variação | `anbima` |
| `uso` | Uso da API no período e limites do plano | `uso` |
| `port` | Gestão de carteiras: posições, caixa, cota, desempenho e risco a partir das operações | `port previdencia risco` |
| `carteira` | Carteiras salvas; sem argumento, abre o hub de ferramentas | `carteira @previdencia` |
| `backtest` | Backtest: patrimônio, quedas, métricas, contribuição e estresse | `backtest @previdencia vs CDI` |
| `otimizar` | Otimização: max-sharpe, min-vol, risk-parity, cvar, sortino, max-ir vs X | `otimizar PETR4 VALE3 ITUB4 IVVB11 IMA-B risk-parity` |
| `fronteira` | Fronteira eficiente e posição da carteira atual | `fronteira BOVA11 IVVB11 IMA-B GOLD11 CDI` |
| `risco` | Sharpe, Sortino, Calmar, VaR, CVaR, vol, TE, IR e quedas | `risco PETR4 VALE3 vs IBOV` |
| `correl` | Matriz de correlação entre ativos, fundos e índices | `correl BOVA11 IVVB11 IMA-B GOLD11 DOLAR` |
| `atribuicao` | Atribuição por classe, contribuição de risco e fatores | `atribuicao @previdencia vs IBOV` |
| `montecarlo` | Monte Carlo: faixas de patrimônio, chance de sucesso e saque sustentável | `montecarlo @previdencia 25a` |
| `radar` | Radar do Mercado: sínteses dos acontecimentos mais relevantes | `radar` |
| `ia` | Busca de ativos com IA em linguagem natural | `ia fundos com baixa volatilidade` |
| `sinais` | Análises de inconsistências financeiras e insiders | `sinais AZUL3` |
| `chat` | Abre o chat | `chat` |
| `comunicados` | Fatos relevantes e comunicados; sem ticker, os fatos relevantes do mercado | `comunicados PETR4` |
| `credito` | Risco de crédito do emissor; sem ticker, o painel de crédito | `credito AZUL4` |
| `insiders` | Acionistas, free float e negociação de administradores | `insiders WEGE3` |
| `alertas` | Regras de alerta e avisos recebidos | `alertas` |
| `calc` | Calculadoras: título bancário na curva e a mercado, comparação líquida, come-cotas | `calc` |
| `precificar` | Calculadora de opções por modelo e estilo | `precificar` |
| `smile` | Monitor de volatilidade por vencimento | `smile PETR4` |
| `copom` | Cenários de CDI por vigência contra a curva DI | `copom` |
| `estrategia` | Montagem de estratégias com opções: resultado, gregas e equilíbrio | `estrategia PETR4` |
| `prob` | Probabilidades por faixa de preço e raio-x de volatilidade | `prob PETR4 21` |
| `formula` | Construtor de indicadores sobre os demonstrativos | `formula` |
| `leiloes` | Resultados dos leilões de títulos públicos | `leiloes` |
| `composicao` | Carteira teórica de um índice da B3 | `composicao IBOV` |
| `inflacao` | Inflação implícita por vencimento | `inflacao` |
| `carrego` | Monitor de títulos públicos: carrego contra o CDI, variações de taxa, retorno e volatilidade | `carrego ipca` |
| `lista` | Listas de acompanhamento com colunas, notas e compartilhamento | `lista Bancos` |
| `fluxo` | Captação líquida de fundos por categoria, classificação ANBIMA ou gestora | `fluxo gestora` |
| `rrg` | Rotação relativa: força relativa e momento contra uma referência | `rrg setores` |
| `abrir` | Página completa do ativo ou da série, com todas as abas | `abrir WEGE3` |
| `tela` | Abre qualquer tela do painel aqui no terminal; sem nome, lista todas | `tela fundos` |
| `inicio` | Tela inicial do painel | `inicio` |
| `comecar` | Primeiros passos e jornadas | `comecar` |
| `paravoce` | Destaques escolhidos para você | `paravoce` |
| `ativos` | Lista de ações e ETFs da B3 | `ativos` |
| `fundos` | Fundos de investimento: busca, rankings e detalhes | `fundos` |
| `fiis` | Fundos imobiliários | `fiis` |
| `gestores` | Gestores de fundos | `gestores` |
| `mercados` | Juros e derivativos: DI, futuros, opções e cripto | `mercados` |
| `tesourodireto` | Tesouro Direto: preços, taxas e histórico | `tesourodireto` |
| `ofertas` | Ofertas de crédito registradas na CVM | `ofertas` |
| `qualidade` | Qualidade contábil das companhias | `qualidade` |
| `series` | Catálogo de séries | `series` |
| `bases` | Bases de dados para download | `bases` |
| `relatorios` | Marca dos relatórios de carteira | `relatorios` |
| `chaves` | Chaves de API | `chaves` |
| `excel` | Fintay para Excel: instalação e funções | `excel` |
| `plano` | Plano, assinatura e faturas | `plano` |
| `indicacoes` | Programa de indicação | `indicacoes` |
| `suporte` | Fale com o suporte e acompanhe chamados | `suporte` |
| `config` | Configurações da conta e segurança | `config` |
| `aba` | Cria uma aba nova | `aba Bancos` |

---

# Excel

Fonte: https://fintay.com.br/docs/excel

> Instale o suplemento e traga séries, ações, fundos e Tesouro direto para as células.

O suplemento da Fintay adiciona funções ao Excel para Windows. Você escreve a fórmula na célula e o resultado aparece na planilha, atualizado sempre que o arquivo é recalculado.

## Baixe o suplemento

1. Entre no painel e abra **Excel** no menu.
2. Confirme o download. O arquivo ZIP traz o suplemento `Fintay.xlam` e o arquivo `api_key.txt` com uma chave criada só para ele.
3. Extraia os dois arquivos para a **mesma pasta**. O suplemento lê a chave do `api_key.txt` que está ao lado dele.

> Arquivos baixados da internet vêm bloqueados pelo Windows. Clique com o botão direito em `Fintay.xlam`, abra **Propriedades** e marque **Desbloquear** antes de instalar.

## Instale no Excel

1. No Excel, abra **Arquivo → Opções → Suplementos**.
2. Em **Gerenciar**, escolha **Suplementos do Excel** e clique em **Ir**.
3. Clique em **Procurar**, selecione o `Fintay.xlam` e confirme.

As funções começam com `Fintay_` e aparecem no assistente de funções com a descrição de cada parâmetro.

## Primeira fórmula

Para descobrir os parâmetros de qualquer função, use a ajuda dentro da própria planilha:

```text
=Fintay_Ajuda("Fintay_Serie")
```

Para trazer o histórico de uma série, informe o identificador e, se quiser, o período:

```text
=Fintay_Serie("<identificador da série>"; DATA(2025;1;1); DATA(2025;12;31))
```

O identificador é o mesmo usado pela API; encontre o da série desejada no [catálogo](https://fintay.com.br/docs/series).

## Principais funções

| Função | O que traz |
| --- | --- |
| `Fintay_Serie` | Histórico de uma série ou cotação |
| `Fintay_B3_Cotacoes_Atuais` | Cotações atuais de uma lista de tickers, como "PETR4,VALE3" |
| `Fintay_B3_Fundamentos_Completos` | Indicadores de balanço de uma empresa |
| `Fintay_Fundo_Dados` | Cota, patrimônio, captações, resgates e cotistas por dia |
| `Fintay_Fundo_Carteira` | Carteira pública de um fundo no mês escolhido |
| `Fintay_Tesouro_Cotacoes` | Preços e taxas dos títulos do Tesouro Direto |
| `Fintay_Focus_Expectativas` | Expectativas do mercado do boletim Focus |

> As consultas feitas pelo Excel entram na cota mensal do seu plano, como as da API.

---

# IA e conectores

Fonte: https://fintay.com.br/docs/ia-e-conectores

> Busca com IA, Radar do Mercado, alertas de balanço, chat e a conexão com o ChatGPT e o Claude.

A IA da Fintay responde a partir da base: antes de dar um número, ela consulta a série, a cotação ou o balanço. Se o dado não existe, ela diz que não encontrou.

## Dentro da Fintay

| Recurso | Para que serve | No terminal |
| --- | --- | --- |
| Busca com IA | Descreva o que procura e receba a lista de ativos que atendem, com os filtros à mostra | `ia` |
| Radar do Mercado | Sínteses do que mexeu com juros, câmbio, bolsa e empresas | `radar` |
| Inconsistências e insiders | Alertas quando lucro e caixa se descolam ou quando administradores negociam fora do comum | `sinais` |
| Chat | Converse mencionando ativos e carteiras; a resposta traz cartões que abrem o gráfico ou o ativo | `chat` |

Escreva perguntas como faria a um analista:

- "bancos pagando mais de 8% de dividendos com P/L abaixo de 9"
- "fundos de crédito privado acima do CDI com volatilidade baixa"
- "o que mexeu com os juros hoje?"

## Conecte ao ChatGPT ou ao Claude

A conexão é autorizada com o login da sua conta Fintay. Não há chave para copiar.

1. Copie o endereço do conector:

`https://mcp.fintay.com.br/mcp`

2. No ChatGPT ou no Claude, abra as configurações de conectores e adicione um **conector personalizado** com esse endereço.
3. Faça login na Fintay e autorize o acesso. Pronto: pergunte sobre qualquer indicador, ativo ou série.

> O acesso é somente de leitura. Para desconectar, remova o conector nas configurações do ChatGPT ou do Claude.

## O que o assistente consegue consultar

- Buscar séries no catálogo por nome ou fonte.
- Trazer o histórico de uma série, com filtro de datas.
- Ler os fundamentos de empresas.
- Mostrar o uso da sua cota no mês.

As consultas feitas pelo assistente entram na cota mensal do seu plano.

---

# Referência da API

## Buscar séries

`GET https://api.fintay.com.br/v1/series/catalog` · Séries · https://fintay.com.br/docs/api/series-catalogo

Busca no catálogo de séries por nome ou código, com filtro de fonte. Use o `series_id` devolvido nas rotas de cotações.

Parâmetros:

- `source` (query; string): Fonte da série, como devolvida em `/v1/series/sources` (ex.: `bacen`, `b3`, `cvm`, `anbima`, `fred`).
- `search` (query; string): Texto buscado no nome e no código da série.
- `page` (query; integer; padrão: 1): Página, a partir de 1.
- `per_page` (query; integer; padrão: 50): Itens por página.
- `include_inactive` (query; boolean; padrão: false): Inclui séries descontinuadas.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "series_id": "22306924-aab6-4286-8ce0-217a1efead9c",
        "name": "Índice nacional de preços ao consumidor-amplo (IPCA)",
        "source": "bacen",
        "id_type": "sgs_code",
        "id_value": "433",
        "frequency": "M",
        "unit": "Var. % mensal"
      },
      {
        "series_id": "ea1c30e7-2501-456f-ad5c-70f5b91348fb",
        "name": "Índice nacional de preços ao consumidor - amplo (IPCA) - em 12 meses",
        "source": "bacen",
        "id_type": "sgs_code",
        "id_value": "13522",
        "frequency": "M",
        "unit": "%"
      }
    ],
    "total": 2,
    "page": 1,
    "per_page": 3
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Listar fontes

`GET https://api.fintay.com.br/v1/series/sources` · Séries · https://fintay.com.br/docs/api/series-fontes

Fontes disponíveis no catálogo de séries. O valor de cada item é o primeiro segmento dos caminhos de cotação.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": [
    "anbima",
    "b3",
    "bacen"
  ],
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Detalhes de uma série

`GET https://api.fintay.com.br/v1/series/{series_id}` · Séries · https://fintay.com.br/docs/api/series-detalhe

Metadados de uma série pelo `series_id`: nome, fonte, identificadores, frequência, unidade e período coberto.

Parâmetros:

- `series_id` (path; string; obrigatório): Identificador da série (UUID), devolvido pela busca.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "series_id": "22306924-aab6-4286-8ce0-217a1efead9c",
    "name": "Índice nacional de preços ao consumidor-amplo (IPCA)",
    "source": "bacen",
    "id_type": "sgs_code",
    "id_value": "433",
    "frequency": "M",
    "unit": "Var. % mensal",
    "description": null
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Cotações por fonte e código

`GET https://api.fintay.com.br/v1/series/{source}/{code}/quotes` · Séries · https://fintay.com.br/docs/api/series-cotacoes-codigo

Histórico de uma série pelo código na fonte, sem precisar do `series_id`. É a forma mais curta: `bacen/433` é o IPCA, `b3/PETR4` é a ação da Petrobras.

> Para outras fontes ou tipos de identificador, use o caminho com o tipo explícito: `/v1/series/{source}/{type1}/{code}/quotes`.

Parâmetros:

- `source` (path; string; obrigatório): Fonte com tipo de identificador padrão: `bacen` (código SGS), `b3` (ticker), `anbima` (código do índice) ou `fred`.
- `code` (path; string; obrigatório): Código da série na fonte.
- `date_from` (query; string): Data inicial, inclusiva (AAAA-MM-DD).
- `date_to` (query; string): Data final, inclusiva (AAAA-MM-DD).
- `limit` (query; integer; padrão: 2000): Máximo de pontos, contados a partir do mais recente.
- `format` (query; string; padrão: json): `json` (padrão), `csv` ou `xlsx`. CSV e XLSX devolvem o arquivo, sem o envelope.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "series_id": "22306924-aab6-4286-8ce0-217a1efead9c",
    "points": [
      {
        "reference_date": "2026-01-01",
        "value": 0.33,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-03-01",
        "value": 0.88,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-04-01",
        "value": 0.67,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Cotações com tipo de identificador

`GET https://api.fintay.com.br/v1/series/{source}/{type1}/{code}/quotes` · Séries · https://fintay.com.br/docs/api/series-cotacoes-tipo

Igual à rota por código, mas com o tipo de identificador no caminho. Use para cotas de fundos (`cvm/cnpj_fundo_classe/<CNPJ>`) e séries de fontes sem tipo padrão.

Parâmetros:

- `source` (path; string; obrigatório): Fonte da série.
- `type1` (path; string; obrigatório): Tipo do identificador na fonte (ex.: `cnpj_fundo_classe` para a classe de um fundo, `cnpj_fundo` para fundos antigos, `series_code`).
- `code` (path; string; obrigatório): Valor do identificador.
- `date_from` (query; string): Data inicial, inclusiva.
- `date_to` (query; string): Data final, inclusiva.
- `limit` (query; integer; padrão: 2000): Máximo de pontos, a partir do mais recente.
- `format` (query; string; padrão: json): `json`, `csv` ou `xlsx`.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "series_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
    "points": [
      {
        "reference_date": "2026-10-06",
        "value": 639.7558744,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-10-07",
        "value": 641.5789946,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-10-08",
        "value": 642.1441087,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Cotações por series_id

`GET https://api.fintay.com.br/v1/series/{series_id}/quotes` · Séries · https://fintay.com.br/docs/api/series-cotacoes-id

Histórico completo ou recortado de qualquer série do catálogo pelo `series_id`.

Parâmetros:

- `series_id` (path; string; obrigatório): Identificador da série (UUID).
- `date_from` (query; string): Data inicial, inclusiva.
- `date_to` (query; string): Data final, inclusiva.
- `limit` (query; integer; padrão: 2000): Máximo de pontos, a partir do mais recente.
- `format` (query; string; padrão: json): `json`, `csv` ou `xlsx`.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "series_id": "d1e42164-fa05-422f-8f81-66ebe24b3be1",
    "points": [
      {
        "reference_date": "2026-09-24",
        "value": 13.75,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-09-25",
        "value": 13.75,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-09-26",
        "value": 13.75,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "close_price": null,
        "volume": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Cotações ajustadas por proventos

`GET https://api.fintay.com.br/v1/series/{series_id}/adjusted-quotes` · Séries · https://fintay.com.br/docs/api/series-cotacoes-ajustadas

Preços de um ativo da B3 ajustados por dividendos, JCP, desdobramentos e grupamentos, prontos para calcular retorno total.

> Só ativos com histórico de preços conferido têm preço ajustado. Para os demais, a rota responde `422` com "histórico de preços em revisão"; se houver um buraco de mais de 7 dias no período, responde `422` com "lacuna no histórico".

Parâmetros:

- `series_id` (path; string; obrigatório): Identificador da série do ativo.
- `date_from` (query; string): Data inicial, inclusiva.
- `date_to` (query; string): Data final, inclusiva.
- `limit` (query; integer; padrão: 2000): Máximo de pontos.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
    "price_basis": "source_adjusted",
    "points": [
      {
        "reference_date": "2026-10-07",
        "value": 55.12
      },
      {
        "reference_date": "2026-10-08",
        "value": 55.48
      },
      {
        "reference_date": "2026-10-09",
        "value": 56
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Fundamentos de um ativo

`GET https://api.fintay.com.br/v1/series/{source}/{code}/fundamentals` · Séries · https://fintay.com.br/docs/api/series-fundamentos

Indicadores fundamentalistas de uma ação, FII ou ETF: valor de mercado, P/L, P/VP, dividend yield, margens e retorno sobre o patrimônio.

Parâmetros:

- `source` (path; string; obrigatório): Use `b3`.
- `code` (path; string; obrigatório): Ticker do ativo.
- `limit` (query; integer; padrão: 1): Quantidade de retratos, do mais recente para trás.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
    "profile": {
      "ticker": "PETR4",
      "asset_group": "stock",
      "quote_type": null,
      "long_name": "Petroleo Brasileiro SA Pfd",
      "short_name": "PETR4",
      "currency": "BRL",
      "exchange": null,
      "market": null,
      "sector": "Energia",
      "industry": "Petróleo e Gás Integrado",
      "website": "https://petrobras.com.br",
      "country": null,
      "long_business_summary": "A Petróleo Brasileiro S.A. (Petrobras) é uma sociedade de economia mista brasileira, controlada pela União Federal, com ações negociadas na B3 (PETR3/PETR4) e ADRs na NYSE (PBR/PBR.A). Fundada em 1953, a companhia atua de forma integrada na cadeia de óleo, gás e energia, com foco…",
      "logo_url": "/v1/public/logos/PETR4.svg",
      "regular_market_source": null,
      "updated_at": "2026-10-10T06:21:01.910310Z"
    },
    "snapshots": [
      {
        "snapshot_date": "2026-10-09",
        "fetched_at": "2026-10-10T06:21:01.910310Z",
        "market_cap": 755566433692,
        "enterprise_value": 1337586000000,
        "total_revenue": 548493000000,
        "ebitda": 273323000000,
        "net_income_to_common": 133376000000,
        "total_cash": 53764000000,
        "total_debt": 676283000000,
        "total_cash_per_share": 4.1713953,
        "debt_to_equity": 1.40614,
        "current_ratio": 0.8544373,
        "quick_ratio": 0.57706815,
        "revenue_growth": 0.11228661,
        "earnings_growth": 0.7238277,
        "gross_margins": 0.5059536,
        "ebitda_margins": 0.4983163,
        "operating_margins": 0.3386479,
        "profit_margins": 0.2438609,
        "return_on_assets": 0.10457702,
        "return_on_equity": 0.27731782,
        "price_to_earnings": 5.41151687,
        "forward_pe": null,
        "price_to_book": 1.4867802,
        "book_value": 37.315536,
        "earnings_per_share": 10.3482633,
        "dividend_yield": 0.07,
        "payout_ratio": null,
        "beta": 0.47338906,
        "fifty_two_week_low": 29.31,
        "fifty_two_week_high": 56.8,
        "target_mean_price": null,
        "target_high_price": null,
        "target_low_price": null,
        "recommendation_key": null,
        "recommendation_mean": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Listar ativos da B3

`GET https://api.fintay.com.br/v1/b3/tickers` · Ações e índices · https://fintay.com.br/docs/api/b3-tickers

Ações, units, FIIs, ETFs e BDRs negociados na B3, com último fechamento e `series_id` de cada um.

Parâmetros:

- `asset_class` (query; string): Classe do ativo: `acao`, `unit`, `fii`, `etf`, `bdr`, `indice`, `fundo_listado`.
- `search` (query; string): Parte do ticker ou do nome.
- `include_inactive` (query; boolean; padrão: false): Inclui ativos que deixaram de ser negociados.
- `page` (query; integer; padrão: 1): Página, a partir de 1.
- `per_page` (query; integer; padrão: 100): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "ticker": "PETR3",
        "series_id": "0656231b-c8b4-41ad-81d9-1fafdb0e7e7d",
        "asset_class": "acao",
        "asset_group": "stock",
        "name": "Petroleo Brasileiro SA",
        "sector": "Energia",
        "is_active": true,
        "last_date": "2026-10-09",
        "latest_close": 63.06
      },
      {
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "asset_class": "acao",
        "asset_group": "stock",
        "name": "Petroleo Brasileiro SA Pfd",
        "sector": "Energia",
        "is_active": true,
        "last_date": "2026-10-09",
        "latest_close": 56
      },
      {
        "ticker": "RECV3",
        "series_id": "8370b621-0eb2-439f-b1da-f012c57bd608",
        "asset_class": "acao",
        "asset_group": "stock",
        "name": "Petroreconcavo SA",
        "sector": "Energia",
        "is_active": true,
        "last_date": "2026-10-09",
        "latest_close": 12.22
      }
    ],
    "total": 3,
    "page": 1,
    "per_page": 3,
    "asset_class": "acao",
    "class_counts": {
      "fundo_listado": 72,
      "acao": 338,
      "bdr": 582,
      "unit": 10,
      "fii": 310,
      "indice": 4,
      "etf": 209,
      "outro": 3,
      "fracionario": 374
    }
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Proventos e eventos de um ativo

`GET https://api.fintay.com.br/v1/b3/{ticker}/events` · Ações e índices · https://fintay.com.br/docs/api/b3-proventos-ativo

Dividendos, JCP, rendimentos, desdobramentos, grupamentos e bonificações de um ativo, com data-ex, data de pagamento e valor por ação.

Parâmetros:

- `ticker` (path; string; obrigatório): Ticker do ativo (ex.: `PETR4`, `HGLG11`).
- `event_type` (query; string): Filtra por tipo: `dividendo`, `jcp`, `rendimento`, `desdobramento`, `grupamento`, `bonificacao`, `subscricao`.
- `date_from` (query; string): Data-ex inicial.
- `date_to` (query; string): Data-ex final.
- `limit` (query; integer; padrão: 1000): Máximo de eventos.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "ticker": "PETR4",
    "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
    "items": [
      {
        "event_id": "093eedb5-9f9b-4e73-b80b-083199422a48",
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "event_type": "jcp",
        "label_original": "JCP",
        "approval_date": "2026-08-06",
        "last_date_prior": "2026-08-21",
        "ex_date": "2026-08-24",
        "ex_date_source": "2026-08-24",
        "payment_date": "2026-12-21",
        "value_per_share": 0.20250435,
        "factor": null,
        "factor_label": null,
        "isin": "BRPETRACNPR6"
      },
      {
        "event_id": "6fcaecd4-97bb-4170-bd74-42e568f2da8e",
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "event_type": "dividendo",
        "label_original": "DIVIDENDO",
        "approval_date": "2026-08-06",
        "last_date_prior": "2026-08-21",
        "ex_date": "2026-08-24",
        "ex_date_source": "2026-08-24",
        "payment_date": "2026-12-21",
        "value_per_share": 0.47156696,
        "factor": null,
        "factor_label": null,
        "isin": "BRPETRACNPR6"
      },
      {
        "event_id": "d944692c-a778-4e02-aa62-490facd89662",
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "event_type": "jcp",
        "label_original": "JCP",
        "approval_date": "2026-08-06",
        "last_date_prior": "2026-08-21",
        "ex_date": "2026-08-24",
        "ex_date_source": "2026-08-24",
        "payment_date": "2026-11-23",
        "value_per_share": 0.67407131,
        "factor": null,
        "factor_label": null,
        "isin": "BRPETRACNPR6"
      }
    ],
    "total": 3,
    "by_year": [
      {
        "year": 1996,
        "total": 5.1471,
        "count": 1
      },
      {
        "year": 1997,
        "total": 4.1263,
        "count": 2
      },
      {
        "year": 1998,
        "total": 6.1523,
        "count": 4
      }
    ],
    "dividend_yield_12m": 5.34,
    "dividend_yield_source": 0.07,
    "latest_close": 56,
    "latest_close_date": "2026-10-09"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Agenda de proventos

`GET https://api.fintay.com.br/v1/b3/events/calendar` · Ações e índices · https://fintay.com.br/docs/api/b3-agenda-proventos

Próximas datas-ex e pagamentos do mercado inteiro, por padrão de hoje até 90 dias à frente.

Parâmetros:

- `date_from` (query; string): Início da janela. Padrão: hoje.
- `date_to` (query; string): Fim da janela. Padrão: 90 dias à frente.
- `asset_class` (query; string): Classe do ativo (ex.: `acao`, `fii`).
- `event_type` (query; string): Tipo de evento.
- `limit` (query; integer; padrão: 500): Máximo de eventos.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "ticker": "CMIG3",
        "series_id": "8e65aa8f-7819-4e3e-8d8a-b6e53a0f8772",
        "name": "Companhia Energetica de Minas Gerais SA",
        "asset_class": "acao",
        "event_type": "jcp",
        "ex_date": "2025-03-26",
        "payment_date": "2026-12-30",
        "value_per_share": 0.09455892,
        "factor_label": null
      },
      {
        "ticker": "CMIG4",
        "series_id": "db132ff4-52eb-4868-9546-957945ef7a12",
        "name": "Companhia Energetica de Minas Gerais SA Pfd",
        "asset_class": "acao",
        "event_type": "jcp",
        "ex_date": "2025-03-26",
        "payment_date": "2026-12-30",
        "value_per_share": 0.09455892,
        "factor_label": null
      },
      {
        "ticker": "CLSC3",
        "series_id": "f7c8d6a0-adee-4d88-8699-d09459692eb8",
        "name": "Centrais Eletricas de Santa Catarina S.A.",
        "asset_class": "acao",
        "event_type": "jcp",
        "ex_date": "2025-03-27",
        "payment_date": "2026-12-30",
        "value_per_share": 0.735488,
        "factor_label": null
      }
    ],
    "total": 3,
    "date_from": "2026-10-18",
    "date_to": "2027-01-16"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Listar índices

`GET https://api.fintay.com.br/v1/indices` · Ações e índices · https://fintay.com.br/docs/api/indices-lista

Índices de bolsa e de renda fixa com o último fechamento e a variação do dia.

Parâmetros:

- `brazilian_only` (query; boolean; padrão: false): Só índices brasileiros (B3 e ANBIMA).
- `source` (query; string): `b3` ou `anbima`.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "ticker": "^BVSP",
        "series_id": "0f00362d-0325-4927-a74e-69f32af02804",
        "name": "Ibovespa",
        "source": "b3",
        "family": "Bolsa",
        "is_active": true,
        "is_brazilian": true,
        "first_date": null,
        "last_date": "2026-10-09",
        "latest_close": 209067,
        "previous_close": 206220,
        "change_percent": 1.38
      },
      {
        "ticker": "IFIX.SA",
        "series_id": "f5d8e2a2-e02d-49a7-9aa2-54f46e219f5b",
        "name": "IFIX",
        "source": "b3",
        "family": "Bolsa",
        "is_active": true,
        "is_brazilian": true,
        "first_date": null,
        "last_date": "2026-10-09",
        "latest_close": 3988.54,
        "previous_close": 3909.6499,
        "change_percent": 2.02
      },
      {
        "ticker": "^IGCX",
        "series_id": "66d519b1-9e81-4892-ae2d-447f59359298",
        "name": "IGC - Governanca Corporativa",
        "source": "b3",
        "family": "Bolsa",
        "is_active": true,
        "is_brazilian": true,
        "first_date": null,
        "last_date": "2026-10-09",
        "latest_close": 32579.0098,
        "previous_close": null,
        "change_percent": null
      }
    ],
    "total": 38,
    "base_date": "2026-10-09",
    "source_counts": {
      "b3": 4,
      "anbima": 34
    }
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Histórico de um índice

`GET https://api.fintay.com.br/v1/indices/{ticker}` · Ações e índices · https://fintay.com.br/docs/api/indices-historico

Série histórica de fechamento de um índice, como `^BVSP` (Ibovespa) ou `IFIX.SA`.

Parâmetros:

- `ticker` (path; string; obrigatório): Código do índice, como em `/v1/indices`.
- `date_from` (query; string): Data inicial.
- `date_to` (query; string): Data final.
- `limit` (query; integer; padrão: 5000): Máximo de pontos.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "index": {
      "ticker": "^BVSP",
      "series_id": "0f00362d-0325-4927-a74e-69f32af02804",
      "name": "Ibovespa",
      "source": "b3",
      "family": "Bolsa",
      "is_active": true,
      "is_brazilian": true,
      "first_date": "2026-10-05",
      "last_date": "2026-10-09",
      "latest_close": 209067,
      "previous_close": 206220,
      "change_percent": 1.38
    },
    "points": [
      {
        "reference_date": "2026-10-05",
        "close_price": 206912,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-10-06",
        "close_price": 205835,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "volume": null
      },
      {
        "reference_date": "2026-10-07",
        "close_price": 204302,
        "open_price": null,
        "high_price": null,
        "low_price": null,
        "volume": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Carteira teórica de um índice

`GET https://api.fintay.com.br/v1/b3/index-composition/{code}` · Ações e índices · https://fintay.com.br/docs/api/b3-composicao-indice

Ativos e pesos da carteira teórica de um índice da B3 numa data.

Parâmetros:

- `code` (path; string; obrigatório): Código do índice na B3 (ex.: `IBOV`, `SMLL`, `IDIV`).
- `on` (query; string): Data da carteira. Padrão: a mais recente.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "index": "IBOV",
    "reference_date": "2026-10-05",
    "previous_date": null,
    "items": [
      {
        "ticker": "VALE3",
        "asset_name": "VALE",
        "share_type": "ON NM",
        "theoretical_qty": 3687404862,
        "weight_pct": 9.877,
        "series_id": "92ca7ed4-821f-43b8-9838-37b8bc1ab198",
        "sector": "Extração Mineral"
      },
      {
        "ticker": "ITUB4",
        "asset_name": "ITAUUNIBANCO",
        "share_type": "PN EJ N1",
        "theoretical_qty": 5337898685,
        "weight_pct": 8.89,
        "series_id": "477a0e3d-fd0d-42cb-b33d-ea9c0c04e9e5",
        "sector": "Bancos"
      },
      {
        "ticker": "PETR4",
        "asset_name": "PETROBRAS",
        "share_type": "PN N2",
        "theoretical_qty": 4410957710,
        "weight_pct": 8.385,
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "sector": "Petróleo e Gás"
      }
    ],
    "entered": [],
    "left": [],
    "sectors": [
      {
        "sector": "Bancos",
        "weight_pct": 19.257
      },
      {
        "sector": "Petróleo e Gás",
        "weight_pct": 15.48
      },
      {
        "sector": "Extração Mineral",
        "weight_pct": 9.877
      }
    ],
    "concentration_top10": 54.153
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Cotações do pregão

`GET https://api.fintay.com.br/v1/live/quotes` · Ações e índices · https://fintay.com.br/docs/api/cotacoes-ao-vivo

Último preço, variação e horário de até 20 ativos durante o pregão. Fora do horário de negociação, devolve o último fechamento.

Parâmetros:

- `tickers` (query; string; obrigatório): Tickers separados por vírgula.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": [
    {
      "ticker": "PETR4",
      "name": "Petroleo Brasileiro SA Pfd",
      "price": 59.68,
      "open": 57.66,
      "high": 59.68,
      "low": 57.53,
      "volume": 56831500,
      "as_of": "2026-10-17T02:29:23+00:00",
      "session_date": "2026-10-16",
      "currency": "BRL",
      "previous_close": 57.36,
      "change": 2.3200000000000003,
      "change_pct": 4.044630404463034,
      "market_state": "closed"
    },
    {
      "ticker": "VALE3",
      "name": "Vale S.A.",
      "price": 66.21,
      "open": 66.72,
      "high": 67.37,
      "low": 65.87,
      "volume": 31286100,
      "as_of": "2026-10-17T02:29:23+00:00",
      "session_date": "2026-10-16",
      "currency": "BRL",
      "previous_close": 66.42,
      "change": -0.21000000000000796,
      "change_pct": -0.316169828364965,
      "market_state": "closed"
    }
  ],
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Buscar ações internacionais

`GET https://api.fintay.com.br/v1/international/tickers` · Ações e índices · https://fintay.com.br/docs/api/internacional-busca

Busca ações de bolsas fora do Brasil por ticker ou nome, com país e bolsa de listagem.

Parâmetros:

- `search` (query; string; obrigatório): Ticker ou parte do nome.
- `country` (query; string): País em ISO 3166-1, ex.: `US`, `GB`, `JP`.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 20): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "symbol": "AAPL",
        "name": "Apple Inc.",
        "country": "US",
        "exchange": "Nasdaq",
        "asset_type": "acao",
        "currency": "USD",
        "series_id": null,
        "latest_close": null
      },
      {
        "symbol": "APLE",
        "name": "Apple Hospitality REIT, Inc.",
        "country": "US",
        "exchange": "NYSE",
        "asset_type": "acao",
        "currency": "USD",
        "series_id": null,
        "latest_close": null
      },
      {
        "symbol": "2788.T",
        "name": "Apple International Co., Ltd.",
        "country": "JP",
        "exchange": "Bolsa de Tóquio",
        "asset_type": "acao",
        "currency": "JPY",
        "series_id": null,
        "latest_close": null
      }
    ],
    "page": 1,
    "per_page": 3,
    "has_more": true
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Demonstrações financeiras

`GET https://api.fintay.com.br/v1/companies/{cnpj}/statements` · Empresas · https://fintay.com.br/docs/api/empresas-demonstrativos

Contas das demonstrações entregues à CVM (DFP anual e ITR trimestral): balanço, resultado e fluxo de caixa, com a versão de cada entrega.

Parâmetros:

- `cnpj` (path; string; obrigatório): CNPJ da companhia, só números.
- `dataset` (query; string; padrão: dfp; valores: dfp, itr): `dfp` (anual) ou `itr` (trimestral).
- `scope` (query; string; padrão: consolidated; valores: consolidated, individual): `consolidated` (consolidado) ou `individual`.
- `reference_date` (query; string): Data de referência do demonstrativo.
- `account` (query; string): Código da conta (ex.: `3.01` receita, `3.11` lucro líquido).
- `as_of` (query; string): Só versões entregues até esta data, para reproduzir o que se sabia na época.
- `limit` (query; integer; padrão: 100): Máximo de linhas.
- `offset` (query; integer; padrão: 0): Linhas a pular.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "archive_id": "76abc4de-7b9d-4335-a853-14ed47e25204",
        "section": "dfp_cia_aberta_DRE_con_2025.csv",
        "row_number": 17559,
        "cnpj": "33000167000101",
        "reference_date": "2025-12-31",
        "version": 1,
        "scope": "consolidated",
        "statement": "DRE",
        "account_code": "3.01",
        "account_name": "Receita de Venda de Bens e/ou Serviços",
        "period_start": "2024-01-01",
        "period_end": "2024-12-31",
        "period_order": "PENÚLTIMO",
        "equity_column": null,
        "currency": "REAL",
        "scale": "MIL",
        "original_value": 490829000,
        "normalized_value": 490829000000,
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/DFP/DADOS/dfp_cia_aberta_2025.zip",
        "retrieved_at": "2026-09-21T21:48:03.595026+00:00",
        "latest_version": 1
      },
      {
        "archive_id": "76abc4de-7b9d-4335-a853-14ed47e25204",
        "section": "dfp_cia_aberta_DRE_con_2025.csv",
        "row_number": 17560,
        "cnpj": "33000167000101",
        "reference_date": "2025-12-31",
        "version": 1,
        "scope": "consolidated",
        "statement": "DRE",
        "account_code": "3.01",
        "account_name": "Receita de Venda de Bens e/ou Serviços",
        "period_start": "2025-01-01",
        "period_end": "2025-12-31",
        "period_order": "ÚLTIMO",
        "equity_column": null,
        "currency": "REAL",
        "scale": "MIL",
        "original_value": 497549000,
        "normalized_value": 497549000000,
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/DFP/DADOS/dfp_cia_aberta_2025.zip",
        "retrieved_at": "2026-09-21T21:48:03.595026+00:00",
        "latest_version": 1
      },
      {
        "archive_id": "6fa4645f-6827-48a7-9141-0318fb7e20db",
        "section": "dfp_cia_aberta_DRE_con_2024.csv",
        "row_number": 19439,
        "cnpj": "33000167000101",
        "reference_date": "2024-12-31",
        "version": 1,
        "scope": "consolidated",
        "statement": "DRE",
        "account_code": "3.01",
        "account_name": "Receita de Venda de Bens e/ou Serviços",
        "period_start": "2023-01-01",
        "period_end": "2023-12-31",
        "period_order": "PENÚLTIMO",
        "equity_column": null,
        "currency": "REAL",
        "scale": "MIL",
        "original_value": 511994000,
        "normalized_value": 511994000000,
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/DFP/DADOS/dfp_cia_aberta_2024.zip",
        "retrieved_at": "2026-09-22T06:11:26.008596+00:00",
        "latest_version": 1
      }
    ],
    "has_more": true,
    "offset": 0
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Demonstrativo em colunas

`GET https://api.fintay.com.br/v1/companies/{cnpj}/statements/comparison` · Empresas · https://fintay.com.br/docs/api/empresas-comparativo

Uma demonstração em formato de planilha: contas nas linhas e períodos nas colunas, pronta para análise horizontal.

Parâmetros:

- `cnpj` (path; string; obrigatório): CNPJ da companhia.
- `statement` (query; string; padrão: BPA): Demonstração: balanço, resultado ou fluxo de caixa.
- `scope` (query; string; padrão: consolidated; valores: consolidated, individual): Consolidado ou individual.
- `periods` (query; integer; padrão: 6): Quantidade de períodos.
- `start` (query; string)
- `end` (query; string)
- `frequency` (query; string; padrão: quarter; valores: quarter, year): Anual ou trimestral.
- `q` (query; string): Filtra contas pelo nome.
- `limit` (query; integer; padrão: 60)
- `offset` (query; integer; padrão: 0)

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "cnpj": "33000167000101",
    "scope": "consolidated",
    "statement": "BPA",
    "frequency": "quarter",
    "columns": [
      {
        "key": "2025-12-31",
        "reference_date": "2025-12-31",
        "dataset": "dfp",
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/DFP/DADOS/dfp_cia_aberta_2025.zip"
      },
      {
        "key": "2026-03-31",
        "reference_date": "2026-03-31",
        "dataset": "itr",
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/ITR/DADOS/itr_cia_aberta_2026.zip"
      },
      {
        "key": "2026-06-30",
        "reference_date": "2026-06-30",
        "dataset": "itr",
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/ITR/DADOS/itr_cia_aberta_2026.zip"
      }
    ],
    "rows": [
      {
        "account_code": "1",
        "account_name": "Ativo Total",
        "equity_column": null,
        "cells": [
          {
            "reported_value": 1223389000000,
            "quarter_value": 1223389000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 1246068000000,
            "quarter_value": 1246068000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 1279019000000,
            "quarter_value": 1279019000000,
            "currency": "REAL",
            "scale": "MIL"
          }
        ]
      },
      {
        "account_code": "1.01",
        "account_name": "Ativo Circulante",
        "equity_column": null,
        "cells": [
          {
            "reported_value": 140026000000,
            "quarter_value": 140026000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 140533000000,
            "quarter_value": 140533000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 154971000000,
            "quarter_value": 154971000000,
            "currency": "REAL",
            "scale": "MIL"
          }
        ]
      },
      {
        "account_code": "1.01.01",
        "account_name": "Caixa e Equivalentes de Caixa",
        "equity_column": null,
        "cells": [
          {
            "reported_value": 35608000000,
            "quarter_value": 35608000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 34294000000,
            "quarter_value": 34294000000,
            "currency": "REAL",
            "scale": "MIL"
          },
          {
            "reported_value": 33560000000,
            "quarter_value": 33560000000,
            "currency": "REAL",
            "scale": "MIL"
          }
        ]
      }
    ],
    "has_more": true,
    "offset": 0,
    "total_rows": 68,
    "available": [
      {
        "scope": "consolidated",
        "statement": "BPA",
        "periods": 22,
        "reference_dates": [
          "2021-03-31",
          "2021-06-30",
          "2021-09-30"
        ]
      },
      {
        "scope": "consolidated",
        "statement": "BPP",
        "periods": 22,
        "reference_dates": [
          "2021-03-31",
          "2021-06-30",
          "2021-09-30"
        ]
      },
      {
        "scope": "consolidated",
        "statement": "DFC_MI",
        "periods": 22,
        "reference_dates": [
          "2021-03-31",
          "2021-06-30",
          "2021-09-30"
        ]
      }
    ],
    "flow_statement": false,
    "note": "Valores normalizados para unidade monetária. Em fluxos, trimestre isolado é a diferença entre acumulados adjacentes; permanece vazio quando não há base comparável. Saldos patrimoniais são posições na data."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Acionistas e free float

`GET https://api.fintay.com.br/v1/companies/{cnpj}/shareholders` · Empresas · https://fintay.com.br/docs/api/empresas-acionistas

Composição acionária informada pela companhia: controladores, principais acionistas, ações em tesouraria e free float.

Parâmetros:

- `cnpj` (path; string; obrigatório): CNPJ da companhia.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "cnpj": "33000167000101",
    "reference_date": "2026-12-31",
    "version": 12,
    "holders": [
      {
        "id": "8224517",
        "parent_id": null,
        "name": "União Federal",
        "person_type": "PJ",
        "controller": true,
        "shareholder_agreement": false,
        "foreign": false,
        "pct_on": 50.26,
        "pct_pn": 0,
        "pct_total": 29.021,
        "last_change": "2026-04-16",
        "children": [
          {
            "id": "8224518",
            "parent_id": "8224517",
            "name": "Ações Tesouraria",
            "person_type": null,
            "controller": false,
            "shareholder_agreement": false,
            "foreign": false,
            "pct_on": 0,
            "pct_pn": 0,
            "pct_total": 0,
            "last_change": null,
            "children": []
          },
          {
            "id": "8224519",
            "parent_id": "8224517",
            "name": "Outros",
            "person_type": null,
            "controller": false,
            "shareholder_agreement": false,
            "foreign": false,
            "pct_on": 100,
            "pct_pn": 0,
            "pct_total": 100,
            "last_change": null,
            "children": []
          }
        ]
      },
      {
        "id": "8224497",
        "parent_id": null,
        "name": "BNDES Participações - BNDESPAR",
        "person_type": "PJ",
        "controller": false,
        "shareholder_agreement": false,
        "foreign": false,
        "pct_on": 0,
        "pct_pn": 16.528,
        "pct_total": 6.984,
        "last_change": "2026-04-16",
        "children": [
          {
            "id": "8224498",
            "parent_id": "8224497",
            "name": "Banco Nacional de Desenvolvimento Econômico e Social - BNDES",
            "person_type": "PJ",
            "controller": false,
            "shareholder_agreement": false,
            "foreign": false,
            "pct_on": 100,
            "pct_pn": 0,
            "pct_total": 100,
            "last_change": "2025-04-16",
            "children": [
              {
                "id": "8224499",
                "parent_id": "8224498",
                "name": "União Federal",
                "person_type": "PJ",
                "controller": true,
                "shareholder_agreement": false,
                "foreign": false,
                "pct_on": 100,
                "pct_pn": 0,
                "pct_total": 100,
                "last_change": "2026-04-16",
                "children": [
                  {
                    "id": "8224500",
                    "parent_id": "8224499",
                    "name": "Ações Tesouraria",
                    "person_type": null,
                    "controller": false,
                    "shareholder_agreement": false,
                    "foreign": false,
                    "pct_on": 0,
                    "pct_pn": 0,
                    "pct_total": 0,
                    "last_change": null,
                    "children": []
                  },
                  {
                    "id": "8224501",
                    "parent_id": "8224499",
                    "name": "Outros",
                    "person_type": null,
                    "controller": false,
                    "shareholder_agreement": false,
                    "foreign": false,
                    "pct_on": 100,
                    "pct_pn": 0,
                    "pct_total": 100,
                    "last_change": null,
                    "children": []
                  }
                ]
              },
              {
                "id": "8224503",
                "parent_id": "8224498",
                "name": "Ações Tesouraria",
                "person_type": null,
                "controller": false,
                "shareholder_agreement": false,
                "foreign": false,
                "pct_on": 0,
                "pct_pn": 0,
                "pct_total": 0,
                "last_change": null,
                "children": []
              },
              {
                "id": "8224504",
                "parent_id": "8224498",
                "name": "Outros",
                "person_type": null,
                "controller": false,
                "shareholder_agreement": false,
                "foreign": false,
                "pct_on": 0,
                "pct_pn": 0,
                "pct_total": 0,
                "last_change": null,
                "children": []
              }
            ]
          },
          {
            "id": "8224506",
            "parent_id": "8224497",
            "name": "Ações Tesouraria",
            "person_type": null,
            "controller": false,
            "shareholder_agreement": false,
            "foreign": false,
            "pct_on": 0,
            "pct_pn": 0,
            "pct_total": 0,
            "last_change": null,
            "children": []
          },
          {
            "id": "8224507",
            "parent_id": "8224497",
            "name": "Outros",
            "person_type": null,
            "controller": false,
            "shareholder_agreement": false,
            "foreign": false,
            "pct_on": 0,
            "pct_pn": 0,
            "pct_total": 0,
            "last_change": null,
            "children": []
          }
        ]
      },
      {
        "id": "8224513",
        "parent_id": null,
        "name": "GQG Partners LLC",
        "person_type": "PJ",
        "controller": false,
        "shareholder_agreement": false,
        "foreign": true,
        "pct_on": 4.995,
        "pct_pn": 6.383,
        "pct_total": 5.581,
        "last_change": "2026-05-21",
        "children": [
          {
            "id": "8224514",
            "parent_id": "8224513",
            "name": "Ações Tesouraria",
            "person_type": null,
            "controller": false,
            "shareholder_agreement": false,
            "foreign": false,
            "pct_on": 0,
            "pct_pn": 0,
            "pct_total": 0,
            "last_change": null,
            "children": []
          },
          {
            "id": "8224515",
            "parent_id": "8224513",
            "name": "Outros",
            "person_type": null,
            "controller": false,
            "shareholder_agreement": false,
            "foreign": false,
            "pct_on": 0,
            "pct_pn": 0,
            "pct_total": 0,
            "last_change": null,
            "children": []
          }
        ]
      }
    ],
    "distribution": {
      "shareholders_pf": "1175160",
      "shareholders_pj": "5987",
      "institutional": "2628",
      "free_float_pct": 61.212,
      "free_float_on_pct": 46.74,
      "free_float_pn_pct": 80.987,
      "last_meeting": "2026-04-16"
    }
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Comissão de Valores Mobiliários (CVM)",
      "dataset": "Companhias abertas: documentos eventuais, negociação de administradores e formulário de referência",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://dados.cvm.gov.br/group/companhias"
    }
  }
}
```

## Negociações de administradores

`GET https://api.fintay.com.br/v1/companies/{cnpj}/insiders` · Empresas · https://fintay.com.br/docs/api/empresas-insiders

Compras e vendas de ações por controladores, conselheiros e diretores, mês a mês.

Parâmetros:

- `cnpj` (path; string; obrigatório): CNPJ da companhia.
- `months` (query; integer; padrão: 24): Quantidade de meses para trás.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "cnpj": "33000167000101",
    "since": "2026-04-01",
    "monthly": [
      {
        "month": "2026-04-01",
        "holder_group": "Conselho de Administração ou Vinculado",
        "bought": 0,
        "sold": 0,
        "net_quantity": 0
      },
      {
        "month": "2026-04-01",
        "holder_group": "Conselho Fiscal ou Vinculado",
        "bought": 0,
        "sold": 0,
        "net_quantity": 0
      },
      {
        "month": "2026-04-01",
        "holder_group": "Controlador ou Vinculado",
        "bought": 0,
        "sold": 0,
        "net_quantity": 0
      }
    ],
    "trades": [
      {
        "moved_on": "2026-07-31",
        "holder_group": "Controlador ou Vinculado",
        "movement": "Venda à vista",
        "asset_type": "Ações",
        "security": "PN",
        "quantity": 3151700,
        "unit_price": 43.3529564997,
        "volume": 136635513.0001,
        "broker": null,
        "reference_month": "2026-07-01"
      },
      {
        "moved_on": "2026-07-30",
        "holder_group": "Controlador ou Vinculado",
        "movement": "Venda à vista",
        "asset_type": "Ações",
        "security": "PN",
        "quantity": 6952900,
        "unit_price": 42.4495131528,
        "volume": 295147220.0001,
        "broker": null,
        "reference_month": "2026-07-01"
      },
      {
        "moved_on": "2026-07-29",
        "holder_group": "Controlador ou Vinculado",
        "movement": "Venda à vista",
        "asset_type": "Ações",
        "security": "PN",
        "quantity": 3830200,
        "unit_price": 42.1698689363,
        "volume": 161519031.9998,
        "broker": null,
        "reference_month": "2026-07-01"
      }
    ],
    "holdings": [
      {
        "holder_group": "Conselho de Administração ou Vinculado",
        "asset_type": "Ações",
        "security": "ON",
        "quantity": 223273746,
        "month": "2026-08-01"
      },
      {
        "holder_group": "Conselho de Administração ou Vinculado",
        "asset_type": "Ações",
        "security": "PN",
        "quantity": 225,
        "month": "2026-08-01"
      },
      {
        "holder_group": "Conselho de Administração ou Vinculado",
        "asset_type": "Outros",
        "security": "ADR ORD",
        "quantity": 0,
        "month": "2026-08-01"
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Comissão de Valores Mobiliários (CVM)",
      "dataset": "Companhias abertas: documentos eventuais, negociação de administradores e formulário de referência",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://dados.cvm.gov.br/group/companhias"
    }
  }
}
```

## Fatos relevantes e comunicados

`GET https://api.fintay.com.br/v1/disclosures` · Empresas · https://fintay.com.br/docs/api/comunicados

Documentos entregues pelas companhias à CVM, classificados por assunto e relevância, com resumo quando disponível.

Parâmetros:

- `ticker` (query; string): Ticker da companhia.
- `cnpj` (query; string): CNPJ da companhia.
- `kind` (query; string): Tipos de documento separados por vírgula.
- `topic` (query; string): Assunto (ex.: `dividendos`, `aquisicao`, `recuperacao_judicial`).
- `min_materiality` (query; integer; padrão: 0): Relevância mínima, de 1 a 3.
- `q` (query; string): Texto buscado no assunto e no resumo.
- `since` (query; string): Entregues a partir desta data.
- `until` (query; string): Entregues até esta data.
- `listed_only` (query; boolean; padrão: false)
- `summarized` (query; boolean; padrão: false)
- `page` (query; integer; padrão: 1)
- `per_page` (query; integer; padrão: 50)

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "protocol": "009512IPE021020260197097062-40",
        "version": 1,
        "cnpj": "33000167000101",
        "company_name": "PETRÓLEO BRASILEIRO S.A. - PETROBRAS",
        "reference_date": "2026-10-02",
        "delivered_on": "2026-10-02",
        "category": "Comunicado ao Mercado",
        "doc_type": "Outros Comunicados Não Considerados Fatos Relevantes",
        "species": null,
        "subject": "Petrobras faz nova descoberta de petróleo em águas ultra profundas na costa do Amapá",
        "link": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&descTipo=IPE&CodigoInstituicao=1&numProtocolo=1573556&numSequencia=1098262&numVersao=1",
        "kind": "comunicado",
        "topics": [],
        "materiality": 1,
        "first_seen_at": "2026-10-05T17:39:59.923786+00:00",
        "tickers": [
          "PETR3",
          "PETR4"
        ],
        "assets": [
          {
            "ticker": "PETR3",
            "series_id": "0656231b-c8b4-41ad-81d9-1fafdb0e7e7d"
          },
          {
            "ticker": "PETR4",
            "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799"
          }
        ],
        "summary": null,
        "kind_label": "Comunicado ao mercado",
        "topic_labels": []
      },
      {
        "protocol": "009512IPE220920260194238117-81",
        "version": 1,
        "cnpj": "33000167000101",
        "company_name": "PETRÓLEO BRASILEIRO S.A. - PETROBRAS",
        "reference_date": "2026-09-22",
        "delivered_on": "2026-10-01",
        "category": "Comunicação sobre Transação entre Partes Relacionadas",
        "doc_type": null,
        "species": null,
        "subject": "Comunicação sobre Transação com Parte Relacionada: Petrobras x IFES (22/09/2026)",
        "link": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&descTipo=IPE&CodigoInstituicao=1&numProtocolo=1573470&numSequencia=1098176&numVersao=1",
        "kind": "partes_relacionadas",
        "topics": [],
        "materiality": 1,
        "first_seen_at": "2026-10-05T17:39:59.923786+00:00",
        "tickers": [
          "PETR3",
          "PETR4"
        ],
        "assets": [
          {
            "ticker": "PETR3",
            "series_id": "0656231b-c8b4-41ad-81d9-1fafdb0e7e7d"
          },
          {
            "ticker": "PETR4",
            "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799"
          }
        ],
        "summary": null,
        "kind_label": "Partes relacionadas",
        "topic_labels": []
      },
      {
        "protocol": "009512IPE300920260171822848-94",
        "version": 1,
        "cnpj": "33000167000101",
        "company_name": "PETRÓLEO BRASILEIRO S.A. - PETROBRAS",
        "reference_date": "2026-09-30",
        "delivered_on": "2026-09-30",
        "category": "Comunicado ao Mercado",
        "doc_type": "Outros Comunicados Não Considerados Fatos Relevantes",
        "species": null,
        "subject": "Petrobras recebe pagamento de novas parcelas do Programa de Subvenção Econômica da gasolina e do diesel",
        "link": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&descTipo=IPE&CodigoInstituicao=1&numProtocolo=1573013&numSequencia=1097719&numVersao=1",
        "kind": "comunicado",
        "topics": [],
        "materiality": 1,
        "first_seen_at": "2026-10-05T17:39:59.923786+00:00",
        "tickers": [
          "PETR3",
          "PETR4"
        ],
        "assets": [
          {
            "ticker": "PETR3",
            "series_id": "0656231b-c8b4-41ad-81d9-1fafdb0e7e7d"
          },
          {
            "ticker": "PETR4",
            "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799"
          }
        ],
        "summary": null,
        "kind_label": "Comunicado ao mercado",
        "topic_labels": []
      }
    ],
    "page": 1,
    "per_page": 50,
    "has_more": true,
    "updated_at": "2026-10-06T17:58:58.313979+00:00"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Comissão de Valores Mobiliários (CVM)",
      "dataset": "Companhias abertas: documentos eventuais, negociação de administradores e formulário de referência",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://dados.cvm.gov.br/group/companhias"
    }
  }
}
```

## Destaques dos comunicados

`GET https://api.fintay.com.br/v1/disclosures/highlights` · Empresas · https://fintay.com.br/docs/api/comunicados-destaques

Os comunicados mais relevantes do período, com o tom (positivo, negativo ou neutro) de cada um.

Parâmetros:

- `days` (query; integer; padrão: 30): Janela em dias.
- `ticker` (query; string): Restringe a uma companhia.
- `tone` (query; string; valores: positivo, negativo, neutro, misto): `positive`, `negative` ou `neutral`.
- `limit` (query; integer; padrão: 12): Máximo de itens.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "days": 30,
    "items": [
      {
        "protocol": "006700IPE300920260199862928-20",
        "version": 1,
        "cnpj": "33200049000147",
        "company_name": "HOTEIS OTHON S.A. - EM RECUPERAÇÃO JUDICIAL",
        "delivered_on": "2026-10-02",
        "subject": null,
        "link": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&descTipo=IPE&CodigoInstituicao=1&numProtocolo=1573572&numSequencia=1098278&numVersao=1",
        "kind": "recuperacao_judicial",
        "topics": [
          "recuperacao_judicial"
        ],
        "materiality": 3,
        "tickers": [
          "HOOT4"
        ],
        "assets": [
          {
            "ticker": "HOOT4",
            "series_id": "5a768e8d-1333-4779-98fc-05cd49e42569"
          }
        ],
        "summary": {
          "headline": "Hotéis Othon informa vendas de imóveis e andamento dos pagamentos na recuperação judicial",
          "summary": "No 93º Relatório Mensal de Atividades, a Administração Judicial relata que a Othon vendeu o terreno em Maceió por R$ 4 milhões e 40 lotes da Vila da Rainha por R$ 2,4 milhões, operações previamente autorizadas pelo juízo. As recuperandas informaram que, em junho, realizaram pagam…",
          "event_label": "Relatório mensal da recuperação judicial",
          "tone": "misto",
          "tone_reason": "As vendas de ativos e os pagamentos a credores avançam, mas o documento também aponta pendências de pagamentos e credores que ainda não informaram dados bancários.",
          "key_points": [
            "A venda do terreno em Maceió foi feita à Terra Investimentos; a companhia afirmou que o imóvel não era relevante para suas atividades.",
            "Os 40 lotes da Vila da Rainha foram vendidos à Incorporadora Santa Lydia.",
            "Os únicos estabelecimentos operacionais informados são Rio Othon Palace, Savoy Othon Lite e Quiosque Wave by Othon, no Rio de Janeiro."
          ],
          "figures": [
            {
              "label": "Venda do terreno em Maceió",
              "value": "R$ 4.000.000,00"
            },
            {
              "label": "Venda dos 40 lotes da Vila da Rainha",
              "value": "R$ 2.400.000,00"
            },
            {
              "label": "Empregados da HOSA em 31/08/2026",
              "value": "563 empregados"
            }
          ],
          "dates": [
            {
              "date": "2026-06-02",
              "label": "Expedição do alvará para venda do terreno em Maceió"
            },
            {
              "date": "2026-07-08",
              "label": "Escritura de venda dos lotes da Vila da Rainha"
            },
            {
              "date": "2026-08-31",
              "label": "Referência do quadro de empregados"
            }
          ],
          "parties": [
            "Administração Judicial",
            "Terra Investimentos Ltda.",
            "Incorporadora Santa Lydia Ltda."
          ]
        },
        "kind_label": "Recuperação judicial",
        "topic_labels": [
          "Recuperação judicial"
        ]
      },
      {
        "protocol": "011312IPE021020260186319796-48",
        "version": 1,
        "cnpj": "76535764000143",
        "company_name": "OI S.A. - EM RECUPERAÇÃO JUDICIAL",
        "delivered_on": "2026-10-02",
        "subject": "Cronograma de divulgação de informaçoes financeiras e periodicas",
        "link": "https://www.rad.cvm.gov.br/ENET/frmDownloadDocumento.aspx?Tela=ext&descTipo=IPE&CodigoInstituicao=1&numProtocolo=1573907&numSequencia=1098613&numVersao=1",
        "kind": "fato_relevante",
        "topics": [],
        "materiality": 3,
        "tickers": [
          "OIBR3",
          "OIBR4"
        ],
        "assets": [
          {
            "ticker": "OIBR3",
            "series_id": "a8941e4f-7024-46dd-b28a-041f3326fd06"
          },
          {
            "ticker": "OIBR4",
            "series_id": "5b6297f7-fc97-47ea-8a28-1a6404e14281"
          }
        ],
        "summary": {
          "headline": "Oi prevê divulgar informações financeiras e periódicas até 7 de outubro",
          "summary": "A Massa Falida de Oi pretende divulgar até 07.10.2026 o 3º ITR de 2025, as demonstrações financeiras de 2025 e o Formulário de Referência de 2026. A companhia também informou que iniciou os trabalhos para elaborar e divulgar os ITRs referentes ao primeiro e ao segundo trimestres…",
          "event_label": "Cronograma de divulgação financeira",
          "tone": "neutro",
          "tone_reason": "O comunicado atualiza prazos e trabalhos de divulgação, sem informar impacto financeiro ou mudança operacional.",
          "key_points": [
            "A divulgação prevista abrange informações financeiras e periódicas ainda pendentes.",
            "A companhia já iniciou a preparação dos ITRs dos períodos encerrados em março e junho de 2026.",
            "A recuperação judicial foi convertida em falência, confirmada pelo TJ-RJ em agosto de 2026."
          ],
          "figures": [],
          "dates": [
            {
              "date": "2025-09-30",
              "label": "Encerramento do período do 3º ITR 2025"
            },
            {
              "date": "2025-12-31",
              "label": "Encerramento do exercício social de 2025"
            },
            {
              "date": "2026-03-31",
              "label": "Encerramento do período do 1º ITR 2026"
            }
          ],
          "parties": [
            "Tribunal de Justiça do Estado do Rio de Janeiro",
            "Preserva-Ação Administração Judicial",
            "Pinto Machado Advogados Associados"
          ]
        },
        "kind_label": "Fato relevante",
        "topic_labels": []
      }
    ],
    "tones": {
      "misto": 3,
      "neutro": 4,
      "positivo": 1
    }
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Comissão de Valores Mobiliários (CVM)",
      "dataset": "Companhias abertas: documentos eventuais, negociação de administradores e formulário de referência",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://dados.cvm.gov.br/group/companhias"
    }
  }
}
```

## Buscar fundos

`GET https://api.fintay.com.br/v1/funds` · Fundos · https://fintay.com.br/docs/api/fundos-busca

Fundos de investimento registrados na CVM, com patrimônio, cotistas, data do último informe e situação.

Parâmetros:

- `search` (query; string): Nome ou CNPJ do fundo.
- `sort` (query; string; padrão: relevance): Ordenação: `relevance`, `aum` (patrimônio), `recent` ou `name`.
- `status` (query; string): Situação, separada por vírgula: `ativo`, `atrasado`, `dormente`, `encerrado`, `sem_dados`. `all` desliga o filtro.
- `min_pl` (query; number): Patrimônio líquido mínimo, em reais.
- `exclusivo` (query; boolean): Filtra fundos exclusivos (ou só os não exclusivos, com `false`).
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 50): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "cnpj_fundo": "07593972000186",
        "denominacao_fundo": "BRASILPREV TOP TPF FUNDO DE INVESTIMENTO FINANCEIRO RENDA FIXA RESPONSABILIDADE LIMITADA",
        "class_count": 1,
        "adapted_class_count": 1,
        "legacy_class_count": 0,
        "continuity_policy": "single_rcvm_class_inherits_legacy",
        "continuity_label": "Classe unica herda historico antigo",
        "latest_reference_date": "2026-10-01",
        "updated_at": "2026-09-21T21:14:08.038493Z",
        "data_status": "ativo",
        "quality_score": 85.69,
        "latest_pl": 283028182389.11,
        "latest_cotistas": 244,
        "days_since_last_data": 4,
        "exclusivo": false
      },
      {
        "cnpj_fundo": "42592315000115",
        "denominacao_fundo": "BB RENDA FIXA CURTO PRAZO AUTOMÁTICO FIC FIF RESPONSABILIDADE LIMITADA",
        "class_count": 1,
        "adapted_class_count": 1,
        "legacy_class_count": 0,
        "continuity_policy": "single_rcvm_class_inherits_legacy",
        "continuity_label": "Classe unica herda historico antigo",
        "latest_reference_date": "2026-10-01",
        "updated_at": "2026-09-21T21:14:08.038493Z",
        "data_status": "ativo",
        "quality_score": 98.15,
        "latest_pl": 189907135845.19,
        "latest_cotistas": 173898,
        "days_since_last_data": 4,
        "exclusivo": false
      }
    ],
    "total": 25359,
    "page": 1,
    "per_page": 2,
    "sort": "aum",
    "applied_statuses": [
      "ativo",
      "atrasado"
    ],
    "filtered_out": 56468,
    "search_widened": false,
    "base_date": "2026-10-02"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Detalhes e cotas de um fundo

`GET https://api.fintay.com.br/v1/funds/{cnpj_fundo}` · Fundos · https://fintay.com.br/docs/api/fundos-detalhe

Cadastro do fundo, suas classes e o informe diário: cota, patrimônio, captação, resgates e número de cotistas.

Parâmetros:

- `cnpj_fundo` (path; string; obrigatório): CNPJ do fundo, só números.
- `date_from` (query; string): Data inicial do informe diário.
- `date_to` (query; string): Data final do informe diário.
- `limit` (query; integer; padrão: 2000): Máximo de dias do informe.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "fund": {
      "cnpj_fundo": "07593972000186",
      "denominacao_fundo": "BRASILPREV TOP TPF FUNDO DE INVESTIMENTO FINANCEIRO RENDA FIXA RESPONSABILIDADE LIMITADA",
      "class_count": 1,
      "adapted_class_count": 1,
      "legacy_class_count": 0,
      "latest_reference_date": "2026-10-15",
      "latest_pl_total": 290161410856.82,
      "latest_cotistas_total": 252,
      "data_status": "ativo",
      "quality_score": 85.69,
      "days_since_last_data": 4,
      "base_date": "2026-10-02"
    },
    "continuity": {
      "policy": "single_rcvm_class_inherits_legacy",
      "label": "Classe unica herda historico antigo",
      "inherited_class_id": "2280a3d6-bf77-4728-bfcc-3f84aeb8a9ac",
      "legacy_source_class_ids": [],
      "explanation": "Como existe uma unica classe apos a adequacao, ela recebe o historico antigo do fundo na resposta especializada."
    },
    "classes": [
      {
        "class_id": "2280a3d6-bf77-4728-bfcc-3f84aeb8a9ac",
        "series_id": "2280a3d6-bf77-4728-bfcc-3f84aeb8a9ac",
        "cnpj_fundo": "07593972000186",
        "cnpj_classe": "07593972000186",
        "id_registro_fundo": "34079",
        "id_registro_classe": "1576",
        "codigo_cvm": "217441",
        "denominacao_fundo": "BRASILPREV TOP TPF FUNDO DE INVESTIMENTO FINANCEIRO RENDA FIXA RESPONSABILIDADE LIMITADA",
        "denominacao_classe": "BRASILPREV TOP TPF FUNDO DE INVESTIMENTO FINANCEIRO RENDA FIXA RESPONSABILIDADE LIMITADA",
        "tipo_fundo": "FI",
        "tipo_classe": "Classes de Cotas de Fundos FIF",
        "classificacao_cvm": "Renda Fixa",
        "classificacao_anbima": "Previdência RF Duração Baixa Soberano",
        "indicador_desempenho": "DI de um dia",
        "forma_condominio": "Aberto",
        "publico_alvo": "Profissional",
        "tributacao_longo_prazo": false,
        "classe_esg": false,
        "exclusivo": false,
        "entidade_investimento": null,
        "situacao": "Em Funcionamento Normal",
        "data_inicio": "2025-06-05",
        "data_inicio_situacao": "2025-06-05",
        "data_constituicao": "2025-06-05",
        "data_adaptacao_rcvm175": "2025-06-05",
        "first_seen_at": "2026-09-21",
        "updated_at": "2026-09-21T21:14:08.038493Z",
        "is_legacy_single_class": false,
        "inherits_legacy_history": true,
        "continuity_role": "primary_rcvm_class",
        "continuity_label": "Classe principal com historico antigo",
        "legacy_source_class_ids": [],
        "own_first_date": "2026-05-04",
        "own_last_date": "2026-10-15",
        "displayed_first_date": "2026-10-13",
        "displayed_last_date": "2026-10-15",
        "own_points_count": 116,
        "displayed_points_count": 3,
        "latest": {
          "reference_date": "2026-10-15",
          "vl_total": 290161454042.96,
          "vl_patrim_liq": 290161410856.82,
          "vl_quota": 8.536895,
          "vl_captado": null,
          "vl_resgat": null,
          "nr_cotst": 252,
          "regime": "RCVM175",
          "source_class_id": "2280a3d6-bf77-4728-bfcc-3f84aeb8a9ac",
          "source_cnpj_classe": "07593972000186",
          "continuity_segment": "class"
        },
        "providers": {
          "administrador": "BB GESTAO DE RECURSOS DTVM S.A",
          "cnpj_administrador": "30822936000169",
          "gestor": "BB GESTAO DE RECURSOS DTVM S.A",
          "cpf_cnpj_gestor": "30822936000169",
          "tipo_pessoa_gestor": "PJ",
          "custodiante": "BANCO DO BRASIL S.A.",
          "cnpj_custodiante": "00000000000191",
          "controlador": "BANCO DO BRASIL S.A.",
          "cnpj_controlador": "00000000000191",
          "auditor": "DELOITTE TOUCHE TOHMATSU AUDITORES INDEPENDENTES LTDA.",
          "cnpj_auditor": "49928567000111",
          "diretor": "DANIEL ALMEIDA BOGADO LEITE"
        },
        "points": [
          {
            "reference_date": "2026-10-13",
            "vl_total": 289939222223.06,
            "vl_patrim_liq": 289938853691.35,
            "vl_quota": 8.530147,
            "vl_captado": null,
            "vl_resgat": null,
            "nr_cotst": 252,
            "regime": "RCVM175",
            "source_class_id": "2280a3d6-bf77-4728-bfcc-3f84aeb8a9ac",
            "source_cnpj_classe": "07593972000186",
            "continuity_segment": "class"
          },
          {
            "reference_date": "2026-10-14",
            "vl_total": 290031834280.59,
            "vl_patrim_liq": 290031467361.58,
            "vl_quota": 8.533127,
            "vl_captado": null,
            "vl_resgat": null,
            "nr_cotst": 252,
            "regime": "RCVM175",
            "source_class_id": "2280a3d6-bf77-4728-bfcc-3f84aeb8a9ac",
            "source_cnpj_classe": "07593972000186",
            "continuity_segment": "class"
          },
          {
            "reference_date": "2026-10-15",
            "vl_total": 290161454042.96,
            "vl_patrim_liq": 290161410856.82,
            "vl_quota": 8.536895,
            "vl_captado": null,
            "vl_resgat": null,
            "nr_cotst": 252,
            "regime": "RCVM175",
            "source_class_id": "2280a3d6-bf77-4728-bfcc-3f84aeb8a9ac",
            "source_cnpj_classe": "07593972000186",
            "continuity_segment": "class"
          }
        ]
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Carteira de um fundo

`GET https://api.fintay.com.br/v1/funds/{cnpj}/portfolio` · Fundos · https://fintay.com.br/docs/api/fundos-carteira

Posições da carteira aberta (CDA) de um fundo numa competência: ativo, emissor, quantidade e valor de mercado.

Parâmetros:

- `cnpj` (path; string; obrigatório): CNPJ do fundo ou da classe.
- `competence` (query; string; obrigatório): Mês da carteira, no primeiro dia (AAAA-MM-01). As carteiras saem com cerca de 90 dias de defasagem.
- `limit` (query; integer; padrão: 100): Máximo de posições.
- `offset` (query; integer; padrão: 0): Posições a pular.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 1277,
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "competencia": "2026-08-01",
        "bloco": "1",
        "tp_aplic": "Operações Compromissadas",
        "tp_ativo": "Título público federal",
        "emissor_cnpj": null,
        "emissor_nome": null,
        "isin": "BRSTNCLTN897",
        "codigo_ativo": null,
        "vl_merc_pos_final": 3727291209.71,
        "pct_pna": null,
        "archive_id": "779e7659-8c47-4ce6-83ed-9b7b17355cbd",
        "source_file": "cda_fi_BLC_1_202608.csv",
        "row_number": 4114
      },
      {
        "id": 1278,
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "competencia": "2026-08-01",
        "bloco": "1",
        "tp_aplic": "Operações Compromissadas",
        "tp_ativo": "Título público federal",
        "emissor_cnpj": null,
        "emissor_nome": null,
        "isin": "BRSTNCLTN806",
        "codigo_ativo": null,
        "vl_merc_pos_final": 6163960615.8,
        "pct_pna": null,
        "archive_id": "779e7659-8c47-4ce6-83ed-9b7b17355cbd",
        "source_file": "cda_fi_BLC_1_202608.csv",
        "row_number": 4115
      },
      {
        "id": 1279,
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "competencia": "2026-08-01",
        "bloco": "1",
        "tp_aplic": "Operações Compromissadas",
        "tp_ativo": "Título público federal",
        "emissor_cnpj": null,
        "emissor_nome": null,
        "isin": "BRSTNCLTN8A7",
        "codigo_ativo": null,
        "vl_merc_pos_final": 1054913149.23,
        "pct_pna": null,
        "archive_id": "779e7659-8c47-4ce6-83ed-9b7b17355cbd",
        "source_file": "cda_fi_BLC_1_202608.csv",
        "row_number": 4116
      }
    ],
    "has_more": true,
    "offset": 0,
    "note": "Posições públicas; posições confidenciais não são estimadas."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Buscar gestoras

`GET https://api.fintay.com.br/v1/funds/managers` · Fundos · https://fintay.com.br/docs/api/fundos-gestoras

Gestoras de recursos com patrimônio sob gestão e quantidade de fundos.

Parâmetros:

- `search` (query; string): Nome ou CNPJ da gestora.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 50): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "manager_id": "30822936000169",
        "name": "BB GESTAO DE RECURSOS DTVM S.A",
        "document": "30822936000169",
        "aum_total": 2007729747123.52,
        "aum_gross": 2640046184580.22,
        "aum_internal": 632316437456.7,
        "fund_count": 918,
        "class_count": 918,
        "class_count_inactive": 875,
        "latest_reference_date": "2026-10-02",
        "updated_at": "2026-09-21T21:14:08.038493Z"
      },
      {
        "manager_id": "40430971000196",
        "name": "ITAU UNIBANCO ASSET MANAGEMENT LTDA.",
        "document": "40430971000196",
        "aum_total": 1423419466981.68,
        "aum_gross": 2268516829686.9,
        "aum_internal": 845097362705.22,
        "fund_count": 3458,
        "class_count": 3458,
        "class_count_inactive": 1017,
        "latest_reference_date": "2026-10-02",
        "updated_at": "2026-09-21T21:14:08.038493Z"
      }
    ],
    "total": 2022,
    "page": 1,
    "per_page": 2
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Captação líquida da indústria

`GET https://api.fintay.com.br/v1/funds/flows` · Fundos · https://fintay.com.br/docs/api/fundos-fluxo

Captação e resgates mensais dos fundos, agrupados por categoria ou gestora.

Parâmetros:

- `agrupar` (query; string; padrão: categoria; valores: categoria, anbima, gestor): Agrupamento: categoria, classe ANBIMA ou gestora.
- `meses` (query; integer; padrão: 12): Quantidade de meses.
- `incluir_fic` (query; boolean; padrão: false): Inclui fundos de cotas (pode contar o mesmo dinheiro duas vezes).
- `categoria` (query; string): Restringe a uma categoria.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "group_by": "categoria",
    "months": [
      "2026-08-01",
      "2026-09-01",
      "2026-10-01"
    ],
    "last_month": "2026-10-01",
    "last_day": "2026-10-16",
    "partial_last_month": true,
    "include_fic": false,
    "categoria": null,
    "groups": [
      {
        "group": "FAPI",
        "captado": 0,
        "resgatado": 0,
        "net": 0,
        "net_by_month": [
          0,
          0,
          0
        ],
        "pl_end": 1031496007.33,
        "funds": 13,
        "net_pct_pl": 0
      },
      {
        "group": "Multimercado",
        "captado": 0,
        "resgatado": 0,
        "net": 0,
        "net_by_month": [
          0,
          0,
          0
        ],
        "pl_end": 2004490289223.34,
        "funds": 9026,
        "net_pct_pl": 0
      },
      {
        "group": "Ações",
        "captado": 0,
        "resgatado": 0,
        "net": 0,
        "net_by_month": [
          0,
          0,
          0
        ],
        "pl_end": 629906555549.88,
        "funds": 2802,
        "net_pct_pl": 0
      }
    ],
    "totals": {
      "net_by_month": [
        0,
        0,
        0
      ],
      "captado": 0,
      "resgatado": 0,
      "pl_end": 10725373704575.97,
      "net": 0
    },
    "top_in": [],
    "top_out": []
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Listar FIIs

`GET https://api.fintay.com.br/v1/fiis` · Fundos · https://fintay.com.br/docs/api/fiis-lista

Fundos imobiliários com o informe mensal mais recente entregue à CVM.

Parâmetros:

- `limit` (query; integer; padrão: 50): Máximo de fundos.
- `offset` (query; integer; padrão: 0): Fundos a pular.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "cnpj": "00332266000131",
        "reference_date": "2026-08-01",
        "document_version": 1,
        "payload": {
          "Site": "www.hedgeinvest.com.br",
          "Cidade": "SÃO PAULO",
          "Estado": "SP",
          "Numero": "3600",
          "Versao": "1",
          "Mandato": "",
          "Codigo_ISIN": "BRFVPQCTF015",
          "Complemento": "11º ANDAR CJ 112",
          "Tipo_Gestao": "Definida",
          "Data_Entrega": "2026-09-14",
          "Publico_Alvo": "INVESTIDORES EM GERAL",
          "Prazo_Duracao": "Indeterminado",
          "Data_Referencia": "2026-08-01",
          "Fundo_Exclusivo": "N",
          "Segmento_Atuacao": "Shoppings",
          "CNPJ_Fundo_Classe": "00.332.266/0001-31",
          "Nome_Fundo_Classe": "VIA PARQUE SHOPPING FII RESP LTDA",
          "Tipo_Fundo_Classe": "Classe",
          "CNPJ_Administrador": "07253654000176",
          "Data_Funcionamento": "1994-11-24",
          "Data_Prazo_Duracao": "",
          "Nome_Administrador": "HEDGE INVESTMENTS DTVM LTDA",
          "Mercado_Negociacao_MB": "N",
          "Mercado_Negociacao_MBO": "N",
          "Mercado_Negociacao_Bolsa": "S",
          "Cotistas_Vinculo_Familiar": "N",
          "Quantidade_Cotas_Emitidas": "2800149",
          "Entidade_Administradora_BVMF": "S",
          "Encerramento_Exercicio_Social": "31/12",
          "Entidade_Administradora_CETIP": "N"
        }
      }
    ],
    "has_more": true,
    "offset": 0
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Informe mensal de um FII

`GET https://api.fintay.com.br/v1/fiis/{identity}/monthly` · Fundos · https://fintay.com.br/docs/api/fiis-mensal

Indicadores mensais de um fundo imobiliário: patrimônio, valor patrimonial da cota, rendimentos distribuídos e cotistas.

Parâmetros:

- `identity` (path; string; obrigatório): Ticker (ex.: `HGLG11`) ou CNPJ do fundo.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "cnpj": "11728688000147",
    "items": [
      {
        "competencia": "2021-01-01",
        "vl_patrim_liq": 2723229847.46,
        "vl_quota": 147.70487182,
        "nr_cotst": 270351
      },
      {
        "competencia": "2021-02-01",
        "vl_patrim_liq": 2718769806.08,
        "vl_quota": 147.46296428,
        "nr_cotst": 275634
      },
      {
        "competencia": "2021-03-01",
        "vl_patrim_liq": 2709068264.88,
        "vl_quota": 146.93676378,
        "nr_cotst": 277168
      }
    ],
    "note": "Cota patrimonial do informe, não cotação de bolsa. Não representa rendimento efetivamente pago."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Fundos que têm um ativo

`GET https://api.fintay.com.br/v1/assets/{series_id}/fund-holders` · Fundos · https://fintay.com.br/docs/api/fundos-que-compram

Fundos que carregam um ativo na carteira, com valor e participação no patrimônio de cada um.

Parâmetros:

- `series_id` (path; string; obrigatório): Identificador da série do ativo (ex.: o de `b3/PETR4`).
- `competence` (query; string): Mês da carteira. Padrão: o mais recente.
- `limit` (query; integer; padrão: 50): Máximo de fundos.
- `offset` (query; integer; padrão: 0): Fundos a pular.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "ticker": "PETR4",
    "competence": "2026-08-01",
    "competences": [
      "2026-08-01"
    ],
    "summary": {
      "total_holders": 309,
      "long_holders": 289,
      "long_total": 7325998572.54,
      "short_holders": 27,
      "short_total": 2517643952.17
    },
    "items": [
      {
        "class_id": "6138ebe8-8a03-4e32-bd79-4423994e9ce3",
        "cnpj_fundo": "08771962000156",
        "cnpj_classe": "08771962000156",
        "name": "OITI FIF MULTIMERCADO CRÉDITO PRIVADO INVESTIMENTO NO EXTERIOR RESPONSABILIDADE LIMITADA",
        "gestor": "ITAU UNIBANCO S.A.",
        "long_value": 1287710976.74,
        "lent_value": null,
        "short_value": 1865509857.16,
        "pl": 33934150456.12,
        "pct_pl_long": 3.7947346830006237,
        "pct_pl_short": 5.4974408732355835
      },
      {
        "class_id": "2a65aa80-d6b9-4724-b593-49112824d4eb",
        "cnpj_fundo": "08935128000159",
        "cnpj_classe": "08935128000159",
        "name": "GERAÇÃO L. PAR FUNDO DE INVESTIMENTO FINANCEIRO DE AÇÕES DE RESPONSABILIDADE LIMITADA",
        "gestor": "PLURAL INVESTIMENTOS GESTÃO DE RECURSOS LTDA.",
        "long_value": 1170520000,
        "lent_value": 270838744.3,
        "short_value": null,
        "pl": 6114104294.75,
        "pct_pl_long": 19.144586738651004,
        "pct_pl_short": null
      },
      {
        "class_id": "76be3ac4-3462-4d3d-ad0f-077ba65b15d7",
        "cnpj_fundo": "09625909000100",
        "cnpj_classe": "09625909000100",
        "name": "ARTESANAL D+2 FUNDO DE INVESTIMENTO MULTIMERCADO",
        "gestor": "ARTESANAL INVESTIMENTOS LTDA",
        "long_value": 1062724112,
        "lent_value": null,
        "short_value": null,
        "pl": 3535997837.24,
        "pct_pl_long": 30.054433314628447,
        "pct_pl_short": null
      }
    ],
    "has_more": true,
    "offset": 0
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Títulos do Tesouro Direto

`GET https://api.fintay.com.br/v1/fixed-income/tesouro` · Tesouro e renda fixa · https://fintay.com.br/docs/api/tesouro-titulos

Títulos vivos (e, se pedido, vencidos) com taxa e preço de compra e venda do último dia.

Parâmetros:

- `indexador` (query; string): `SELIC`, `PRE`, `IPCA` ou `IGPM`.
- `tipo` (query; string): `LFT`, `LTN`, `NTNF`, `NTNB`, `NTNB_PRINC`, `NTNC`, `RENDA` ou `EDUCA`.
- `search` (query; string): Parte do nome comercial (ex.: `2035`).
- `vencidos` (query; boolean; padrão: false): Inclui títulos já vencidos.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 100): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "codigo": "NTNB_PRINC_2029-05-15",
        "series_id": "ada1ce03-7ed9-41fc-bd06-e4e7abddd9d8",
        "nome_comercial": "Tesouro IPCA+ 2029",
        "tipo_titulo": "Tesouro IPCA+",
        "tipo_codigo": "NTNB_PRINC",
        "indexador": "IPCA",
        "data_vencimento": "2029-05-15",
        "tem_juros_semestrais": false,
        "is_vencido": false,
        "first_date": "2023-01-09",
        "last_date": "2026-09-18",
        "latest": {
          "reference_date": "2026-09-18",
          "taxa_compra": 7.37,
          "taxa_venda": 7.49,
          "pu_compra": 3928.6,
          "pu_venda": 3913.82,
          "pu_base": 3913.82
        }
      },
      {
        "codigo": "NTNB_2030-08-15",
        "series_id": "1ef58cd4-6a18-4fcd-bcea-f4ab732bc595",
        "nome_comercial": "Tesouro IPCA+ com Juros Semestrais 2030",
        "tipo_titulo": "Tesouro IPCA+ com Juros Semestrais",
        "tipo_codigo": "NTNB",
        "indexador": "IPCA",
        "data_vencimento": "2030-08-15",
        "tem_juros_semestrais": true,
        "is_vencido": false,
        "first_date": "2020-02-10",
        "last_date": "2026-09-18",
        "latest": {
          "reference_date": "2026-09-18",
          "taxa_compra": 7.5,
          "taxa_venda": 7.62,
          "pu_compra": 4541.32,
          "pu_venda": 4519.89,
          "pu_base": 4519.89
        }
      }
    ],
    "total": 42,
    "page": 1,
    "per_page": 2,
    "base_date": "2026-09-18"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Tesouro Nacional",
      "dataset": "Taxas dos Titulos Ofertados pelo Tesouro Direto",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://www.tesourotransparente.gov.br/ckan/dataset/taxas-dos-titulos-ofertados-pelo-tesouro-direto"
    }
  }
}
```

## Histórico de um título

`GET https://api.fintay.com.br/v1/fixed-income/tesouro/{codigo}/quotes` · Tesouro e renda fixa · https://fintay.com.br/docs/api/tesouro-historico

Taxas e preços diários de um título do Tesouro Direto desde a primeira negociação.

Parâmetros:

- `codigo` (path; string; obrigatório): Código do título, como em `/v1/fixed-income/tesouro` (ex.: `NTNB_PRINC_2029-05-15`).
- `date_from` (query; string): Data inicial.
- `date_to` (query; string): Data final.
- `limit` (query; integer; padrão: 5000): Máximo de dias.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "titulo": {
      "codigo": "NTNB_PRINC_2029-05-15",
      "series_id": "ada1ce03-7ed9-41fc-bd06-e4e7abddd9d8",
      "nome_comercial": "Tesouro IPCA+ 2029",
      "tipo_titulo": "Tesouro IPCA+",
      "tipo_codigo": "NTNB_PRINC",
      "indexador": "IPCA",
      "data_vencimento": "2029-05-15",
      "tem_juros_semestrais": false,
      "is_vencido": false,
      "first_date": "2023-01-09",
      "last_date": "2026-09-18",
      "latest": {
        "reference_date": "2026-09-18",
        "taxa_compra": 7.37,
        "taxa_venda": 7.49,
        "pu_compra": 3928.6,
        "pu_venda": 3913.82,
        "pu_base": 3913.82
      }
    },
    "points": [
      {
        "reference_date": "2026-09-16",
        "taxa_compra": 7.47,
        "taxa_venda": 7.59,
        "pu_compra": 3913.88,
        "pu_venda": 3900.56,
        "pu_base": 3900.56
      },
      {
        "reference_date": "2026-09-17",
        "taxa_compra": 7.43,
        "taxa_venda": 7.55,
        "pu_compra": 3919.56,
        "pu_venda": 3906.24,
        "pu_base": 3906.24
      },
      {
        "reference_date": "2026-09-18",
        "taxa_compra": 7.37,
        "taxa_venda": 7.49,
        "pu_compra": 3928.6,
        "pu_venda": 3913.82,
        "pu_base": 3913.82
      }
    ],
    "total": 923
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Tesouro Nacional",
      "dataset": "Taxas dos Titulos Ofertados pelo Tesouro Direto",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://www.tesourotransparente.gov.br/ckan/dataset/taxas-dos-titulos-ofertados-pelo-tesouro-direto"
    }
  }
}
```

## Curva do Tesouro

`GET https://api.fintay.com.br/v1/fixed-income/tesouro/curva` · Tesouro e renda fixa · https://fintay.com.br/docs/api/tesouro-curva

Taxas de compra dos títulos de um indexador por vencimento, numa data.

Parâmetros:

- `date` (query; string): Data. Padrão: a mais recente.
- `indexador` (query; string): `PRE`, `IPCA` ou `SELIC`.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "reference_date": "2026-09-18",
    "indexador": "IPCA",
    "points": [
      {
        "codigo": "NTNB_PRINC_2029-05-15",
        "nome_comercial": "Tesouro IPCA+ 2029",
        "data_vencimento": "2029-05-15",
        "prazo_anos": 2.66,
        "taxa_compra": 7.37,
        "taxa_venda": 7.49,
        "pu_base": 3913.82
      },
      {
        "codigo": "NTNB_2030-08-15",
        "nome_comercial": "Tesouro IPCA+ com Juros Semestrais 2030",
        "data_vencimento": "2030-08-15",
        "prazo_anos": 3.91,
        "taxa_compra": 7.5,
        "taxa_venda": 7.62,
        "pu_base": 4519.89
      },
      {
        "codigo": "EDUCA_2030-12-15",
        "nome_comercial": "Tesouro Educa+ 2030",
        "data_vencimento": "2030-12-15",
        "prazo_anos": 4.24,
        "taxa_compra": 7.31,
        "taxa_venda": 7.43,
        "pu_base": 3463.3
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Tesouro Nacional",
      "dataset": "Taxas dos Titulos Ofertados pelo Tesouro Direto",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://www.tesourotransparente.gov.br/ckan/dataset/taxas-dos-titulos-ofertados-pelo-tesouro-direto"
    }
  }
}
```

## Inflação implícita

`GET https://api.fintay.com.br/v1/fixed-income/inflacao-implicita` · Tesouro e renda fixa · https://fintay.com.br/docs/api/inflacao-implicita

Inflação implícita por vencimento, da diferença entre as taxas prefixadas e as atreladas ao IPCA.

Parâmetros:

- `data` (query; string): Data. Padrão: a mais recente.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "data": "2026-09-18",
    "sessao_di": "2026-09-18",
    "pontos": [
      {
        "codigo": "NTNB_PRINC_2029-05-15",
        "nome": "Tesouro IPCA+ 2029",
        "tipo": "NTNB_PRINC",
        "vencimento": "2029-05-15",
        "du": 661,
        "anos": 2.62,
        "juro_real": 7.37,
        "juro_nominal": 13.910995742728316,
        "inflacao_implicita": 6.092014289585834,
        "aproximado": false,
        "fora_da_curva": false
      },
      {
        "codigo": "NTNB_2030-08-15",
        "nome": "Tesouro IPCA+ com Juros Semestrais 2030",
        "tipo": "NTNB",
        "vencimento": "2030-08-15",
        "du": 975,
        "anos": 3.87,
        "juro_real": 7.5,
        "juro_nominal": 14.011719814923818,
        "inflacao_implicita": 6.057413781324494,
        "aproximado": true,
        "fora_da_curva": false
      },
      {
        "codigo": "NTNB_2032-08-15",
        "nome": "Tesouro IPCA+ com Juros Semestrais 2032",
        "tipo": "NTNB",
        "vencimento": "2032-08-15",
        "du": 1479,
        "anos": 5.87,
        "juro_real": 7.55,
        "juro_nominal": 14.136026743141649,
        "inflacao_implicita": 6.123688278141937,
        "aproximado": true,
        "fora_da_curva": false
      }
    ],
    "unidade": "% a.a."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Leilões de títulos públicos

`GET https://api.fintay.com.br/v1/fixed-income/leiloes` · Tesouro e renda fixa · https://fintay.com.br/docs/api/tesouro-leiloes

Resultados dos leilões do Tesouro Nacional: título, quantidade ofertada e aceita, taxa e financeiro.

Parâmetros:

- `bond` (query; string): Título: `LTN`, `NTN-F`, `NTN-B` ou `LFT`.
- `tipo` (query; string): Tipo do leilão: venda, compra ou troca.
- `since` (query; string): A partir desta data.
- `until` (query; string): Até esta data.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 100): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "auction_date": "2026-10-01",
        "bond": "LTN",
        "auction_type": "Venda",
        "round": "1.ª volta",
        "settlement_date": "2026-10-02",
        "maturity_date": "2027-04-01",
        "offered_qty": 10000000,
        "accepted_qty": 10000000,
        "accepted_amount": 9414953030.99,
        "avg_rate": 13.3776,
        "cutoff_rate": 13.3913,
        "bcb_qty": 0,
        "bcb_amount": 0,
        "fill_ratio": 1
      },
      {
        "auction_date": "2026-10-01",
        "bond": "LTN",
        "auction_type": "Venda",
        "round": "2.ª volta",
        "settlement_date": "2026-10-05",
        "maturity_date": "2027-04-01",
        "offered_qty": 2500000,
        "accepted_qty": 2159998,
        "accepted_amount": 2034641915.54,
        "avg_rate": 13.3776,
        "cutoff_rate": 13.3776,
        "bcb_qty": 0,
        "bcb_amount": 0,
        "fill_ratio": 0.8639992
      }
    ],
    "page": 1,
    "has_more": true
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Tesouro Nacional",
      "dataset": "Resultado dos leilões da Dívida Pública Mobiliária Federal Interna",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://www.tesourotransparente.gov.br/ckan/dataset/ds013"
    }
  }
}
```

## Ofertas de debêntures, CRI e CRA

`GET https://api.fintay.com.br/v1/fixed-income/credito` · Tesouro e renda fixa · https://fintay.com.br/docs/api/credito-ofertas

Ofertas registradas na CVM com emissor, série, prazo, remuneração, garantias e a faixa de risco do emissor.

Parâmetros:

- `classe` (query; string; valores: DEBENTURE, CRI, CRA): `DEBENTURE`, `CRI` ou `CRA`.
- `origem` (query; string; valores: distribuicao, resolucao_160): Regime da oferta.
- `busca` (query; string): Emissor ou código.
- `faixa_max` (query; integer): Faixa de risco máxima do emissor, de 1 (menor risco) a 10.
- `garantia` (query; string; valores: real, flutuante, quirografaria, subordinada): Tipo de garantia.
- `incentivada` (query; boolean): Só debêntures incentivadas.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 50): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "record_id": "d0c7a70ba335d05ebfa95fd270c3d38964f4f1430f87e120c150ebde965ee2ec",
        "credit_class": "DEBENTURE",
        "source_file": "oferta_resolucao_160.csv",
        "issuer_cnpj": "21314559000166",
        "issuer_name": "MOVIDA PARTICIPAÇÕES S.A.",
        "process_number": "SRE/3049/2026",
        "registration_number": null,
        "request_number": "27999",
        "issuance": "29",
        "series": null,
        "issued_on": null,
        "matures_on": null,
        "registered_on": "2026-09-24",
        "offer_status": "Registro Concedido",
        "especie": null,
        "incentivada": false,
        "risco_faixa": 6,
        "risco_pd": 0.015180186891261063,
        "risco_default": false,
        "emissor_ticker": "MOVI3"
      }
    ],
    "total": 7115,
    "page": 1,
    "per_page": 1,
    "source_updated_at": "2026-09-28T05:00:12.980770Z"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "Comissão de Valores Mobiliários (CVM)",
      "dataset": "Ofertas Públicas de Distribuição",
      "license": "ODbL 1.0",
      "license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "source_url": "https://dados.cvm.gov.br/dataset/oferta-distrib"
    }
  }
}
```

## ETTJ ANBIMA

`GET https://api.fintay.com.br/v1/fixed-income/anbima/ettj` · Tesouro e renda fixa · https://fintay.com.br/docs/api/anbima-ettj

Estrutura a termo das taxas de juros publicada pela ANBIMA: curvas prefixada, real e inflação implícita por vértice em dias úteis.

Parâmetros:

- `reference_date` (query; string): Data. Sem data ou intervalo, devolve a mais recente.
- `date_from` (query; string): Início do intervalo.
- `date_to` (query; string): Fim do intervalo.
- `dates` (query; string): Até 30 datas separadas por vírgula, alternativa ao intervalo.
- `curve` (query; string): `PREF`, `IPCA` ou `INFL`; aceita lista separada por vírgula.
- `resolution` (query; string; padrão: grid; valores: grid, daily): `grid` (vértices publicados) ou `daily` (um ponto por dia útil).
- `vertex_min` (query; integer): Menor vértice, em dias úteis.
- `vertex_max` (query; integer): Maior vértice, em dias úteis.
- `page` (query; integer; padrão: 1)
- `per_page` (query; integer; padrão: 1000)

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "reference_date": "2026-10-06",
    "resolution": "grid",
    "unit": "% a.a. / 252 d.u.",
    "points": [
      {
        "reference_date": "2026-10-06",
        "curve": "PREF",
        "vertex_du": 252,
        "rate": "12.6285"
      },
      {
        "reference_date": "2026-10-06",
        "curve": "PREF",
        "vertex_du": 378,
        "rate": "12.4985"
      },
      {
        "reference_date": "2026-10-06",
        "curve": "PREF",
        "vertex_du": 504,
        "rate": "12.4902"
      }
    ],
    "total": 3,
    "page": 1,
    "per_page": 1000
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "ANBIMA",
      "source_url": "https://www.anbima.com.br/informacoes/"
    }
  }
}
```

## Taxas indicativas de títulos públicos

`GET https://api.fintay.com.br/v1/fixed-income/anbima/titulos-publicos` · Tesouro e renda fixa · https://fintay.com.br/docs/api/anbima-titulos-publicos

Taxas indicativas, PU e intervalos de negociação dos títulos públicos federais divulgados pela ANBIMA.

Parâmetros:

- `reference_date` (query; string): Data. Padrão: a mais recente.
- `date_from` (query; string): Início do intervalo.
- `date_to` (query; string): Fim do intervalo.
- `bond` (query; string; valores: LTN, LFT, NTN-B, NTN-C, NTN-F): Título (ex.: `NTN-B`, `LTN`).
- `selic_code` (query; string): Código Selic do título.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 100): Itens por página.
- `include_raw` (query; boolean; padrão: false): Inclui os campos originais da publicação.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "reference_date": "2026-10-06",
    "items": [
      {
        "reference_date": "2026-10-06",
        "bond": "NTN-B",
        "selic_code": "760199",
        "base_date": "2000-07-15",
        "maturity_date": "2027-05-15",
        "buy_rate": "5.59",
        "sell_rate": "5.5533",
        "indicative_rate": "5.5778",
        "pu": "4876.462105",
        "standard_deviation": "0.00363719213955",
        "interval_min_d0": "5.0846",
        "interval_max_d0": "6.0368",
        "interval_min_d1": "5.1315",
        "interval_max_d1": "6.0924",
        "criterion": "Calculado",
        "remaining_calendar_days": 221
      },
      {
        "reference_date": "2026-10-06",
        "bond": "NTN-B",
        "selic_code": "760199",
        "base_date": "2000-07-15",
        "maturity_date": "2028-08-15",
        "buy_rate": "6.9324",
        "sell_rate": "6.8912",
        "indicative_rate": "6.9069",
        "pu": "4723.42849",
        "standard_deviation": "0.00395695589943",
        "interval_min_d0": "6.744",
        "interval_max_d0": "7.191",
        "interval_min_d1": "6.6728",
        "interval_max_d1": "7.1194",
        "criterion": "Calculado",
        "remaining_calendar_days": 679
      }
    ],
    "total": 14,
    "page": 1,
    "per_page": 2
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json",
    "attribution": {
      "source": "ANBIMA",
      "source_url": "https://www.anbima.com.br/informacoes/"
    }
  }
}
```

## Curva DI

`GET https://api.fintay.com.br/v1/curves/di` · Juros e curvas · https://fintay.com.br/docs/api/curva-di

Curva de juros prefixada pelos ajustes do futuro de DI1, com os vencimentos negociados e a curva interpolada. Compare várias datas na mesma chamada.

Parâmetros:

- `periods` (query; string): Intervalos relativos ao último pregão, separados por vírgula: `d0` (último), `d1`, `d5`, `w1`, `w2`, `m1`, `m3`, `m6`, `y1`.
- `dates` (query; string): Pregões específicos separados por vírgula, como em `/v1/curves/di/dates`.
- `as_of` (query; string): Pregão de referência.
- `compare` (query; string): Segundo pregão para comparar.
- `spacing` (query; string; padrão: all; valores: all, annual, semiannual, monthly): Vértices: `all` (todos os vencimentos), `annual`, `semiannual` ou `monthly`.
- `method` (query; string; padrão: flat_forward; valores: flat_forward, linear, cubic): Interpolação: `flat_forward` (padrão de mercado), `linear` ou `cubic`.
- `min_volume` (query; integer; padrão: 0): Descarta vencimentos com volume abaixo deste número de contratos.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "snapshots": [
      {
        "as_of": "2026-09-25",
        "period": "Último",
        "observed": [
          {
            "contract": "futures:DI1V26",
            "expiration_date": "2026-10-01",
            "rate": 13.653,
            "settlement": 99797.06,
            "close": 13.653,
            "volume": 142856,
            "observed_at": "2026-09-25T00:00:00+00:00",
            "session_date": "2026-09-25"
          },
          {
            "contract": "futures:DI1X26",
            "expiration_date": "2026-11-03",
            "rate": 13.655,
            "settlement": 98738.21,
            "close": 13.655,
            "volume": 91800,
            "observed_at": "2026-09-25T00:00:00+00:00",
            "session_date": "2026-09-25"
          },
          {
            "contract": "futures:DI1Z26",
            "expiration_date": "2026-12-01",
            "rate": 13.584,
            "settlement": 97800.58,
            "close": 13.585,
            "volume": 37457,
            "observed_at": "2026-09-25T00:00:00+00:00",
            "session_date": "2026-09-25"
          }
        ],
        "curve": [
          {
            "maturity": "2027-09-25",
            "business_days": 250,
            "years": 0.9921,
            "rate": 13.60887,
            "kind": "intermediate",
            "observed": false
          },
          {
            "maturity": "2028-09-25",
            "business_days": 500,
            "years": 1.9841,
            "rate": 13.780347,
            "kind": "intermediate",
            "observed": false
          },
          {
            "maturity": "2029-09-25",
            "business_days": 749,
            "years": 2.9722,
            "rate": 13.894598,
            "kind": "intermediate",
            "observed": false
          }
        ],
        "removed_contracts": 0,
        "stale_contracts": 0
      },
      {
        "as_of": "2026-08-25",
        "period": "1 mês",
        "observed": [
          {
            "contract": "futures:DI1V26",
            "expiration_date": "2026-10-01",
            "rate": 13.818,
            "settlement": 98673.48,
            "close": 13.818,
            "volume": 594908,
            "observed_at": "2026-08-25T00:00:00+00:00",
            "session_date": "2026-08-25"
          },
          {
            "contract": "futures:DI1X26",
            "expiration_date": "2026-11-03",
            "rate": 13.753,
            "settlement": 97625.32,
            "close": 13.754,
            "volume": 214519,
            "observed_at": "2026-08-25T00:00:00+00:00",
            "session_date": "2026-08-25"
          },
          {
            "contract": "futures:DI1Z26",
            "expiration_date": "2026-12-01",
            "rate": 13.708,
            "settlement": 96691.45,
            "close": 13.71,
            "volume": 37803,
            "observed_at": "2026-08-25T00:00:00+00:00",
            "session_date": "2026-08-25"
          }
        ],
        "curve": [
          {
            "maturity": "2027-08-25",
            "business_days": 250,
            "years": 0.9921,
            "rate": 13.769148,
            "kind": "intermediate",
            "observed": false
          },
          {
            "maturity": "2028-08-25",
            "business_days": 502,
            "years": 1.9921,
            "rate": 14.007009,
            "kind": "intermediate",
            "observed": false
          },
          {
            "maturity": "2029-08-25",
            "business_days": 751,
            "years": 2.9802,
            "rate": 14.233058,
            "kind": "intermediate",
            "observed": false
          }
        ],
        "removed_contracts": 0,
        "stale_contracts": 0
      }
    ],
    "sessions": 253,
    "latest": "2026-09-25",
    "spacing": "annual",
    "interpolation": "flat_forward",
    "min_volume": 0,
    "unit": "% a.a. — ajuste do DI1, base 252 dias úteis",
    "method": "Interpolação exponencial (flat forward) do fator de capitalização entre vencimentos, em dias úteis base 252 pelo calendário ANBIMA. O forward entre dois vértices fica constante e a curva reprecifica os próprios vértices. Visualização, não curva de desconto para apreçamento; sem e…"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Histórico da curva DI por prazo

`GET https://api.fintay.com.br/v1/curves/di/history` · Juros e curvas · https://fintay.com.br/docs/api/curva-di-historico

Taxa DI em prazos fixos (1, 2, 5 anos…) em cada pregão, para acompanhar a curva no tempo.

Parâmetros:

- `tenors` (query; string; padrão: 1,2,5,10): Prazos em anos separados por vírgula (ex.: `0.5,1,2,5,10`).
- `years` (query; number; padrão: 3): Janela, em anos, contada do último pregão.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "tenors": [
      1,
      5
    ],
    "points": [
      {
        "date": "2026-09-08",
        "rates": {
          "1": 13.5105,
          "5": 13.9422
        }
      },
      {
        "date": "2026-09-09",
        "rates": {
          "1": 13.5894,
          "5": 14.1337
        }
      },
      {
        "date": "2026-09-10",
        "rates": {
          "1": 13.6072,
          "5": 14.0768
        }
      }
    ],
    "latest": "2026-09-25",
    "unit": "% a.a.",
    "method": "Taxa no prazo fixo interpolada por flat forward entre os vencimentos do pregão, dias úteis base 252; sem extrapolação."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Curvas de juro real e inflação implícita

`GET https://api.fintay.com.br/v1/curves/market` · Juros e curvas · https://fintay.com.br/docs/api/curvas-mercado

Curvas de mercado da B3: prefixada (`pre`), juro real pelo cupom de IPCA (`real`) e inflação implícita (`implicita`).

Parâmetros:

- `curve` (query; string; padrão: pre; valores: pre, real, implicita): `pre`, `real` ou `implicita`.
- `periods` (query; string): Intervalos relativos ao último pregão, como na curva DI.
- `dates` (query; string): Pregões específicos separados por vírgula.
- `spacing` (query; string; padrão: all; valores: all, annual, semiannual, monthly): Espaçamento dos vértices.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "curve": "real",
    "label": "Real (IPCA+)",
    "snapshots": [
      {
        "as_of": "2026-09-25",
        "period": "Último",
        "observed": [
          {
            "contract": "futures:DAPV26",
            "expiration_date": "2026-10-15",
            "rate": 3.018,
            "settlement": 99846.73,
            "close": 3.105,
            "volume": 300,
            "observed_at": "2026-09-25T00:00:00+00:00",
            "session_date": "2026-09-25"
          },
          {
            "contract": "futures:DAPX26",
            "expiration_date": "2026-11-16",
            "rate": 6.413,
            "settlement": 99164.87,
            "close": 6.455,
            "volume": 240,
            "observed_at": "2026-09-25T00:00:00+00:00",
            "session_date": "2026-09-25"
          },
          {
            "contract": "futures:DAPZ26",
            "expiration_date": "2026-12-15",
            "rate": 6.884,
            "settlement": 98583.54,
            "close": null,
            "volume": null,
            "observed_at": "2026-09-25T00:00:00+00:00",
            "session_date": "2026-09-25"
          }
        ],
        "curve": [
          {
            "maturity": "2027-09-25",
            "business_days": 250,
            "years": 0.9921,
            "rate": 6.746118,
            "kind": "intermediate",
            "observed": false
          },
          {
            "maturity": "2028-09-25",
            "business_days": 500,
            "years": 1.9841,
            "rate": 7.387937,
            "kind": "intermediate",
            "observed": false
          },
          {
            "maturity": "2029-09-25",
            "business_days": 749,
            "years": 2.9722,
            "rate": 7.561343,
            "kind": "intermediate",
            "observed": false
          }
        ]
      }
    ],
    "sessions": 242,
    "latest": "2026-09-25",
    "spacing": "annual",
    "unit": "% a.a. acima do IPCA, base 252 dias úteis"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Curva pelos índices IDkA

`GET https://api.fintay.com.br/v1/curves/idka` · Juros e curvas · https://fintay.com.br/docs/api/curva-idka

Taxas por prazo dos índices IDkA Pré e IDkA IPCA da ANBIMA.

Parâmetros:

- `periods` (query; string): Intervalos relativos à última data.
- `dates` (query; string): Datas específicas separadas por vírgula.
- `family` (query; string; padrão: pre; valores: pre, ipca): `pre` ou `ipca`.
- `spacing` (query; string; padrão: all; valores: all, annual, semiannual, monthly): Espaçamento dos vértices.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "snapshots": [
      {
        "as_of": "2026-09-28",
        "period": "Último",
        "observed": [
          {
            "label": "IDkA Pré 3M",
            "months": 3,
            "rate": 13.3447
          },
          {
            "label": "IDkA Pré 1A",
            "months": 12,
            "rate": 13.5198
          },
          {
            "label": "IDkA Pré 2A",
            "months": 24,
            "rate": 13.8716
          }
        ],
        "curve": [
          {
            "maturity": "2026-12-28",
            "business_days": 63,
            "years": 0.25,
            "rate": 13.3447,
            "kind": "contract",
            "observed": true
          },
          {
            "maturity": "2027-01-28",
            "business_days": 84,
            "years": 0.3333,
            "rate": 13.403037,
            "kind": "path",
            "observed": false
          },
          {
            "maturity": "2027-02-28",
            "business_days": 105,
            "years": 0.4167,
            "rate": 13.438053,
            "kind": "path",
            "observed": false
          }
        ]
      }
    ],
    "sessions": 6,
    "latest": "2026-09-28",
    "family": "pre",
    "spacing": "all",
    "unit": "% a.a. — taxa de venda D-0 IDkA",
    "source": "https://www.anbima.com.br/informacoes/idka/IDkA_result.asp",
    "method": "Interpolação exponencial (flat forward) do fator de capitalização entre os prazos constantes do IDkA. Sem extrapolação; os números-índice IDkA não são usados como taxas."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Indicadores do Focus

`GET https://api.fintay.com.br/v1/focus/indicators` · Expectativas (Focus) · https://fintay.com.br/docs/api/focus-indicadores

Indicadores e frequências disponíveis no Boletim Focus, com a data da coleta mais recente.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "indicator": "Balança comercial",
        "frequency": "annual",
        "observations": 121,
        "latest_date": "2026-09-18"
      },
      {
        "indicator": "Câmbio",
        "frequency": "annual",
        "observations": 40,
        "latest_date": "2026-09-18"
      },
      {
        "indicator": "Câmbio",
        "frequency": "monthly",
        "observations": 411,
        "latest_date": "2026-09-18"
      }
    ],
    "source": "Banco Central do Brasil - Focus"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Quadro do Focus

`GET https://api.fintay.com.br/v1/focus/snapshot` · Expectativas (Focus) · https://fintay.com.br/docs/api/focus-quadro

A mediana atual de cada indicador por ano, com a de uma e quatro semanas antes e a tendência, como no quadro do boletim.

Parâmetros:

- `frequency` (query; string; padrão: annual): `annual`, `quarterly` ou `monthly`.
- `indicators` (query; string): Indicadores separados por vírgula. Padrão: o quadro do boletim.
- `periods` (query; integer; padrão: 4): Quantidade de períodos de referência.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "as_of": "2026-09-18",
    "frequency": "annual",
    "periods": [
      "2026",
      "2027"
    ],
    "items": [
      {
        "indicator": "IPCA",
        "label": "IPCA",
        "unit": "% no ano",
        "kind": "pct",
        "digits": 2,
        "detail": "",
        "values": {
          "2026": {
            "median": 4.9205,
            "mean": 4.9356,
            "std": 0.2347,
            "min": 4.047,
            "max": 5.8963,
            "respondents": 146,
            "date": "2026-09-18",
            "week_ago": 4.9,
            "month_ago": 5.0164,
            "trend": {
              "direction": "up",
              "weeks": 1
            }
          },
          "2027": {
            "median": 4.3,
            "mean": 4.3304,
            "std": 0.4196,
            "min": 3.17,
            "max": 6,
            "respondents": 146,
            "date": "2026-09-18",
            "week_ago": 4.3,
            "month_ago": 4.2549,
            "trend": {
              "direction": "flat",
              "weeks": 1
            }
          }
        }
      },
      {
        "indicator": "Selic",
        "label": "Selic",
        "unit": "% a.a. no fim do ano",
        "kind": "pct",
        "digits": 2,
        "detail": "",
        "values": {
          "2026": {
            "median": 13.5,
            "mean": 13.5321,
            "std": 0.2515,
            "min": 13,
            "max": 14,
            "respondents": 140,
            "date": "2026-09-18",
            "week_ago": 13.75,
            "month_ago": 13.75,
            "trend": {
              "direction": "down",
              "weeks": 1
            }
          },
          "2027": {
            "median": 12,
            "mean": 11.9874,
            "std": 0.7469,
            "min": 9.75,
            "max": 14,
            "respondents": 139,
            "date": "2026-09-18",
            "week_ago": 12,
            "month_ago": 12,
            "trend": {
              "direction": "flat",
              "weeks": 9
            }
          }
        }
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Expectativas por coleta

`GET https://api.fintay.com.br/v1/focus/expectations` · Expectativas (Focus) · https://fintay.com.br/docs/api/focus-expectativas

As estatísticas de cada coleta do Focus: mediana, média, desvio, mínimo, máximo e número de respondentes.

Parâmetros:

- `indicator` (query; string): Indicador (ex.: `IPCA`, `Selic`, `PIB Total`, `Câmbio`).
- `frequency` (query; string): Frequência do período de referência.
- `reference_period` (query; string): Período de referência (ex.: `2026`).
- `observation_date` (query; string): Data da coleta.
- `calculation_base` (query; integer): Base de cálculo das estatísticas.
- `latest` (query; boolean; padrão: true): Só a coleta mais recente.
- `limit` (query; integer; padrão: 200): Máximo de linhas.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "endpoint": "annual",
        "observation_date": "2026-09-18",
        "reference_period": "2026",
        "indicator": "IPCA",
        "indicator_detail": "",
        "frequency": "annual",
        "calculation_base": 0,
        "calculation_type": "",
        "smoothing": "",
        "mean": 4.9356,
        "median": 4.9205,
        "standard_deviation": 0.2347,
        "minimum": 4.047,
        "maximum": 5.8963,
        "respondent_count": 146,
        "calculation_base_label": "data de consulta",
        "calculation_type_label": null
      },
      {
        "endpoint": "annual",
        "observation_date": "2026-09-18",
        "reference_period": "2026",
        "indicator": "IPCA",
        "indicator_detail": "",
        "frequency": "annual",
        "calculation_base": 1,
        "calculation_type": "",
        "smoothing": "",
        "mean": 4.9719,
        "median": 4.9741,
        "standard_deviation": 0.2532,
        "minimum": 4.047,
        "maximum": 5.8963,
        "respondent_count": 91,
        "calculation_base_label": "cinco dias úteis antes",
        "calculation_type_label": null
      },
      {
        "endpoint": "top5_annual",
        "observation_date": "2026-09-18",
        "reference_period": "2026",
        "indicator": "IPCA",
        "indicator_detail": "",
        "frequency": "top5_annual",
        "calculation_base": -1,
        "calculation_type": "C",
        "smoothing": "",
        "mean": 4.8989,
        "median": 4.8489,
        "standard_deviation": 0.2325,
        "minimum": 4.6083,
        "maximum": 5.1829,
        "respondent_count": null,
        "calculation_base_label": "não publicado",
        "calculation_type_label": "Top 5 - curto prazo"
      }
    ],
    "latest": true,
    "note": "baseCalculo: 0=data de consulta; 1=cinco dias úteis antes. tipoCalculo C/M: Top 5 curto/médio prazo."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Histórico das expectativas

`GET https://api.fintay.com.br/v1/focus/history` · Expectativas (Focus) · https://fintay.com.br/docs/api/focus-historico

Evolução da mediana de um indicador ao longo das coletas, por ano de referência ou por horizonte.

Parâmetros:

- `indicator` (query; string; obrigatório): Indicador.
- `frequency` (query; string; padrão: annual): Frequência.
- `reference_periods` (query; string): Anos de referência separados por vírgula.
- `horizons` (query; string): Anos à frente da coleta, ex.: `0,1,2` (só anual).
- `start` (query; string): Primeira coleta.
- `end` (query; string): Última coleta.
- `step` (query; string; padrão: week): Amostragem: semanal ou diária.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "as_of": "2026-09-18",
    "indicator": "Selic",
    "label": "Selic",
    "unit": "% a.a. no fim do ano",
    "kind": "pct",
    "digits": 2,
    "frequency": "annual",
    "mode": "reference",
    "series": [
      {
        "key": "2026",
        "horizon": null,
        "points": [
          {
            "date": "2026-08-07",
            "reference_period": "2026",
            "median": 13.75,
            "mean": 13.7566,
            "min": 12.25,
            "max": 14.25,
            "std": 0.3151,
            "respondents": 151
          },
          {
            "date": "2026-08-14",
            "reference_period": "2026",
            "median": 13.75,
            "mean": 13.7078,
            "min": 12.75,
            "max": 14.25,
            "std": 0.2717,
            "respondents": 148
          },
          {
            "date": "2026-08-21",
            "reference_period": "2026",
            "median": 13.75,
            "mean": 13.6871,
            "min": 12.75,
            "max": 14.25,
            "std": 0.2651,
            "respondents": 145
          }
        ]
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Moedas e criptoativos disponíveis

`GET https://api.fintay.com.br/v1/markets/{market}/symbols` · Câmbio, cripto e derivativos · https://fintay.com.br/docs/api/mercados-simbolos

Símbolos com histórico em cada mercado: moedas (`currency`) e criptoativos (`crypto`).

Parâmetros:

- `market` (path; string; obrigatório; valores: crypto, currency): `currency` ou `crypto`.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "symbol": "USD-BRL",
        "name": "Dólar Americano/Real Brasileiro",
        "currencies": [
          "BRL"
        ],
        "last_observed_at": "2026-10-09T03:00:00+00:00",
        "market_cap": null
      },
      {
        "symbol": "AUD-BRL",
        "name": "Dólar Australiano/Real Brasileiro",
        "currencies": [
          "BRL"
        ],
        "last_observed_at": "2026-10-09T03:00:00+00:00",
        "market_cap": null
      },
      {
        "symbol": "CAD-BRL",
        "name": "Dólar Canadense/Real Brasileiro",
        "currencies": [
          "BRL"
        ],
        "last_observed_at": "2026-10-09T03:00:00+00:00",
        "market_cap": null
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Histórico de câmbio ou cripto

`GET https://api.fintay.com.br/v1/markets/{market}/{symbol}/quotes` · Câmbio, cripto e derivativos · https://fintay.com.br/docs/api/mercados-cotacoes

Fechamentos diários de uma moeda ou criptoativo, na moeda de cotação pedida.

Parâmetros:

- `market` (path; string; obrigatório; valores: crypto, currency, futures, options, future_options): `currency` ou `crypto`.
- `symbol` (path; string; obrigatório): Símbolo, como em `/symbols` (ex.: `USD`, `BTC`).
- `currency` (query; string; valores: BRL, USD): Moeda de cotação (ex.: `BRL`).
- `start` (query; string): Data inicial.
- `end` (query; string): Data final.
- `expiration` (query; string)
- `strike` (query; number)
- `limit` (query; integer; padrão: 1000): Máximo de pontos.
- `offset` (query; integer; padrão: 0)
- `side` (query; string; valores: call, put)

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "instrument_id": "056ec667-9709-4e2a-a036-26c7b4f02f52",
        "currency": "BRL",
        "observed_at": "2026-10-10T04:14:46.962000+00:00",
        "observation_type": "rolling_24h",
        "open": null,
        "high": 416692.66962799995,
        "low": 410108.81512,
        "close": 412627.0604,
        "settlement": null,
        "settlement_rate": null,
        "reference_price": null,
        "volume": 4681029954.350345,
        "financial_volume": null,
        "market_cap": 0,
        "quotation_type": null,
        "archive_id": "8f294007-906c-43f8-9a45-fe124c10fe21",
        "attributes": {
          "coin": "BTC",
          "coinName": "Bitcoin",
          "currency": "BRL",
          "marketCap": 0,
          "usedRange": "max",
          "validRanges": [
            "1d",
            "2d",
            "5d"
          ],
          "coinImageUrl": "https://cdn.jsdelivr.net/gh/spothq/cryptocurrency-icons@master/svg/color/btc.svg",
          "usedInterval": "1d",
          "validIntervals": [
            "1m",
            "2m",
            "5m"
          ],
          "regularMarketTime": "2026-10-10T04:14:46.962Z",
          "regularMarketPrice": 412627.0604,
          "currencyRateFromUSD": 4.9886,
          "historicalDataPrice": [
            {
              "low": 13275.598622,
              "date": 1502928000,
              "high": 14175.178017,
              "open": 13467.555243999997,
              "close": 13542.138324,
              "volume": 795.150377,
              "adjustedClose": 13542.138324
            },
            {
              "low": 12467.782558,
              "date": 1503014400,
              "high": 13837.609408000002,
              "open": 13563.992232,
              "close": 13004.634398,
              "volume": 1199.888264,
              "adjustedClose": 13004.634398
            },
            {
              "low": 12186.79,
              "date": 1503100800,
              "high": 13246.217725999999,
              "open": 13004.634398,
              "close": 13104.692691999999,
              "volume": 381.309763,
              "adjustedClose": 13104.692691999999
            }
          ],
          "regularMarketChange": 1027.801258,
          "regularMarketDayLow": 410108.81512,
          "regularMarketVolume": 4681029954.350345,
          "regularMarketDayHigh": 416692.66962799995,
          "regularMarketDayRange": "410108.81512 - 416692.66962799995",
          "regularMarketChangePercent": 0.25
        },
        "expiration_date": null,
        "strike": null,
        "side": null,
        "underlying": null
      },
      {
        "instrument_id": "056ec667-9709-4e2a-a036-26c7b4f02f52",
        "currency": "BRL",
        "observed_at": "2026-10-09T00:00:00+00:00",
        "observation_type": "daily",
        "open": 409745.178074,
        "high": 418638.89486199996,
        "low": 408988.681888,
        "close": 414161.113045,
        "settlement": null,
        "settlement_rate": null,
        "reference_price": null,
        "volume": 12301.61263,
        "financial_volume": null,
        "market_cap": null,
        "quotation_type": null,
        "archive_id": "8f294007-906c-43f8-9a45-fe124c10fe21",
        "attributes": {
          "low": 408988.681888,
          "date": 1791504000,
          "high": 418638.89486199996,
          "open": 409745.178074,
          "close": 414161.113045,
          "volume": 12301.61263,
          "adjustedClose": 414161.113045
        },
        "expiration_date": null,
        "strike": null,
        "side": null,
        "underlying": null
      },
      {
        "instrument_id": "056ec667-9709-4e2a-a036-26c7b4f02f52",
        "currency": "BRL",
        "observed_at": "2026-10-08T00:00:00+00:00",
        "observation_type": "daily",
        "open": 417600.579539,
        "high": 418599.65168499993,
        "low": 402924.483364,
        "close": 409745.127955,
        "settlement": null,
        "settlement_rate": null,
        "reference_price": null,
        "volume": 21676.96164,
        "financial_volume": null,
        "market_cap": null,
        "quotation_type": null,
        "archive_id": "8f294007-906c-43f8-9a45-fe124c10fe21",
        "attributes": {
          "low": 402924.483364,
          "date": 1791417600,
          "high": 418599.65168499993,
          "open": 417600.579539,
          "close": 409745.127955,
          "volume": 21676.96164,
          "adjustedClose": 409745.127955
        },
        "expiration_date": null,
        "strike": null,
        "side": null,
        "underlying": null
      }
    ],
    "has_more": true,
    "offset": 0,
    "date_filter_timezone": "UTC",
    "note": "rolling_24h não é fechamento diário; settlement e close podem ter unidades distintas."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Estrutura a termo de um futuro

`GET https://api.fintay.com.br/v1/futures/{underlying}/term-structure` · Câmbio, cripto e derivativos · https://fintay.com.br/docs/api/futuros-estrutura

Ajuste, volume e contratos em aberto de cada vencimento de um contrato futuro da B3 num pregão.

Parâmetros:

- `underlying` (path; string; obrigatório): Ativo do contrato (ex.: `DI1`, `DOL`, `IND`).
- `as_of` (query; string): Pregão. Padrão: o mais recente.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "source_key": "futures:DOLX26",
        "expiration_date": "2026-11-03",
        "multiplier": 50,
        "quotation_type": "price",
        "observed_at": "2026-09-25T00:00:00+00:00",
        "currency": "BRL",
        "close": 5228,
        "settlement": 5223.236,
        "settlement_rate": null,
        "volume": 1240
      },
      {
        "source_key": "futures:DOLZ26",
        "expiration_date": "2026-12-01",
        "multiplier": 50,
        "quotation_type": "price",
        "observed_at": "2026-09-25T00:00:00+00:00",
        "currency": "BRL",
        "close": null,
        "settlement": 5251.423,
        "settlement_rate": null,
        "volume": null
      },
      {
        "source_key": "futures:DOLF27",
        "expiration_date": "2027-01-04",
        "multiplier": 50,
        "quotation_type": "price",
        "observed_at": "2026-09-25T00:00:00+00:00",
        "currency": "BRL",
        "close": null,
        "settlement": 5280.528,
        "settlement_rate": null,
        "volume": null
      }
    ],
    "note": "Última observação disponível por contrato; sem série contínua ou interpolação."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Cadeia de opções

`GET https://api.fintay.com.br/v1/derivatives/{market}/chain` · Câmbio, cripto e derivativos · https://fintay.com.br/docs/api/opcoes-cadeia

Opções de um ativo-objeto por vencimento e strike, com prêmio, volume e contratos em aberto.

Parâmetros:

- `market` (path; string; obrigatório; valores: options, future_options): Mercado de opções.
- `underlying` (query; string; obrigatório): Ativo-objeto (ex.: `PETR4`).
- `expiration` (query; string): Vencimento.
- `side` (query; string; valores: call, put): `call` ou `put`.
- `strike` (query; number): Preço de exercício.
- `as_of` (query; string): Pregão.
- `limit` (query; integer; padrão: 200): Máximo de opções.
- `offset` (query; integer; padrão: 0): Opções a pular.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "instrument_id": "b2c94d09-2704-4340-93fc-6adfdaf5592b",
        "symbol": "PETRJ752",
        "underlying": "PETR4",
        "expiration_date": "2026-10-16",
        "side": "call",
        "strike": 5.21,
        "currency": "BRL",
        "multiplier": null,
        "option_style": "european",
        "price_date": "2026-09-25T03:00:00+00:00",
        "close": 42.91,
        "volume": 5700,
        "price_details": {
          "ask": 0,
          "bid": 0,
          "low": 42.79,
          "date": 1790305200,
          "high": 43.3,
          "open": 42.94,
          "side": "call",
          "close": 42.91,
          "market": "equity",
          "strike": 5.21,
          "symbol": "PETRJ752",
          "trades": 12,
          "volume": 5700,
          "average": 43.01,
          "optionStyle": "european",
          "openInterest": 104900,
          "lastTradeDate": "2026-09-25",
          "expirationDate": "2026-10-16",
          "firstTradeDate": "2026-08-25",
          "referencePrice": null,
          "financialVolume": 245189,
          "openInterestDate": "2026-09-25",
          "underlyingSymbol": "PETR4",
          "allocationRoundLot": 100,
          "openInterestChange": -4300
        },
        "analytics_date": null,
        "analytics": null,
        "positions_date": null,
        "positions": null
      },
      {
        "instrument_id": "70359862-c648-4276-a730-711bd56afe70",
        "symbol": "PETRJ128",
        "underlying": "PETR4",
        "expiration_date": "2026-10-16",
        "side": "call",
        "strike": 11.61,
        "currency": "BRL",
        "multiplier": null,
        "option_style": "european",
        "price_date": "2026-09-25T03:00:00+00:00",
        "close": 36.5,
        "volume": 800,
        "price_details": {
          "ask": 0,
          "bid": 0,
          "low": 36.44,
          "date": 1790305200,
          "high": 36.5,
          "open": 36.45,
          "side": "call",
          "close": 36.5,
          "market": "equity",
          "strike": 11.61,
          "symbol": "PETRJ128",
          "trades": 8,
          "volume": 800,
          "average": 36.47,
          "optionStyle": "european",
          "openInterest": 8000,
          "lastTradeDate": "2026-09-25",
          "expirationDate": "2026-10-16",
          "firstTradeDate": "2026-09-08",
          "referencePrice": null,
          "financialVolume": 29179,
          "openInterestDate": "2026-09-25",
          "underlyingSymbol": "PETR4",
          "allocationRoundLot": 100,
          "openInterestChange": -800
        },
        "analytics_date": null,
        "analytics": null,
        "positions_date": null,
        "positions": null
      },
      {
        "instrument_id": "0ec599a4-267f-4334-ad14-01720224ab7b",
        "symbol": "PETRJ184",
        "underlying": "PETR4",
        "expiration_date": "2026-10-16",
        "side": "call",
        "strike": 13.11,
        "currency": "BRL",
        "multiplier": null,
        "option_style": "european",
        "price_date": "2026-09-25T03:00:00+00:00",
        "close": 35.1,
        "volume": 500,
        "price_details": {
          "ask": 0,
          "bid": 0,
          "low": 35.1,
          "date": 1790305200,
          "high": 35.1,
          "open": 35.1,
          "side": "call",
          "close": 35.1,
          "market": "equity",
          "strike": 13.11,
          "symbol": "PETRJ184",
          "trades": 1,
          "volume": 500,
          "average": 35.1,
          "optionStyle": "european",
          "openInterest": 9300,
          "lastTradeDate": "2026-09-25",
          "expirationDate": "2026-10-16",
          "firstTradeDate": "2026-08-31",
          "referencePrice": null,
          "financialVolume": 17550,
          "openInterestDate": "2026-09-25",
          "underlyingSymbol": "PETR4",
          "allocationRoundLot": 100,
          "openInterestChange": 0
        },
        "analytics_date": null,
        "analytics": null,
        "positions_date": null,
        "positions": null
      }
    ],
    "has_more": true,
    "offset": 0,
    "note": "Contratos com preço no último pregão até a data de referência. Analytics e posições têm datas próprias; ausência não significa zero."
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Risco de crédito de emissores

`GET https://api.fintay.com.br/v1/credit-risk/issuers` · Risco de crédito · https://fintay.com.br/docs/api/credito-emissores

Probabilidade de inadimplência em 12 meses e faixa de risco de companhias abertas e emissoras de dívida.

Parâmetros:

- `q` (query; string): Nome, ticker ou CNPJ.
- `sector` (query; string): Setor.
- `grade` (query; integer): Faixa de risco, de 1 (menor) a 10.
- `segment` (query; string; valores: corporate, financial): Segmento do emissor.
- `listed` (query; boolean): Só companhias com ações listadas.
- `defaulted` (query; boolean): Só emissores com evento de inadimplência.
- `sort` (query; string; padrão: pd): Ordenação.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 50)

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "as_of": "2026-10-05",
    "items": [
      {
        "cnpj": "33000167000101",
        "ref_date": "2026-10-05",
        "segment": "corporate",
        "name": "PETROLEO BRASILEIRO S.A. PETROBRAS",
        "sector": "Petróleo e Gás",
        "ticker": "PETR4",
        "statement_date": "2026-06-30",
        "market_cap": 639281144945.6,
        "debt_point": 213511500000,
        "total_liabilities": 797165000000,
        "total_assets": 1279019000000,
        "equity_vol": 0.28175504176510363,
        "asset_vol": 0.21776094329453574,
        "dd_naive": 8.652367578239117,
        "pd_naive": 2.52209353113147e-18,
        "dd_kmv": 6.697882748053175,
        "pd_kmv": 1.0573041067501035e-11,
        "z_em": 5.302500264967516,
        "z_zone": "grey",
        "pd_market": 0.004686506356856154,
        "pd_accounting": 0.004686647664792307,
        "pd": 0.004686506356856154,
        "grade": 4,
        "in_default": false,
        "model": "corporate_market",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "pd_3m_ago": 0.006167317444763686,
        "grade_3m_ago": 5
      }
    ],
    "total": 1,
    "page": 1,
    "per_page": 50,
    "sectors": [
      {
        "sector": "Agricultura (Açúcar, Álcool e Cana)",
        "issuers": 13
      },
      {
        "sector": "Alimentos",
        "issuers": 17
      },
      {
        "sector": "Bancos",
        "issuers": 21
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Risco de crédito de um emissor

`GET https://api.fintay.com.br/v1/credit-risk/issuers/{cnpj}` · Risco de crédito · https://fintay.com.br/docs/api/credito-emissor

Probabilidade de inadimplência, faixa, indicadores do balanço e histórico de um emissor.

Parâmetros:

- `cnpj` (path; string; obrigatório): CNPJ do emissor.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "latest": {
      "cnpj": "33000167000101",
      "ref_date": "2026-10-05",
      "segment": "corporate",
      "name": "PETROLEO BRASILEIRO S.A. PETROBRAS",
      "sector": "Petróleo e Gás",
      "ticker": "PETR4",
      "statement_date": "2026-06-30",
      "market_cap": 639281144945.6,
      "debt_point": 213511500000,
      "total_liabilities": 797165000000,
      "total_assets": 1279019000000,
      "equity_vol": 0.28175504176510363,
      "asset_vol": 0.21776094329453574,
      "dd_naive": 8.652367578239117,
      "pd_naive": 2.52209353113147e-18,
      "dd_kmv": 6.697882748053175,
      "pd_kmv": 1.0573041067501035e-11,
      "z_em": 5.302500264967516,
      "z_zone": "grey",
      "pd_market": 0.004686506356856154,
      "pd_accounting": 0.004686647664792307,
      "pd": 0.004686506356856154,
      "grade": 4,
      "in_default": false,
      "model": "corporate_market",
      "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799"
    },
    "features": {
      "dd": 8.652367578239117,
      "mb": 0.2505543953576568,
      "zem": 5.302500264967516,
      "nita": 0.10457702348440484,
      "reta": 0.17708962884835958,
      "size": 27.877114493770662,
      "tlta": 0.6232628287773676,
      "wcta": -0.02064160110209465,
      "exret": 0.17840354593837338,
      "nimta": 0.09311591699462252,
      "price": 2.70805020110221,
      "rsize": -1.7446083047943872,
      "sigma": 0.27422504742818443,
      "tlmta": 0.5549564129535741,
      "cashta": 0.04203534114817684,
      "ebitta": 0.14522536412672524,
      "cashmta": 0.037428482918888756,
      "zem_distress": 0
    },
    "history": [
      {
        "cnpj": "33000167000101",
        "ref_date": "2021-06-30",
        "segment": "corporate",
        "name": "PETROLEO BRASILEIRO S.A. PETROBRAS",
        "sector": "Petróleo e Gás",
        "ticker": "PETR4",
        "statement_date": "2021-03-31",
        "market_cap": 390291154090,
        "debt_point": 226832500000,
        "total_liabilities": 678038000000,
        "total_assets": 998283000000,
        "equity_vol": 0.46236863060236705,
        "asset_vol": 0.2968144127874999,
        "dd_naive": 3.8215744083530696,
        "pd_naive": 0.00006630119541556441,
        "dd_kmv": 3.3108353198236182,
        "pd_kmv": 0.0004650896612972473,
        "z_em": 5.272921440418015,
        "z_zone": "grey",
        "pd_market": 0.004825735258242409,
        "pd_accounting": 0.004825927964633052,
        "pd": 0.004825735258242409,
        "grade": 4,
        "in_default": false,
        "model": "corporate_market",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799"
      },
      {
        "cnpj": "33000167000101",
        "ref_date": "2021-07-31",
        "segment": "corporate",
        "name": "PETROLEO BRASILEIRO S.A. PETROBRAS",
        "sector": "Petróleo e Gás",
        "ticker": "PETR4",
        "statement_date": "2021-03-31",
        "market_cap": 355410365200,
        "debt_point": 226832500000,
        "total_liabilities": 678038000000,
        "total_assets": 998283000000,
        "equity_vol": 0.460261133723906,
        "asset_vol": 0.2854440439169527,
        "dd_naive": 3.2903597299607528,
        "pd_naive": 0.0005002968750700566,
        "dd_kmv": 3.247353306614509,
        "pd_kmv": 0.0005824184673807683,
        "z_em": 5.272921440418015,
        "z_zone": "grey",
        "pd_market": 0.004825735258242409,
        "pd_accounting": 0.004825927964633052,
        "pd": 0.004825735258242409,
        "grade": 4,
        "in_default": false,
        "model": "corporate_market",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799"
      },
      {
        "cnpj": "33000167000101",
        "ref_date": "2021-08-31",
        "segment": "corporate",
        "name": "PETROLEO BRASILEIRO S.A. PETROBRAS",
        "sector": "Petróleo e Gás",
        "ticker": "PETR4",
        "statement_date": "2021-06-30",
        "market_cap": 360104661195.45,
        "debt_point": 180388000000,
        "total_liabilities": 579057000000,
        "total_assets": 941447000000,
        "equity_vol": 0.4625536571016144,
        "asset_vol": 0.31332682067689455,
        "dd_naive": 3.829100035069237,
        "pd_naive": 0.00006430636193427062,
        "dd_kmv": 3.4533079319798325,
        "pd_kmv": 0.0002768782430316535,
        "z_em": 5.957875136931966,
        "z_zone": "safe",
        "pd_market": 0.003594498086522566,
        "pd_accounting": 0.003594927330330452,
        "pd": 0.003594498086522566,
        "grade": 4,
        "in_default": false,
        "model": "corporate_market",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799"
      }
    ],
    "peers": [
      {
        "cnpj": "52017473000103",
        "name": "Azevedo & Travassos Energia S.A.",
        "ticker": "AZTE3",
        "pd": 0.003356009070294785,
        "grade": 4,
        "in_default": false,
        "dd_naive": null,
        "z_em": 16.802686905765963,
        "market_cap": null,
        "series_id": "4f504ffc-de85-44a3-86c7-06ec11ab8d11"
      },
      {
        "cnpj": "07275159000168",
        "name": "PETROLEO LUB DO NORDESTE SA",
        "ticker": null,
        "pd": 0.003356009070294785,
        "grade": 4,
        "in_default": false,
        "dd_naive": null,
        "z_em": 11.768810475969413,
        "market_cap": null,
        "series_id": null
      },
      {
        "cnpj": "10629105000168",
        "name": "PRIO S.A.",
        "ticker": "PRIO3",
        "pd": 0.0037962059328711427,
        "grade": 4,
        "in_default": false,
        "dd_naive": 6.458913540561958,
        "z_em": 5.800541364443861,
        "market_cap": 48577156047.159996,
        "series_id": "ac89d2dc-b117-4348-847e-918a9137790d"
      }
    ],
    "universe_rank": 0.5041597337770383,
    "events": [],
    "bank": null,
    "scale": [
      {
        "grade": 1,
        "pd_min": 0,
        "pd_max": 0.0005
      },
      {
        "grade": 2,
        "pd_min": 0.0005,
        "pd_max": 0.001
      },
      {
        "grade": 3,
        "pd_min": 0.001,
        "pd_max": 0.0025
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Risco de crédito de bancos

`GET https://api.fintay.com.br/v1/credit-risk/banks` · Risco de crédito · https://fintay.com.br/docs/api/credito-bancos

Instituições financeiras com capital, rentabilidade, qualidade da carteira e probabilidade de inadimplência.

Parâmetros:

- `q` (query; string): Nome ou CNPJ.
- `segment` (query; string): Segmento prudencial (S1 a S5).
- `period` (query; integer): Trimestre (AAAAMM).
- `min_assets` (query; number; padrão: 1000000000): Ativo total mínimo, em reais.
- `sort` (query; string; padrão: score; valores: score, -score, assets, name): Ordenação.
- `page` (query; integer; padrão: 1): Página.
- `per_page` (query; integer; padrão: 50): Itens por página.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "period": 202606,
    "periods": [
      202606,
      202603,
      202512
    ],
    "items": [
      {
        "institution_code": "C0080336",
        "year_month": 202606,
        "cnpj8": "30306294",
        "name": "BTG PACTUAL - PRUDENCIAL",
        "segment": "S1",
        "total_assets": 858356835731.33,
        "equity": 84250297415.6,
        "loans": 215378010334.36,
        "basel": 0.160421550832961,
        "cet1": 0.115868766052525,
        "leverage": 0.092578671659351,
        "roa": 0.022069004237427987,
        "roe": 0.22484289345039687,
        "problem_assets": 0.07906904843615632,
        "provision_rate": 0.027723861520079277,
        "loan_growth": 0.15725188152628466,
        "loans_to_funding": 0.3558834929119061,
        "score": 53.021202486589836,
        "pd": 0.004595569643226034,
        "grade": 4,
        "in_default": false
      },
      {
        "institution_code": "C0080099",
        "year_month": 202606,
        "cnpj8": "60872504",
        "name": "ITAU - PRUDENCIAL",
        "segment": "S1",
        "total_assets": 2846417632668.47,
        "equity": 249766169378.91,
        "loans": 1235230835976.66,
        "basel": 0.153516322031136,
        "cet1": 0.123087092655114,
        "leverage": 0.0675316024960827,
        "roa": 0.01733428408857346,
        "roe": 0.19754721787219864,
        "problem_assets": 0.03771120206752811,
        "provision_rate": 0.03181688381354707,
        "loan_growth": 0.0741028458180697,
        "loans_to_funding": 0.5782446616913168,
        "score": 52.06803152525366,
        "pd": 0.004857207976727679,
        "grade": 4,
        "in_default": false
      }
    ],
    "total": 6,
    "page": 1,
    "per_page": 2,
    "segments": [
      {
        "segment": "S1",
        "n": 6
      },
      {
        "segment": "S2",
        "n": 9
      },
      {
        "segment": "S3",
        "n": 56
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Registros de uma base

`GET https://api.fintay.com.br/v1/datasets/{dataset}/records` · Bases de dados · https://fintay.com.br/docs/api/bases-registros

Linhas das bases da CVM por entidade: carteiras de fundos (`cda`), informes de FII e FIDC, demonstrações (`dfp`, `itr`), formulário de referência (`fre`) e cadastro de companhias (`fca`).

Parâmetros:

- `dataset` (path; string; obrigatório; valores: cda, fii, fidc, dfp, itr, fre, fca): `cda`, `fii`, `fidc`, `dfp`, `itr`, `fre` ou `fca`.
- `entity` (query; string; obrigatório): CNPJ da companhia ou do fundo.
- `reference_date` (query; string): Data de referência.
- `section` (query; string): Seção da base.
- `all_versions` (query; boolean; padrão: false): Inclui versões reapresentadas.
- `limit` (query; integer; padrão: 100): Máximo de linhas.
- `offset` (query; integer; padrão: 0): Linhas a pular.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "archive_id": "05c307b6-bc2a-46ed-9d3d-35269fc775b1",
        "section": "fre_cia_aberta_2026.csv",
        "row_number": 1166,
        "entity_identifier": "33000167000101",
        "reference_date": "2026-12-31",
        "document_version": 12,
        "document_id": "161309",
        "payload": {
          "CD_CVM": "009512",
          "ID_DOC": "161309",
          "VERSAO": "12",
          "CNPJ_CIA": "33.000.167/0001-01",
          "DT_RECEB": "2026-09-11",
          "DT_REFER": "2026-12-31",
          "LINK_DOC": "http://www.rad.cvm.gov.br/ENETCONSULTA/frmDownloadDocumento.aspx?CodigoInstituicao=1&NumeroSequencialDocumento=161309",
          "CATEG_DOC": "FRE WEB",
          "DENOM_CIA": "PETROLEO BRASILEIRO S.A. PETROBRAS"
        },
        "source_url": "https://dados.cvm.gov.br/dados/CIA_ABERTA/DOC/FRE/DADOS/fre_cia_aberta_2026.zip",
        "retrieved_at": "2026-09-22T00:03:53.555627+00:00",
        "latest_version": 12
      }
    ],
    "has_more": true,
    "offset": 0,
    "quality": {
      "quarantined_rows_in_dataset": 2,
      "partial": true
    },
    "note": "Cobertura parcial: 2 registros da base em quarentena.",
    "version_policy": "latest_in_current_archive"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Listar carteiras

`GET https://api.fintay.com.br/v1/portfolios` · Carteiras e análises · https://fintay.com.br/docs/api/carteiras-lista

Carteiras salvas na sua conta, com a versão mais recente das posições (pesos em %). Use o `slug` ou o `id` para rodar as análises.

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "5b0e2c1a-7d3f-4a51-9b8e-2f64c0a1d9e7",
        "name": "Renda e dividendos",
        "slug": "renda-e-dividendos",
        "notes": null,
        "benchmark_id": null,
        "updated_at": "2026-10-10T14:02:11.482913+00:00",
        "version": 3,
        "items": [
          {
            "series_id": "f084283b-3140-4ab0-b6ba-0140fe1fc961",
            "code": "TAEE11",
            "name": "Transmissora Alianca De Energia Eletrica S.A. Unit",
            "asset_class": "unit",
            "frequency": "daily",
            "token": "TAEE11",
            "weight": 50,
            "group": "unit"
          },
          {
            "series_id": "…",
            "code": "CDI",
            "name": "CDI",
            "asset_class": "juros",
            "frequency": "daily",
            "token": "CDI",
            "weight": 50,
            "group": "juros"
          }
        ],
        "benchmark_name": null
      }
    ],
    "limit": 10
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```

## Rodar uma análise de carteira

`POST https://api.fintay.com.br/v1/analytics/{tool}` · Carteiras e análises · https://fintay.com.br/docs/api/analises-ferramenta

Calcula métricas de risco, correlações, backtest, otimização, atribuição ou Monte Carlo. Informe os ativos (`instruments`) ou uma carteira (`portfolio`: salva, por `slug`, ou com `items` na própria chamada).

> Cada ferramenta aceita campos próprios além destes: `backtest` recebe `portfolios` (até 3), `initial` e `rebalance`; `optimize` recebe o objetivo; `montecarlo`, o horizonte em anos.

> Os ativos precisam ter histórico de preços conferido; caso contrário a resposta é `422`.

Parâmetros:

- `tool` (path; string; obrigatório): `backtest`, `metrics`, `correlation`, `optimize`, `attribution` ou `montecarlo`.
- `instruments` (body; array): Tickers ou códigos de série (ex.: `PETR4`, `bacen/12`, `CDI`). Use isto ou `portfolio`.
- `portfolio` (body; object): Carteira: `{"slug": "minha-carteira"}` para uma salva, ou `{"items": [{"instrument": "PETR4", "weight": 60}, ...]}` com pesos em %.
- `start` (body; string): Início da janela.
- `end` (body; string): Fim da janela. Padrão: o último dia com dado.
- `frequency` (body; string; padrão: daily; valores: daily, monthly): Frequência dos retornos.
- `benchmark` (body; string): Referência para beta e retorno relativo (ex.: `CDI`, `IBOV`).

Resposta de exemplo (200):

```json
{
  "success": true,
  "data": {
    "conventions": {
      "frequency": "diaria",
      "periods_per_year": 252,
      "returns": "simples, a partir de preco ajustado, cota, PU ou indice",
      "return_basis": {
        "BTAG11": "fechamento ajustado por proventos e eventos (retorno total)",
        "CDI": "taxa diária capitalizada"
      },
      "risk_free": "CDI do mesmo período",
      "start": "2026-01-02",
      "end": "2026-09-30",
      "observations": 186,
      "start_limited_by": "BTAG11",
      "end_limited_by": "BTAG11",
      "gap_rule": "lacunas de ate 10 períodos repetem o ultimo valor; acima disso, erro",
      "suspicious_rule": "saltos de +300%/-75% revertidos no período seguinte, ou 10x no ultimo ponto, ficam fora; mudanças persistentes acima de 10x impedem a análise",
      "excluded_points": {},
      "filled_points": {}
    },
    "benchmark": {
      "code": "CDI",
      "name": "Taxa de juros - CDI",
      "metrics": {
        "periods": 186,
        "years": 0.7380952380952381,
        "total_return": 0.10445586364906156,
        "annualized_return": null,
        "annualized_return_note": "Periodo menor que 1 ano: sem anualizacao",
        "arithmetic_mean": 0.1346429767742056,
        "geometric_mean": 0.14408706494073598,
        "risk_free_return": 0.10445586364906156,
        "excess_return": null,
        "volatility": 0.0002202436742182057,
        "downside_deviation": 0,
        "max_drawdown": {
          "depth": 0,
          "peak": null,
          "trough": null,
          "recovery": null,
          "length": 0,
          "recovery_periods": null
        },
        "ulcer_index": 0,
        "skewness": -0.20909797019089638,
        "excess_kurtosis": -1.1881790684399227,
        "sharpe": null,
        "sortino": null,
        "calmar": null,
        "omega": null,
        "gain_loss": null,
        "positive_periods": 1,
        "best_period": 0.0005513100000000826,
        "worst_period": 0.0005078800000000161,
        "best_month": 0.012152202899923692,
        "worst_month": 0.009970220253081363,
        "best_year": 0.1044558636490609,
        "worst_year": 0.1044558636490609,
        "var": {
          "95": {
            "historical": -0.0005100600000000345,
            "parametric": -0.0005114767497338986,
            "cornish_fisher": -0.0005103308264557911,
            "cvar_historical": -0.0005078800000000161,
            "cvar_parametric": -0.0005056793516661251
          },
          "99": {
            "historical": -0.0005078800000000161,
            "parametric": -0.0005020216662629118,
            "cornish_fisher": -0.0005039707324133836,
            "cvar_historical": -0.0005078800000000161,
            "cvar_parametric": -0.000497320218519947
          }
        },
        "var_month": {
          "95": {
            "historical": -0.010889409274033148,
            "parametric": -0.010855261580949967,
            "cornish_fisher": -0.010842520327421492,
            "cvar_historical": -0.010851965835266184,
            "cvar_parametric": -0.010744937577491034
          },
          "99": {
            "historical": -0.010831262026893275,
            "parametric": -0.01067533212822597,
            "cornish_fisher": -0.010740827709024424,
            "cvar_historical": -0.010821130652355855,
            "cvar_parametric": -0.01058586396837335
          }
        }
      }
    },
    "series": [
      {
        "code": "BTAG11",
        "name": "BTG Pactual Credito Agricola Fiagro Responsabilidade Limitada",
        "asset_class": "fundo_listado",
        "series_id": "28da4fef-5740-4d3a-87f6-6500d0457739",
        "metrics": {
          "periods": 186,
          "years": 0.7380952380952381,
          "total_return": -0.060935158444359816,
          "annualized_return": null,
          "annualized_return_note": "Periodo menor que 1 ano: sem anualizacao",
          "arithmetic_mean": -0.04594636986389745,
          "geometric_mean": -0.08165277903325019,
          "risk_free_return": 0.10445586364906156,
          "excess_return": null,
          "volatility": 0.28172402826131154,
          "downside_deviation": 0.1920686938553699,
          "max_drawdown": {
            "depth": -0.1394345421581662,
            "peak": "2026-05-05",
            "trough": "2026-09-29",
            "recovery": null,
            "length": 103,
            "recovery_periods": null
          },
          "ulcer_index": 0.07799128910080629,
          "skewness": 0.640572377236587,
          "excess_kurtosis": 4.049416034461698,
          "sharpe": -0.6410185487684482,
          "sortino": -0.9402331166686074,
          "calmar": null,
          "omega": 0.8870697072918328,
          "gain_loss": 1.1758741423133139,
          "positive_periods": 0.43010752688172044,
          "best_period": 0.08715607338700959,
          "worst_period": -0.061097467877082146,
          "best_month": 0.07486530618043918,
          "worst_month": -0.07896594786846789,
          "best_year": -0.06093515844436048,
          "worst_year": -0.06093515844436048,
          "var": {
            "95": {
              "historical": 0.025715297623328248,
              "parametric": 0.02937345477762456,
              "cornish_fisher": 0.02455489737325725,
              "cvar_historical": 0.038211724816165527,
              "cvar_parametric": 0.03678917894262086
            },
            "99": {
              "historical": 0.04453939283954842,
              "parametric": 0.0414678961387612,
              "cornish_fisher": 0.0471692273744329,
              "cvar_historical": 0.05582647178881045,
              "cvar_parametric": 0.047481738767884044
            }
          },
          "var_month": {
            "95": {
              "historical": 0.09008240772502724,
              "parametric": 0.0825469397260313,
              "cornish_fisher": 0.08526793076306394,
              "cvar_historical": 0.09799103443340368,
              "cvar_parametric": 0.10199931247413
            },
            "99": {
              "historical": 0.10252437816620089,
              "parametric": 0.11427217333805703,
              "cornish_fisher": 0.12007431872030302,
              "cvar_historical": 0.11170912260708658,
              "cvar_parametric": 0.13004723533703064
            }
          },
          "relative": {
            "beta": 9.389215680485698,
            "alpha": -0.18058934663810305,
            "correlation": 0.0073402164957661244,
            "r_squared": 0.000053878778204717126,
            "active_return": -0.22573984397398617,
            "tracking_error": 0.28172249771096164,
            "information_ratio": -0.641018548768448,
            "upside_capture": -0.632527194792988,
            "downside_capture": null,
            "batting_average": 0.40860215053763443,
            "treynor": -0.01923369882890594
          }
        }
      },
      {
        "code": "CDI",
        "name": "Taxa de juros - CDI",
        "asset_class": "caixa",
        "series_id": "911a1e56-fb1b-4c30-8dc5-950612072e91",
        "metrics": {
          "periods": 186,
          "years": 0.7380952380952381,
          "total_return": 0.10445586364906156,
          "annualized_return": null,
          "annualized_return_note": "Periodo menor que 1 ano: sem anualizacao",
          "arithmetic_mean": 0.1346429767742056,
          "geometric_mean": 0.14408706494073598,
          "risk_free_return": 0.10445586364906156,
          "excess_return": null,
          "volatility": 0.0002202436742182057,
          "downside_deviation": 0,
          "max_drawdown": {
            "depth": 0,
            "peak": null,
            "trough": null,
            "recovery": null,
            "length": 0,
            "recovery_periods": null
          },
          "ulcer_index": 0,
          "skewness": -0.20909797019089638,
          "excess_kurtosis": -1.1881790684399227,
          "sharpe": null,
          "sortino": null,
          "calmar": null,
          "omega": null,
          "gain_loss": null,
          "positive_periods": 1,
          "best_period": 0.0005513100000000826,
          "worst_period": 0.0005078800000000161,
          "best_month": 0.012152202899923692,
          "worst_month": 0.009970220253081363,
          "best_year": 0.1044558636490609,
          "worst_year": 0.1044558636490609,
          "var": {
            "95": {
              "historical": -0.0005100600000000345,
              "parametric": -0.0005114767497338986,
              "cornish_fisher": -0.0005103308264557911,
              "cvar_historical": -0.0005078800000000161,
              "cvar_parametric": -0.0005056793516661251
            },
            "99": {
              "historical": -0.0005078800000000161,
              "parametric": -0.0005020216662629118,
              "cornish_fisher": -0.0005039707324133836,
              "cvar_historical": -0.0005078800000000161,
              "cvar_parametric": -0.000497320218519947
            }
          },
          "var_month": {
            "95": {
              "historical": -0.010889409274033148,
              "parametric": -0.010855261580949967,
              "cornish_fisher": -0.010842520327421492,
              "cvar_historical": -0.010851965835266184,
              "cvar_parametric": -0.010744937577491034
            },
            "99": {
              "historical": -0.010831262026893275,
              "parametric": -0.01067533212822597,
              "cornish_fisher": -0.010740827709024424,
              "cvar_historical": -0.010821130652355855,
              "cvar_parametric": -0.01058586396837335
            }
          },
          "relative": {
            "beta": 1.0000000000000002,
            "alpha": 0,
            "correlation": 1,
            "r_squared": 1,
            "active_return": 0,
            "tracking_error": 0,
            "information_ratio": null,
            "upside_capture": 1,
            "downside_capture": null,
            "batting_average": 0,
            "treynor": 0
          }
        }
      }
    ],
    "growth": {
      "BTAG11": [
        [
          "2026-01-02",
          100
        ],
        [
          "2026-01-05",
          100.0428032143958
        ],
        [
          "2026-01-06",
          100.89780466854566
        ]
      ],
      "CDI": [
        [
          "2026-01-02",
          100
        ],
        [
          "2026-01-05",
          100.055131
        ],
        [
          "2026-01-06",
          100.11029239427162
        ]
      ]
    },
    "drawdown": {
      "BTAG11": [
        [
          "2026-01-05",
          0
        ],
        [
          "2026-01-06",
          0
        ],
        [
          "2026-01-07",
          -0.0075421757587423865
        ]
      ],
      "CDI": [
        [
          "2026-01-05",
          0
        ],
        [
          "2026-01-06",
          0
        ],
        [
          "2026-01-07",
          0
        ]
      ]
    },
    "rolling": {
      "window": 252,
      "series": "BTAG11",
      "points": []
    },
    "calendar": {
      "monthly": {
        "2026": [
          -0.03605421998146752,
          -0.012299855460911613,
          0.07486530618043918
        ]
      },
      "annual": {
        "2026": -0.06093515844436048
      }
    },
    "drawdowns": [
      {
        "peak": "2026-05-05",
        "depth": -0.1394345421581662,
        "trough": "2026-09-29",
        "recovery": null,
        "recovery_periods": null
      },
      {
        "peak": "2026-01-19",
        "depth": -0.10924344513053408,
        "trough": "2026-01-28",
        "recovery": "2026-03-27",
        "recovery_periods": 40
      },
      {
        "peak": "2026-03-27",
        "depth": -0.0662858824719702,
        "trough": "2026-04-29",
        "recovery": "2026-05-05",
        "recovery_periods": 3
      }
    ],
    "correlation": {
      "labels": [
        "BTAG11",
        "CDI"
      ],
      "matrix": [
        [
          1,
          0.0073402164957661244
        ],
        [
          0.007340216495766125,
          1
        ]
      ]
    },
    "portfolio": null,
    "warnings": [],
    "attributions": []
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}
```