Macroeconomia
Séries históricas de indicadores macroeconômicos
Retorna observações históricas para uma ou mais séries macroeconômicas brasileiras (taxas de juros, inflação, agregados monetários e atividade).
get/api/v2/macro
Query parameters
symbolsstring required
Slugs separados por vírgula (máx. 20). Slugs disponíveis — interestRate: selic, selicovernight, cdi, tr; inflation: ipca, ipca12m, inpc, igpm, igpdi; activity: ibcbr, pibmensal; labor: desemprego; monetary: m1, m4; external: reservas. Veja /api/v2/macro/available para metadados completos (unidade, frequência, descrição) e busca por texto.
Example:selic,ipca
startDatestring
Data inicial (YYYY-MM-DD). Padrão: 12 meses atrás.
Example:2025-01-01
endDatestring
Data final (YYYY-MM-DD). Padrão: hoje.
Example:2026-04-30
sortOrder'asc' | 'desc'
Ordenação por data.
Example:desc
limitinteger
Máximo de observações por série (padrão 20). Sem teto — passe limit=10000 para histórico completo.
Example:20
Response
Observações retornadas com sucesso.
Example response
{
"results": [
{
"series": {
"slug": "selic",
"name": "Taxa Selic",
"description": "Taxa básica de juros da economia brasileira, definida pelo COPOM (Comitê de Política Monetária) do Banco Central. É a referência para todas as demais taxas de juros do país.",
"unit": "percentPerYear",
"frequency": "daily",
"category": "interestRate",
"startDate": "1999-03-05"
},
"observations": [
{
"date": "2026-04-30",
"value": 14.5
},
{
"date": "2026-04-29",
"value": 14.75
},
{
"date": "2026-04-28",
"value": 14.75
},
{
"date": "2026-04-25",
"value": 14.75
}
]
},
{
"series": {
"slug": "ipca12m",
"name": "IPCA acumulado 12 meses",
"description": "Variação acumulada em 12 meses do Índice Nacional de Preços ao Consumidor Amplo (IBGE). Indicador oficial de inflação do Brasil.",
"unit": "percent",
"frequency": "monthly",
"category": "inflation",
"startDate": "1981-01-01"
},
"observations": [
{
"date": "2026-03-01",
"value": 4.14
},
{
"date": "2026-02-01",
"value": 3.81
},
{
"date": "2026-01-01",
"value": 4.44
}
]
}
],
"requestedAt": "2026-04-30T12:00:00.000Z",
"took": 23
}