GETEstavel/macro/series/{provider}/{code}/observations

Consultar observacoes macroeconomicas

Retorna observacoes de uma serie macroeconomica para o provedor e codigo selecionados.

Parametros

Parametros de path

Nome	Tipo	Exigencia	Descricao
provider	string	Obrigatorio	Identificador do provedor de dados.
code	string	Obrigatorio	Codigo da serie no provedor.

Parametros de query

Nome	Tipo	Exigencia	Descricao
from	date	Opcional	Data inicial do intervalo.
to	date	Opcional	Data final do intervalo.
limit	integer	Opcional	Quantidade maxima de observacoes.

Resposta

Sucesso HTTP: 200

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

{
  "provider": "bcb",
  "code": "433",
  "observations": []
}

Erros

Status	Descricao
400	Parametros ou corpo da requisicao invalidos.
404	Recurso solicitado nao encontrado.
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 observacoes macroeconomicas

// 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/macro/series/bcb/433/observations?from=2026-01-01&to=2026-07-01", { 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/macro/series/bcb/433/observations?from=2026-01-01&to=2026-07-01", headers={"X-API-Key": os.environ["CRIVO_API_KEY"]}, timeout=30, ) response.raise_for_status() print(response.json())