# 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).

## Comece aqui

- [Primeiros passos](https://fintay.com.br/docs/primeiros-passos): Da criação da chave à primeira consulta, em poucos minutos.
- [Chaves e limites](https://fintay.com.br/docs/autenticacao): Como autenticar, quanto cada plano consulta e o que fazer quando uma chamada é recusada.

## Dados

- [Séries e cotações](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.
- [Qualidade dos dados](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.
- [Fundos de investimento](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.

## Ferramentas

- [Painel](https://fintay.com.br/docs/ferramentas): Onde encontrar pesquisa, ativos, carteiras, mercado e conta no menu do painel.
- [Terminal](https://fintay.com.br/docs/terminal): Comandos, abas e painéis para acompanhar o mercado em uma tela só.
- [Excel](https://fintay.com.br/docs/excel): Instale o suplemento e traga séries, ações, fundos e Tesouro direto para as células.
- [IA e conectores](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.

## Referência da API

- [Introdução](https://fintay.com.br/docs/api): URL base, autenticação, formato das respostas e paginação.
- [Erros e limites](https://fintay.com.br/docs/api/erros): objeto de erro, códigos HTTP e limites por plano.

### Séries

- [Buscar séries](https://fintay.com.br/docs/api/series-catalogo): `GET /v1/series/catalog` — 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.
- [Listar fontes](https://fintay.com.br/docs/api/series-fontes): `GET /v1/series/sources` — Fontes disponíveis no catálogo de séries. O valor de cada item é o primeiro segmento dos caminhos de cotação.
- [Detalhes de uma série](https://fintay.com.br/docs/api/series-detalhe): `GET /v1/series/{series_id}` — Metadados de uma série pelo `series_id`: nome, fonte, identificadores, frequência, unidade e período coberto.
- [Cotações por fonte e código](https://fintay.com.br/docs/api/series-cotacoes-codigo): `GET /v1/series/{source}/{code}/quotes` — 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.
- [Cotações com tipo de identificador](https://fintay.com.br/docs/api/series-cotacoes-tipo): `GET /v1/series/{source}/{type1}/{code}/quotes` — 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.
- [Cotações por series_id](https://fintay.com.br/docs/api/series-cotacoes-id): `GET /v1/series/{series_id}/quotes` — Histórico completo ou recortado de qualquer série do catálogo pelo `series_id`.
- [Cotações ajustadas por proventos](https://fintay.com.br/docs/api/series-cotacoes-ajustadas): `GET /v1/series/{series_id}/adjusted-quotes` — Preços de um ativo da B3 ajustados por dividendos, JCP, desdobramentos e grupamentos, prontos para calcular retorno total.
- [Fundamentos de um ativo](https://fintay.com.br/docs/api/series-fundamentos): `GET /v1/series/{source}/{code}/fundamentals` — 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.

### Ações e índices

- [Listar ativos da B3](https://fintay.com.br/docs/api/b3-tickers): `GET /v1/b3/tickers` — Ações, units, FIIs, ETFs e BDRs negociados na B3, com último fechamento e `series_id` de cada um.
- [Proventos e eventos de um ativo](https://fintay.com.br/docs/api/b3-proventos-ativo): `GET /v1/b3/{ticker}/events` — Dividendos, JCP, rendimentos, desdobramentos, grupamentos e bonificações de um ativo, com data-ex, data de pagamento e valor por ação.
- [Agenda de proventos](https://fintay.com.br/docs/api/b3-agenda-proventos): `GET /v1/b3/events/calendar` — Próximas datas-ex e pagamentos do mercado inteiro, por padrão de hoje até 90 dias à frente.
- [Listar índices](https://fintay.com.br/docs/api/indices-lista): `GET /v1/indices` — Índices de bolsa e de renda fixa com o último fechamento e a variação do dia.
- [Histórico de um índice](https://fintay.com.br/docs/api/indices-historico): `GET /v1/indices/{ticker}` — Série histórica de fechamento de um índice, como `^BVSP` (Ibovespa) ou `IFIX.SA`.
- [Carteira teórica de um índice](https://fintay.com.br/docs/api/b3-composicao-indice): `GET /v1/b3/index-composition/{code}` — Ativos e pesos da carteira teórica de um índice da B3 numa data.
- [Cotações do pregão](https://fintay.com.br/docs/api/cotacoes-ao-vivo): `GET /v1/live/quotes` — Ú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.
- [Buscar ações internacionais](https://fintay.com.br/docs/api/internacional-busca): `GET /v1/international/tickers` — Busca ações de bolsas fora do Brasil por ticker ou nome, com país e bolsa de listagem.

### Empresas

- [Demonstrações financeiras](https://fintay.com.br/docs/api/empresas-demonstrativos): `GET /v1/companies/{cnpj}/statements` — 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.
- [Demonstrativo em colunas](https://fintay.com.br/docs/api/empresas-comparativo): `GET /v1/companies/{cnpj}/statements/comparison` — Uma demonstração em formato de planilha: contas nas linhas e períodos nas colunas, pronta para análise horizontal.
- [Acionistas e free float](https://fintay.com.br/docs/api/empresas-acionistas): `GET /v1/companies/{cnpj}/shareholders` — Composição acionária informada pela companhia: controladores, principais acionistas, ações em tesouraria e free float.
- [Negociações de administradores](https://fintay.com.br/docs/api/empresas-insiders): `GET /v1/companies/{cnpj}/insiders` — Compras e vendas de ações por controladores, conselheiros e diretores, mês a mês.
- [Fatos relevantes e comunicados](https://fintay.com.br/docs/api/comunicados): `GET /v1/disclosures` — Documentos entregues pelas companhias à CVM, classificados por assunto e relevância, com resumo quando disponível.
- [Destaques dos comunicados](https://fintay.com.br/docs/api/comunicados-destaques): `GET /v1/disclosures/highlights` — Os comunicados mais relevantes do período, com o tom (positivo, negativo ou neutro) de cada um.

### Fundos

- [Buscar fundos](https://fintay.com.br/docs/api/fundos-busca): `GET /v1/funds` — Fundos de investimento registrados na CVM, com patrimônio, cotistas, data do último informe e situação.
- [Detalhes e cotas de um fundo](https://fintay.com.br/docs/api/fundos-detalhe): `GET /v1/funds/{cnpj_fundo}` — Cadastro do fundo, suas classes e o informe diário: cota, patrimônio, captação, resgates e número de cotistas.
- [Carteira de um fundo](https://fintay.com.br/docs/api/fundos-carteira): `GET /v1/funds/{cnpj}/portfolio` — Posições da carteira aberta (CDA) de um fundo numa competência: ativo, emissor, quantidade e valor de mercado.
- [Buscar gestoras](https://fintay.com.br/docs/api/fundos-gestoras): `GET /v1/funds/managers` — Gestoras de recursos com patrimônio sob gestão e quantidade de fundos.
- [Captação líquida da indústria](https://fintay.com.br/docs/api/fundos-fluxo): `GET /v1/funds/flows` — Captação e resgates mensais dos fundos, agrupados por categoria ou gestora.
- [Listar FIIs](https://fintay.com.br/docs/api/fiis-lista): `GET /v1/fiis` — Fundos imobiliários com o informe mensal mais recente entregue à CVM.
- [Informe mensal de um FII](https://fintay.com.br/docs/api/fiis-mensal): `GET /v1/fiis/{identity}/monthly` — Indicadores mensais de um fundo imobiliário: patrimônio, valor patrimonial da cota, rendimentos distribuídos e cotistas.
- [Fundos que têm um ativo](https://fintay.com.br/docs/api/fundos-que-compram): `GET /v1/assets/{series_id}/fund-holders` — Fundos que carregam um ativo na carteira, com valor e participação no patrimônio de cada um.

### Tesouro e renda fixa

- [Títulos do Tesouro Direto](https://fintay.com.br/docs/api/tesouro-titulos): `GET /v1/fixed-income/tesouro` — Títulos vivos (e, se pedido, vencidos) com taxa e preço de compra e venda do último dia.
- [Histórico de um título](https://fintay.com.br/docs/api/tesouro-historico): `GET /v1/fixed-income/tesouro/{codigo}/quotes` — Taxas e preços diários de um título do Tesouro Direto desde a primeira negociação.
- [Curva do Tesouro](https://fintay.com.br/docs/api/tesouro-curva): `GET /v1/fixed-income/tesouro/curva` — Taxas de compra dos títulos de um indexador por vencimento, numa data.
- [Inflação implícita](https://fintay.com.br/docs/api/inflacao-implicita): `GET /v1/fixed-income/inflacao-implicita` — Inflação implícita por vencimento, da diferença entre as taxas prefixadas e as atreladas ao IPCA.
- [Leilões de títulos públicos](https://fintay.com.br/docs/api/tesouro-leiloes): `GET /v1/fixed-income/leiloes` — Resultados dos leilões do Tesouro Nacional: título, quantidade ofertada e aceita, taxa e financeiro.
- [Ofertas de debêntures, CRI e CRA](https://fintay.com.br/docs/api/credito-ofertas): `GET /v1/fixed-income/credito` — Ofertas registradas na CVM com emissor, série, prazo, remuneração, garantias e a faixa de risco do emissor.
- [ETTJ ANBIMA](https://fintay.com.br/docs/api/anbima-ettj): `GET /v1/fixed-income/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.
- [Taxas indicativas de títulos públicos](https://fintay.com.br/docs/api/anbima-titulos-publicos): `GET /v1/fixed-income/anbima/titulos-publicos` — Taxas indicativas, PU e intervalos de negociação dos títulos públicos federais divulgados pela ANBIMA.

### Juros e curvas

- [Curva DI](https://fintay.com.br/docs/api/curva-di): `GET /v1/curves/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.
- [Histórico da curva DI por prazo](https://fintay.com.br/docs/api/curva-di-historico): `GET /v1/curves/di/history` — Taxa DI em prazos fixos (1, 2, 5 anos…) em cada pregão, para acompanhar a curva no tempo.
- [Curvas de juro real e inflação implícita](https://fintay.com.br/docs/api/curvas-mercado): `GET /v1/curves/market` — Curvas de mercado da B3: prefixada (`pre`), juro real pelo cupom de IPCA (`real`) e inflação implícita (`implicita`).
- [Curva pelos índices IDkA](https://fintay.com.br/docs/api/curva-idka): `GET /v1/curves/idka` — Taxas por prazo dos índices IDkA Pré e IDkA IPCA da ANBIMA.

### Expectativas (Focus)

- [Indicadores do Focus](https://fintay.com.br/docs/api/focus-indicadores): `GET /v1/focus/indicators` — Indicadores e frequências disponíveis no Boletim Focus, com a data da coleta mais recente.
- [Quadro do Focus](https://fintay.com.br/docs/api/focus-quadro): `GET /v1/focus/snapshot` — 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.
- [Expectativas por coleta](https://fintay.com.br/docs/api/focus-expectativas): `GET /v1/focus/expectations` — As estatísticas de cada coleta do Focus: mediana, média, desvio, mínimo, máximo e número de respondentes.
- [Histórico das expectativas](https://fintay.com.br/docs/api/focus-historico): `GET /v1/focus/history` — Evolução da mediana de um indicador ao longo das coletas, por ano de referência ou por horizonte.

### Câmbio, cripto e derivativos

- [Moedas e criptoativos disponíveis](https://fintay.com.br/docs/api/mercados-simbolos): `GET /v1/markets/{market}/symbols` — Símbolos com histórico em cada mercado: moedas (`currency`) e criptoativos (`crypto`).
- [Histórico de câmbio ou cripto](https://fintay.com.br/docs/api/mercados-cotacoes): `GET /v1/markets/{market}/{symbol}/quotes` — Fechamentos diários de uma moeda ou criptoativo, na moeda de cotação pedida.
- [Estrutura a termo de um futuro](https://fintay.com.br/docs/api/futuros-estrutura): `GET /v1/futures/{underlying}/term-structure` — Ajuste, volume e contratos em aberto de cada vencimento de um contrato futuro da B3 num pregão.
- [Cadeia de opções](https://fintay.com.br/docs/api/opcoes-cadeia): `GET /v1/derivatives/{market}/chain` — Opções de um ativo-objeto por vencimento e strike, com prêmio, volume e contratos em aberto.

### Risco de crédito

- [Risco de crédito de emissores](https://fintay.com.br/docs/api/credito-emissores): `GET /v1/credit-risk/issuers` — Probabilidade de inadimplência em 12 meses e faixa de risco de companhias abertas e emissoras de dívida.
- [Risco de crédito de um emissor](https://fintay.com.br/docs/api/credito-emissor): `GET /v1/credit-risk/issuers/{cnpj}` — Probabilidade de inadimplência, faixa, indicadores do balanço e histórico de um emissor.
- [Risco de crédito de bancos](https://fintay.com.br/docs/api/credito-bancos): `GET /v1/credit-risk/banks` — Instituições financeiras com capital, rentabilidade, qualidade da carteira e probabilidade de inadimplência.

### Bases de dados

- [Registros de uma base](https://fintay.com.br/docs/api/bases-registros): `GET /v1/datasets/{dataset}/records` — 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`).

### Carteiras e análises

- [Listar carteiras](https://fintay.com.br/docs/api/carteiras-lista): `GET /v1/portfolios` — 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.
- [Rodar uma análise de carteira](https://fintay.com.br/docs/api/analises-ferramenta): `POST /v1/analytics/{tool}` — 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).

## Opcional

- [Documentação completa em um arquivo](https://fintay.com.br/llms-full.txt)