---
title: "Séries macroeconômicas"
method: GET
path: "/api/v2/macro"
tags: ["Macroeconomia"]
---

# Séries macroeconômicas

`GET /api/v2/macro`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/macro`
- Auth: HTTP bearer

Histórico de indicadores macroeconômicos do Brasil, como Selic, CDI, IPCA,
IGP-M, agregados monetários, atividade, emprego e setor externo. Cada série tem
um código, como `selic` ou `ipca`, que a resposta mostra no campo `slug`.

Use para gráficos de juros e inflação, modelos de renda fixa e análise de
cenário.

Peça até 20 séries por chamada em `symbols`, como
`symbols=selic,ipca`. Sem datas, a janela é dos últimos 12 meses. `limit`
corta os pontos de cada série e tem padrão 20. Com o padrão, uma
série diária não cobre os 12 meses. Aumente `limit` para ver a janela toda.

As séries têm frequências diferentes: a Selic e o CDI são diários, o IPCA e o
PIB mensal são mensais. Leia `series.frequency` antes de juntar duas séries.

Um nome alternativo no lugar do código, como `igp-m` para `igpm`, funciona e
gera um aviso em `warnings`. Um código desconhecido gera um item em
`errors` e não derruba as outras séries. Pares de
câmbio ficam no [histórico de câmbio](https://brapi.dev/docs/moedas/historico).

Veja os códigos em [listar séries](https://brapi.dev/docs/macro/available).
Planos Startup e Pro.

## Query parameters

- `symbols` string, required: Códigos das séries separados por vírgula, até 20. Códigos por categoria: interestRate: `selic`, `selicovernight`, `cdi`, `tr`; inflation: `ipca`, `ipca12m`, `inpc`, `igpm`, `igpdi`; activity: `ibcbr`, `pibmensal`; labor: `desemprego`; monetary: `m1`, `m4`; external: `reservas`.
- `startDate` string: Data inicial no formato YYYY-MM-DD. Padrão: 12 meses atrás.
- `endDate` string: Data final no formato YYYY-MM-DD. Padrão: hoje.
- `sortOrder` 'asc' | 'desc': Ordem por data.
- `limit` integer: Máximo de observações por série. Padrão: 20. Não há teto.

## Response `200`

Observações retornadas com sucesso.

- MacroSeriesDataResponse
  - `results` MacroSeriesResult[], required
    - `series` MacroSeriesPublic, required
      - `slug` string, required: Código da série. Use este valor em `symbols`.
      - `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: Nome alternativo enviado em `symbols`.
    - `canonicalSlug` string, required: Código oficial da série. Use este valor em integrações.
    - `message` string, required
  - `errors` MacroSeriesError[]
    - `slug` string, required: Código enviado em `symbols`.
    - `code` string, required
    - `message` string, required
  - `requestedAt` string, date-time, required: Data e hora da requisição em 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.

## Changes

- **2026-05-09** `b12b26efb60e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/macro/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)