POSTEstavel/screener/v2

Executar screener v2

Interpreta um prompt de investimento e retorna a selecao de acoes encontrada.

Parametros

Parametros de body

NomeTipoExigenciaDescricao
promptstringObrigatorioPergunta ou criterio de selecao em linguagem natural.

Resposta

Sucesso HTTP
200
{"cache_key":"screen_abc","page":1,"has_next_page":false,"total_count":0,"stocks":[],"tool_calls_executed":[],"parsed_filters":[]}

Erros

StatusDescricao
400Parametros ou corpo da requisicao invalidos.
404Recurso solicitado nao encontrado.
422A solicitacao nao pode ser processada pelo modelo.
502Falha ao consultar o provedor de IA.
204Nenhum dado encontrado para os criterios informados.
401Chave de API ausente ou invalida.
403Uma assinatura paga ativa e necessaria para acessar a API.
429Limite de requisicoes excedido.
500Erro interno inesperado.
503Servico temporariamente indisponivel. Tente novamente mais tarde.

Relacionados

MCP relacionado: Executar screener de acoes
Exemplos de codigo

curl -X POST "https://api.crivo.ai/screener/v2" \
  -H "X-API-Key: crv_live_..." \
  -H "Content-Type: application/json" \
  -d '{"prompt":"acoes de dividendos"}'