BRbrapi-dev
Macroeconomia

Séries macroeconômicas

Changed on

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.

Veja os códigos em listar séries. Planos Startup e Pro.

get/api/v2/macro

Request

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

Query parameters

symbolsstring 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.

Example:selic,ipca
startDatestring

Data inicial no formato YYYY-MM-DD. Padrão: 12 meses atrás.

Example:2025-01-01
endDatestring

Data final no formato YYYY-MM-DD. Padrão: hoje.

Example:2026-04-30
sortOrder'asc' | 'desc'

Ordem por data.

Example:desc
limitinteger

Máximo de observações por série. Padrão: 20. Não há teto.

Example:20

Response

Observações retornadas com sucesso.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

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. 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
}

Changes