---
title: "Séries históricas de indicadores macroeconômicos"
method: GET
path: "/api/v2/macro"
tags: ["Macroeconomia"]
---

# Séries históricas de indicadores macroeconômicos

`GET /api/v2/macro`

Retorna observações históricas para uma ou mais séries macroeconômicas
brasileiras (taxas de juros, inflação, agregados monetários e atividade).

## Query parameters

- `symbols` string, 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.
- `startDate` string — Data inicial (YYYY-MM-DD). Padrão: 12 meses atrás.
- `endDate` string — Data final (YYYY-MM-DD). Padrão: hoje.
- `sortOrder` 'asc' | 'desc' — Ordenação por data.
- `limit` integer — Máximo de observações por série (padrão 20). Sem teto — passe `limit=10000` para histórico completo.

## Response `200`

Observações retornadas com sucesso.

- MacroSeriesDataResponse
  - `results` MacroSeriesResult[], required
    - `series` MacroSeriesPublic, required
      - `slug` string, required
      - `name` string, required
      - `description` string, required
      - `unit` string, required
      - `frequency` string, required
      - `category` string, required
      - `startDate` string, required
    - `observations` MacroSeriesObservation[], required
      - `date` string, required
      - `value` number, required
  - `warnings` MacroSeriesAliasWarning[]
    - `provided` string, required
    - `canonicalSlug` string, required
    - `message` string, required
  - `errors` MacroSeriesError[]
    - `slug` string, required
    - `code` string, required
    - `message` string, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Parâmetros inválidos.
- `401` — Token ausente ou inválido.
- `403` — Plano sem acesso ao módulo de macroeconomia.
- `500` — Erro interno.

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)