TAXAS

Taxas e índices oficiais

Selic, CDI, IPCA e IGP-M, valor mais recente ou série histórica, direto do Banco Central.

Official rates and indices

Selic, CDI, IPCA and IGP-M, latest value or historical series, straight from the Central Bank.

SYNC resposta na mesma chamada answers in the same call

Endpoints

GET /api/v1/taxas valor mais recente de todos os indicadores conhecidos latest value of every known indicator

GET /api/v1/taxas/{nome} valor mais recente de um indicador an indicator's latest value

GET /api/v1/taxas/{nome}/serie série histórica num intervalo historical series over a date range

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`nome`	path	um de `selic`, `cdi`, `ipca`, `igpm`	one of `selic`, `cdi`, `ipca`, `igpm`
`inicio`, `fim`	query	`/serie`: obrigatórios, formato `YYYY-MM-DD`	`/serie`: required, `YYYY-MM-DD` format

Exemplo

Example

curl https://api.alicercelabs.com.br/api/v1/taxas/selic \
          -H "Authorization: Bearer <token>"

{
          "success": true,
          "data": { "nome": "selic", "valor": 14.25, "data": "2026-08-26" },
          "meta": { "elapsed_ms": 0, "request_id": "..." }
        }

Erros possíveis

Possible errors

Status	Motivo	Reason
400	`/serie`: `inicio`/`fim` ausentes, mal formatados, ou `fim` anterior a `inicio`	`/serie`: `inicio`/`fim` missing, malformed, or `fim` before `inicio`
401	token ausente ou inválido	missing or invalid token
404	`nome` não é um dos indicadores conhecidos	`nome` isn't one of the known indicators
429	limite de taxa excedido	rate limit exceeded

Usando o SDK

Using the SDK

SDKs oficiais: Go · Python · JavaScript.

Official SDKs: Go · Python · JavaScript.

Valor mais recente

Latest value

import (
	"context"
	"fmt"

	alicercelabs "github.com/alicercelabs/alicercesdk-go"
)

client := alicercelabs.New("alk_...")
ctx := context.Background()

taxa, err := client.Taxas.Get(ctx, "selic")
if err != nil {
	panic(err)
}
fmt.Println(taxa.Valor)

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")

taxa = client.taxas.get("selic")
print(taxa["valor"])

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_...");

const taxa = await client.taxas.get("selic");
console.log(taxa.valor);

Série histórica

Historical series

serie, err := client.Taxas.Serie(ctx, "igpm", "2026-01-01", "2026-06-01")
fmt.Println(len(serie), "pontos")

serie = client.taxas.serie("igpm", "2026-01-01", "2026-06-01")
print(len(serie), "pontos")

const serie = await client.taxas.serie("igpm", "2026-01-01", "2026-06-01");
console.log(serie.length, "pontos");

Limites

Limits

100/dia · 4/hora sem token, por IP chamador; com uma API key (gerada no painel), 1.000/dia · 41/hora.

100/day · 4/hour without a token, per calling IP; with an API key (generated in the panel), 1,000/day · 41/hour.