BANCOS

Lista de bancos

ISPB, código e nome de todo participante do STR (Sistema de Transferência de Reservas), direto do Banco Central.

Bank list

ISPB, code and name for every STR (Reserves Transfer System) participant, straight from the Central Bank.

SYNC resposta na mesma chamada answers in the same call

Endpoints

GET /api/v1/bancos lista todos os participantes do STR lists every STR participant

GET /api/v1/bancos/{codigo} busca um banco pelo código numérico looks up a bank by its numeric code

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`codigo`	path	código numérico do banco, sem zeros à esquerda (ex.: `1` pro Banco do Brasil)	the bank's numeric code, no leading zeros (e.g. `1` for Banco do Brasil)

Exemplo

Example

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

{
          "success": true,
          "data": {
            "ispb": "00000000",
            "codigo": "1",
            "nome": "BCO DO BRASIL S.A.",
            "nome_extenso": "Banco do Brasil S.A.",
            "participa_compe": true,
            "inicio_operacao": "22/04/2002"
          },
          "meta": { "elapsed_ms": 0, "request_id": "..." }
        }

Erros possíveis

Possible errors

Status	Motivo	Reason
400	código não é numérico	code isn't numeric
401	token ausente ou inválido	missing or invalid token
404	código não encontrado — algumas contas internas do Banco Central não têm código, só ISPB	code not found — some Central Bank internal accounts have no code, only an ISPB
429	limite de taxa excedido	rate limit exceeded

Fonte oficial, sem fallback

Official source, no fallback

Lista oficial de participantes do STR publicada pelo Banco Central no portal de dados abertos, CSV público, sem chave. ~480 registros, servidos de um SQLite local. Sem fallback: a fonte já é a oficial do Banco Central, não faz sentido espelhar um espelho.

Official STR participants list published by the Central Bank's open data portal, public CSV, no key. ~480 records, served from a local SQLite. No fallback: the source is already the Central Bank's own, mirroring a mirror doesn't buy anything.

Usando o SDK

Using the SDK

SDKs oficiais: Go · Python · JavaScript.

Official SDKs: Go · Python · JavaScript.

Buscar um banco

Look up a bank

import (
	"context"
	"fmt"

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

client := alicercelabs.New("alk_...") // ou um token JWT de login/register
ctx := context.Background()

banco, err := client.Bancos.Get(ctx, "1")
if err != nil {
	panic(err)
}
fmt.Println(banco.Nome, banco.ISPB)

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")  # ou um token JWT de login/register

banco = client.bancos.get("1")
print(banco["nome"], banco["ispb"])

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_..."); // ou um token JWT de login/register

const banco = await client.bancos.get("1");
console.log(banco.nome, banco.ispb);

Limites

Limits

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

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