# Crivo API

Crivo oferece dados e contexto do mercado brasileiro para agentes de IA por MCP e API HTTP. A pesquisa documental recupera evidências com origem e período de referência, quando disponíveis.

## Conexao
- API URL: https://api.crivo.ai
- Autenticacao: X-API-Key: crv_live_...
- MCP endpoint: https://api.crivo.ai/mcp

## Documentacao
- [Introduction](https://app.crivo.ai/docs)
- [Conectar via MCP](https://app.crivo.ai/docs#configuracao-mcp)
- [Contexto financeiro](https://app.crivo.ai/docs#contexto-financeiro)
- [Authentication](https://app.crivo.ai/docs/authentication)

## Referencias
- [Solicitar fórum de analistas](https://app.crivo.ai/docs/endpoints/post-council): Congela os dados de uma ação BVMF e solicita fundamentalista, técnico e valuation. Envie Idempotency-Key (8–128 caracteres). Retorna 202 com run_id para acompanhamento ou 200 para resultado já disponível. Requer COUNCIL_ENABLED no servidor. Não aceita perguntas privadas ou overrides.
- [Acompanhar fórum](https://app.crivo.ai/docs/endpoints/get-council-run): Lê o status de uma execução e a ata disponível. Não inicia chamadas de IA. Status: queued, running, completed, failed ou expired; uma execução pode conter pareceres parciais.
- [Consultar última ata](https://app.crivo.ai/docs/endpoints/get-council-latest): Retorna a última ata canônica do ticker, inclusive abstenções e divergências. Conteúdo público de mercado compartilhado entre clientes autenticados elegíveis; retorna report null quando não existe. Sem chamadas de IA.
- [Histórico do fórum](https://app.crivo.ai/docs/endpoints/get-council-history): Atas imutáveis do ticker, com votos, confiança metodológica, critérios e evidências. Use next_cursor em before para a página seguinte. Sem média de confiança ou recomendação por maioria.
- [Executar screener v2](https://app.crivo.ai/docs/endpoints/post-screener-v2): Interpreta um prompt de investimento e retorna a selecao de acoes encontrada.
- [Paginar screener v2](https://app.crivo.ai/docs/endpoints/get-screener-v2-page): Recupera uma pagina adicional de resultados de uma execucao anterior do screener.
- [Listar acoes](https://app.crivo.ai/docs/endpoints/get-stocks): Lista acoes cadastradas e permite busca textual ou paginacao de um resultado em cache.
- [Consultar serie temporal](https://app.crivo.ai/docs/endpoints/get-timeseries): Retorna observacoes historicas de um parametro de mercado para o ticker solicitado.
- [Consultar indicador tecnico](https://app.crivo.ai/docs/endpoints/get-indicators): Calcula uma serie de indicador tecnico para um ticker usando os parametros informados.
- [Consultar fundamentos](https://app.crivo.ai/docs/endpoints/get-fundamentals): Retorna indicadores fundamentalistas calculados a partir do ultimo demonstrativo disponivel.
- [Consultar candles OHLC](https://app.crivo.ai/docs/endpoints/get-ohlc): Retorna candles historicos com abertura, maxima, minima, fechamento e volume do ativo.
- [Consultar companhia](https://app.crivo.ai/docs/endpoints/get-company): Retorna os dados cadastrais e a classificacao setorial de uma companhia pelo codigo CVM.
- [Pesquisar relatorios](https://app.crivo.ai/docs/endpoints/post-reports-search): Pesquisa trechos de relatorios corporativos com filtros de companhia, periodo e tipo documental.
- [Consultar taxa livre de risco](https://app.crivo.ai/docs/endpoints/get-risk-free-rate): Retorna a taxa livre de risco brasileira e os dados de referencia da curva ANBIMA.
- [Listar series macroeconomicas](https://app.crivo.ai/docs/endpoints/get-macro-series): Lista as series macroeconomicas disponiveis, com opcao de limitar a um provedor especifico.
- [Consultar observacoes macroeconomicas](https://app.crivo.ai/docs/endpoints/get-macro-series-observations): Retorna observacoes de uma serie macroeconomica para o provedor e codigo selecionados.
- [Listar ativos](https://app.crivo.ai/docs/endpoints/get-assets): Lista ativos negociaveis por classe e texto de busca no catalogo de mercado.
- [Consultar precos de ativo](https://app.crivo.ai/docs/endpoints/get-asset-prices): Retorna a serie de precos e volumes de um ativo identificado por bolsa e simbolo.
- [Listar classes de fundos](https://app.crivo.ai/docs/endpoints/get-fund-classes): Lista classes de fundos registradas com filtros por situacao cadastral e texto de busca.
- [Consultar informes diarios de fundo](https://app.crivo.ai/docs/endpoints/get-fund-daily-reports): Retorna informes diarios de uma classe de fundo dentro do intervalo de datas selecionado.
- [Listar titulos publicos](https://app.crivo.ai/docs/endpoints/get-public-bonds): Lista titulos publicos disponiveis com filtros por tipo de titulo e texto de busca.
- [Consultar precos de titulo publico](https://app.crivo.ai/docs/endpoints/get-public-bond-prices): Retorna taxas e precos historicos de compra e venda para um titulo publico.
- [Listar credito privado](https://app.crivo.ai/docs/endpoints/get-private-credit): Lista valores mobiliarios de credito privado por tipo e texto de busca.
- [Consultar precos de credito privado](https://app.crivo.ai/docs/endpoints/get-private-credit-prices): Retorna taxas indicativas e precos historicos de um valor mobiliario de credito privado.
- [Listar eventos de noticias](https://app.crivo.ai/docs/endpoints/get-news-events): Lista eventos de noticias classificados, com filtros por status, ativo, setor e periodo.
- [Consultar evento de noticia](https://app.crivo.ai/docs/endpoints/get-news-event): Retorna o evento de noticia completo, incluindo analise, evidencias e cronologia associada.
- [Solicitar fórum de três analistas](https://app.crivo.ai/docs/mcp/crivo_council_request): Solicita o fórum canônico de uma ação BVMF com idempotência, sem contexto privado. Pode retornar um job queued; use crivo_council_get para acompanhar. Depende de COUNCIL_ENABLED.
- [Consultar fórum e andamento](https://app.crivo.ai/docs/mcp/crivo_council_get): Lê atas e status sem iniciar chamadas de IA. Forneça exatamente um: ticker para a última ata ou run_id para acompanhar um job.
- [Executar screener de acoes](https://app.crivo.ai/docs/mcp/crivo_screen_stocks): Interpreta um pedido em linguagem natural e retorna a selecao de acoes B3 encontrada pelo screener Crivo.
- [Paginar resultado do screener](https://app.crivo.ai/docs/mcp/crivo_get_screener_page): Recupera uma pagina em cache retornada por uma execucao anterior do screener de acoes.
- [Pesquisar acoes](https://app.crivo.ai/docs/mcp/crivo_search_stocks): Pesquisa acoes B3 por um trecho do ticker ou do nome da companhia, sem paginacao de cache.
- [Paginar pesquisa de acoes](https://app.crivo.ai/docs/mcp/crivo_get_stocks_page): Recupera uma pagina em cache de uma pesquisa ou listagem anterior de acoes B3.
- [Consultar fundamentos](https://app.crivo.ai/docs/mcp/crivo_get_fundamentals): Retorna os indicadores fundamentalistas calculados para um ticker negociado na B3.
- [Consultar serie temporal](https://app.crivo.ai/docs/mcp/crivo_get_timeseries): Retorna observacoes historicas de um parametro de mercado para um ticker ou indice suportado.
- [Consultar indicador tecnico](https://app.crivo.ai/docs/mcp/crivo_get_indicators): Calcula uma serie de indicador tecnico para um ticker B3 usando os parametros informados.
- [Consultar candles OHLC](https://app.crivo.ai/docs/mcp/crivo_get_ohlc): Retorna candles historicos com abertura, maxima, minima, fechamento e volume para um ticker B3.
- [Consultar companhia](https://app.crivo.ai/docs/mcp/crivo_get_company): Retorna dados cadastrais e classificacao setorial de uma companhia pelo codigo CVM.
- [Consultar taxa livre de risco](https://app.crivo.ai/docs/mcp/crivo_get_risk_free_rate): Retorna a taxa livre de risco brasileira, opcionalmente para uma data ISO especifica.
- [Pesquisar relatorios](https://app.crivo.ai/docs/mcp/crivo_search_reports): Pesquisa trechos de relatorios CVM por consulta semantica e filtros estruturados de companhia e periodo.
- [Responder com evidências](https://app.crivo.ai/docs/mcp/crivo_answer_reports): Beta: gera uma síntese fundamentada em trechos de relatórios CVM, com afirmações citadas, fontes e estado de cobertura. Confira a disponibilidade via tools/list no servidor conectado.
- [Listar eventos de noticias](https://app.crivo.ai/docs/mcp/crivo_list_news_events): Lista eventos de noticias de mercado processados, com filtros por status, ativo, setor e intervalo.
- [Consultar evento de noticia](https://app.crivo.ai/docs/mcp/crivo_get_news_event): Retorna o detalhe completo de um evento de noticia processado, incluindo analise e evidencias.
- [Listar series macroeconomicas](https://app.crivo.ai/docs/mcp/crivo_list_macro_series): Lista as series macroeconomicas disponiveis, com filtro opcional pelo identificador do provedor.
- [Consultar observacoes macroeconomicas](https://app.crivo.ai/docs/mcp/crivo_get_macro_series_observations): Retorna observacoes de uma serie macroeconomica pelo provedor, codigo e intervalo de datas informados.
- [Listar ativos](https://app.crivo.ai/docs/mcp/crivo_list_assets): Lista ativos negociaveis por classe, texto de busca e limite no catalogo de mercado.
- [Consultar precos de ativo](https://app.crivo.ai/docs/mcp/crivo_get_asset_prices): Retorna a serie de precos e volumes para um ativo identificado por bolsa e simbolo.
- [Listar classes de fundos](https://app.crivo.ai/docs/mcp/crivo_list_fund_classes): Lista classes de fundos brasileiros por situacao cadastral, texto de busca e limite informado.
- [Consultar informes diarios de fundo](https://app.crivo.ai/docs/mcp/crivo_get_fund_daily_reports): Retorna informes diarios de uma classe de fundo brasileira dentro do intervalo de datas selecionado.
- [Listar titulos publicos](https://app.crivo.ai/docs/mcp/crivo_list_public_bonds): Lista titulos publicos brasileiros por tipo, texto de busca e quantidade maxima de resultados.
- [Consultar precos de titulo publico](https://app.crivo.ai/docs/mcp/crivo_get_public_bond_prices): Retorna taxas e precos historicos de compra e venda para um titulo publico brasileiro.
- [Listar credito privado](https://app.crivo.ai/docs/mcp/crivo_list_private_credit): Lista valores mobiliarios de credito privado por tipo, texto de busca e quantidade maxima.
- [Consultar precos de credito privado](https://app.crivo.ai/docs/mcp/crivo_get_private_credit_prices): Retorna taxas indicativas e precos historicos de um valor mobiliario de credito privado.