# Macroeconomia
URL: /docs/macro.mdx

Endpoint composable para acessar séries temporais de indicadores macroeconômicos do Brasil — Selic, IPCA, IGP-M, agregados monetários, atividade e mercado de trabalho.

***

title: Macroeconomia
description: >-
Endpoint composable para acessar séries temporais de indicadores
macroeconômicos do Brasil — Selic, IPCA, IGP-M, agregados monetários,
atividade e mercado de trabalho.
full: true
keywords: brapi, api, macroeconomia, indicadores econômicos, selic, ipca, igpm
openGraph:
title: Macroeconomia — brapi
description: >-
Séries temporais de indicadores macroeconômicos brasileiros — Selic,
IPCA, IGP-M e outros — em uma única requisição.
type: website
locale: pt\_BR
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/macro
--------------------

Acesse séries temporais de indicadores macroeconômicos brasileiros usando
slugs estáveis. Compatível com **múltiplas séries** em uma única requisição
via parâmetro `symbols` (ex: `symbols=selic,ipca,igpm`).

Use [`/api/v2/macro/available`](/docs/macro/available) para descobrir todos
os slugs disponíveis (com busca textual opcional via `q`).





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/macro

Single endpoint documentation for /api/v2/macro

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/macro

**Summary:** 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).


**Tags:** Macroeconomia

### Parameters

- **symbols** (query) *required*
- **startDate** (query)
- **endDate** (query)
- **sortOrder** (query)
- **limit** (query)

### Responses

#### 200

Observações retornadas com sucesso.

#### 400

Parâmetros inválidos.

#### 401

Token ausente ou inválido.

#### 403

Plano sem acesso ao módulo de macroeconomia.

#### 500

Erro interno.

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### MacroSeriesAliasWarning

**Properties:**

- **provided** (string) *(required)*

- **canonicalSlug** (string) *(required)*

- **message** (string) *(required)*


### MacroSeriesDataResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **MacroSeriesResult**

- **warnings** (array)
  Array items:
    Reference to: **MacroSeriesAliasWarning**

- **errors** (array)
  Array items:
    Reference to: **MacroSeriesError**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### MacroSeriesError

**Properties:**

- **slug** (string) *(required)*

- **code** (string) *(required)*

- **message** (string) *(required)*


### MacroSeriesObservation

**Properties:**

- **date** (string) *(required)*

- **value** (number) *(required)*


### MacroSeriesPublic

**Properties:**

- **slug** (string) *(required)*

- **name** (string) *(required)*

- **description** (string) *(required)*

- **unit** (string) *(required)*

- **frequency** (string) *(required)*

- **category** (string) *(required)*

- **startDate** (string) *(required)*


### MacroSeriesResult

**Properties:**

- **series** *(required)*
  Reference to: **MacroSeriesPublic**

- **observations** (array) *(required)*
  Array items:
    Reference to: **MacroSeriesObservation**