# Séries Macroeconômicas Disponíveis
URL: /docs/macro/available.mdx

Lista das séries macroeconômicas disponíveis com slugs, aliases, unidade, frequência e descrição. Aceita busca textual via `q` e filtro por categoria.

***

title: Séries Macroeconômicas Disponíveis
description: >-
Lista das séries macroeconômicas disponíveis com slugs, aliases, unidade,
frequência e descrição. Aceita busca textual via `q` e filtro por categoria.
full: true
keywords: brapi, api, macroeconomia, indicadores, disponíveis, slugs, busca
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/macro/available
------------------------------

Endpoint **público**. Retorna metadados das séries disponíveis (slug, nome,
unidade, frequência, categoria). Use os slugs em
[`/api/v2/macro`](/docs/macro) e
[`/api/v2/macro/latest`](/docs/macro/latest).

### Filtros opcionais

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

Os filtros podem ser combinados.





## Swagger Documentation

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

Single endpoint documentation for /api/v2/macro/available

## Base URLs

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

## GET /api/v2/macro/available

**Summary:** Listar séries macroeconômicas disponíveis


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.


**Tags:** Macroeconomia

### Parameters

- **q** (query)
- **category** (query)

### Responses

#### 200

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

## Schemas

The following schemas are used by this endpoint:

### MacroAvailableResponse

**Properties:**

- **results** (array) *(required)*
  Lista de séries macroeconômicas. Quando `q` é informado, vem ordenada por relevância (slug > alias > nome > descrição).
  Array items:
    Reference to: **MacroSeriesPublic**

- **categories** (array) *(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.
  Array items:
    **Type:** string


- **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


### MacroSeriesPublic

**Properties:**

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

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

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

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

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

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

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