v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Macroeconomia

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.

get/api/v2/macro/available

Query parameters

qstring

Filtro textual aplicado a slug, alias, nome e descrição (case-insensitive, substring). Quando informado, os resultados vêm ordenados por relevância.

Example:juros

categorystring

Filtrar por categoria (ex: interestRate, inflation).

Example:interestRate

Response

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

categoriesstring[] 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.

countinteger required

Quantidade de séries em results após aplicar os filtros.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "results": [
    {
      "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"
    },
    {
      "slug": "ipca12m",
      "name": "IPCA acumulado 12 meses",
      "description": "Variação acumulada em 12 meses do Índice Nacional de Preços ao Consumidor Amplo (IBGE). Indicador oficial de inflação do Brasil.",
      "unit": "percent",
      "frequency": "monthly",
      "category": "inflation",
      "startDate": "1981-01-01"
    },
    {
      "slug": "cdi",
      "name": "CDI",
      "description": "Certificado de Depósito Interbancário — taxa de juros das operações entre bancos. Principal benchmark de renda fixa no Brasil.",
      "unit": "percentPerDay",
      "frequency": "daily",
      "category": "interestRate",
      "startDate": "1986-03-06"
    }
  ],
  "categories": [
    "interestRate",
    "inflation",
    "monetary",
    "activity",
    "labor",
    "external"
  ],
  "count": 15,
  "requestedAt": "2026-04-30T12:00:00.000Z",
  "took": 4
}