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

# Listar séries macroeconômicas disponíveis

`GET /api/v2/macro/available`

Lista as séries macroeconômicas disponíveis com slug, nome, unidade, frequência,
categoria e data de início do histórico. Endpoint público (use para descobrir
slugs antes de chamar `/api/v2/macro` ou `/api/v2/macro/latest`).

### Filtros opcionais

- `q` — busca textual em slug, alias, nome e descrição (case-insensitive).
  Quando presente, os resultados vêm ordenados por relevância.
- `category` — filtra por categoria (ex: `interestRate`, `inflation`).

Os filtros podem ser combinados.

## Query parameters

- `q` string — Filtro textual aplicado a slug, alias, nome e descrição (case-insensitive, substring). Quando informado, os resultados vêm ordenados por relevância.
- `category` string — Filtrar por categoria (ex: `interestRate`, `inflation`).

## Response `200`

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

- MacroAvailableResponse
  - `results` MacroSeriesPublic[], required — Lista de séries macroeconômicas. Quando `q` é informado, vem ordenada por relevância (slug > alias > nome > descrição).
    - `slug` string, required
    - `name` string, required
    - `description` string, required
    - `unit` string, required
    - `frequency` string, required
    - `category` string, required
    - `startDate` string, required
  - `categories` string[], required — Todas as categorias do catálogo. Não é afetado pelos filtros — sempre lista o universo completo de categorias para que o cliente possa montar facetas.
  - `count` integer, required — Quantidade de séries em `results` após aplicar os filtros.
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

---

[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)