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

# Listar séries macroeconômicas

`GET /api/v2/macro/available`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/macro/available`
- Auth: none declared

Lista as séries macroeconômicas com código (campo `slug`), nome, descrição,
unidade, frequência, categoria e data de início do histórico.

Use para achar o código antes de chamar as
[séries macroeconômicas](https://brapi.dev/docs/macro) ou o
[último valor](https://brapi.dev/docs/macro/latest).

`q` e `category` funcionam juntos. Endpoint público, sem token.

## Query parameters

- `q` string: Texto buscado no código, nome alternativo, nome e descrição. Ignora maiúsculas e aceita parte da palavra.
- `category` string: Categoria da série: `interestRate`, `inflation`, `monetary`, `activity`, `labor`, `external`.

## Response `200`

Lista de séries disponíveis retornada com sucesso.

- MacroAvailableResponse
  - `results` MacroSeriesPublic[], required: Séries encontradas. Com `q`, a ordem é por relevância: código, nome alternativo, nome e descrição.
    - `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
  - `categories` string[], required: Todas as categorias. Os filtros não mudam esta lista.
  - `count` integer, required: Número de séries em `results`, depois dos filtros.
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## 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/available/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)