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

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_...")
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_...")

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

import { AlicerceLabs } from "alicercesdk-javascript";

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

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