POSTEstavel/screener/v2

Executar screener v2

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

Parametros

Parametros de body

Nome	Tipo	Exigencia	Descricao
prompt	string	Obrigatorio	Pergunta ou criterio de selecao em linguagem natural.

Resposta

Sucesso HTTP: 200

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

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

Erros

Status	Descricao
400	Parametros ou corpo da requisicao invalidos.
404	Recurso solicitado nao encontrado.
422	A solicitacao nao pode ser processada pelo modelo.
502	Falha ao consultar o provedor de IA.
204	Nenhum dado encontrado para os criterios informados.
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: Executar screener de acoes

// 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/screener/v2", { method: "POST", headers: { "X-API-Key": apiKey, "Content-Type": "application/json" }, body: JSON.stringify({"prompt":"acoes de dividendos"}) }); 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/screener/v2", headers={"X-API-Key": os.environ["CRIVO_API_KEY"]}, json=json.loads("{\"prompt\":\"acoes de dividendos\"}"), timeout=30, ) response.raise_for_status() print(response.json())