POSTBeta/v1/council

Solicitar fórum de analistas

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.

Ver exemplos de código

Parametros

Parametros de body

Nome	Tipo	Exigencia	Descricao
ticker	string	Obrigatorio	Ticker de ação BVMF
exchange	string	Opcional	BVMF; padrão BVMF

Resposta

Sucesso HTTP: 200

Resposta ilustrativa. Valores e datas fictícios; não representa uma consulta atual.

{
  "run_id": "12345678-1234-1234-1234-123456789abc",
  "ticker": "PETR4",
  "status": "queued",
  "report": null,
  "error": null,
  "poll_url": "/v1/council/runs/12345678-1234-1234-1234-123456789abc"
}

Erros

Status	Descricao
400	Parametros ou corpo da requisicao invalidos.
404	Recurso solicitado nao encontrado.
409	Chave de idempotência reutilizada para outro ticker.
401	Chave de API ausente ou invalida.
403	Uma assinatura paga ativa e necessaria para acessar a API.
429	Limite de requisicoes excedido.
500	Erro interno inesperado.
503	Servico temporariamente indisponivel. Tente novamente mais tarde.

Relacionados

MCP relacionado: Solicitar fórum de três analistas

curl --fail-with-body -X POST "https://api.crivo.ai/v1/council" \ -H "X-API-Key: $CRIVO_API_KEY" -H "Idempotency-Key: council-example-001" \ -H "Content-Type: application/json" \ -d '{"ticker":"PETR4"}'

// Node.js — execute no servidor const apiKey = process.env.CRIVO_API_KEY; if (!apiKey) throw new Error("Defina CRIVO_API_KEY"); const response = await fetch("https://api.crivo.ai/v1/council", { method: "POST", headers: { "X-API-Key": apiKey, "Idempotency-Key": "council-example-001", "Content-Type": "application/json" }, body: JSON.stringify({"ticker":"PETR4"}) }); if (!response.ok) throw new Error(`HTTP ${response.status}`); console.log(await response.json());

import os import json import requests response = requests.post( "https://api.crivo.ai/v1/council", headers={"X-API-Key": os.environ["CRIVO_API_KEY"], "Idempotency-Key": "council-example-001"}, json=json.loads("{\"ticker\":\"PETR4\"}"), timeout=30, ) response.raise_for_status() print(response.json())