GETEstavel/stocks

Listar acoes

Lista acoes cadastradas e permite busca textual ou paginacao de um resultado em cache.

Parametros

Parametros de query

NomeTipoExigenciaDescricao
searchstringOpcionalTexto para filtrar por ticker ou nome.
cache_keystringOpcionalChave de cache para consultar um resultado paginado.
pageintegerOpcionalPagina do resultado em cache; obrigatoria quando cache_key for informado.

Resposta

Sucesso HTTP
200
{"pagination":{"cache_key":"stocks_abc","page":1,"has_next_page":false},"stocks":[]}

Erros

StatusDescricao
400Parametros ou corpo da requisicao invalidos.
404Recurso solicitado nao encontrado.
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: Pesquisar acoes
Exemplos de codigo

curl -X GET "https://api.crivo.ai/stocks?search=PETR4" \
  -H "X-API-Key: crv_live_..."