GETEstavel/timeseries/{ticker}/{param}

Consultar serie temporal

Retorna observacoes historicas de um parametro de mercado para o ticker solicitado.

Parametros

Parametros de path

Nome	Tipo	Exigencia	Descricao
ticker	string	Obrigatorio	Ticker do ativo.
param	string	Obrigatorio	Parametro historico a consultar.

Parametros de query

Nome	Tipo	Exigencia	Descricao
limit	integer	Opcional	Quantidade maxima de observacoes, entre 1 e 1000.
cursor	integer	Opcional	Cursor numerico para continuar a leitura.

Resposta

Sucesso HTTP: 200

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

{
  "pagination": {
    "limit": 30,
    "cursor": null
  },
  "ticker": "PETR4",
  "timeseries": []
}

Erros

Status	Descricao
400	Parametros ou corpo da requisicao invalidos.
404	Recurso solicitado nao encontrado.
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: Consultar serie temporal

// 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/timeseries/PETR4/close?limit=30", { method: "GET", headers: { "X-API-Key": apiKey } }); if (!response.ok) throw new Error(`HTTP ${response.status}`); console.log(await response.json());

import os import requests response = requests.get( "https://api.crivo.ai/timeseries/PETR4/close?limit=30", headers={"X-API-Key": os.environ["CRIVO_API_KEY"]}, timeout=30, ) response.raise_for_status() print(response.json())