B3 - Câmara de Compensação

API REST Certificado Digital B3 - Brasil, Bolsa, Balcão 1 documentos
Visão Geral

Sistemas da B3 para participantes do mercado de derivativos e membros de compensação, incluindo envio de posições, cálculo de margens e testes de estresse. A B3 opera como contraparte central (CCP) para liquidação de operações.

Acesso e Endpoints
Portal https://www.b3.com.br/pt_br/solucoes/plataformas/
API / Endpoint
https://developers.b3.com.br/ Acessar
Documentação https://www.b3.com.br/pt_br/regulacao/regulamentos-e-manuais/
Tipo de Acesso API REST
Certificado Obrigatório (e-CNPJ A1/A3 ICP-Brasil)
Horário Dias úteis, conforme grade horária da B3
Suporte B3 - participantes@b3.com.br
Órgão B3 - Brasil, Bolsa, Balcão
Como Funciona

A B3 (Brasil, Bolsa, Balcão) é a principal infraestrutura de mercado financeiro do Brasil, operando como bolsa de valores, câmara de compensação e contraparte central (CCP). As instituições financeiras interagem com a B3 por meio de diversos sistemas e canais.

Portal de Desenvolvedores (developers.b3.com.br):

A B3 disponibiliza um portal dedicado a desenvolvedores com documentação completa de suas APIs, ambientes de sandbox para testes e ferramentas de integração. Este portal é o ponto de partida para qualquer instituição que deseje automatizar suas operações com a B3.

iBalcão:

Plataforma eletrônica da B3 para registro e negociação de ativos de balcão — derivativos OTC, títulos de renda fixa, operações compromissadas e outros instrumentos. O iBalcão permite o registro obrigatório de operações conforme determinação do Banco Central e da CVM, além de oferecer ambiente de negociação para diversos produtos.

Sinacor (Sistema Nacional de Compensação e Registro):

Sistema central da B3 para compensação e liquidação de operações realizadas nos mercados de bolsa e balcão. Gerencia o ciclo completo desde o registro da operação até a liquidação financeira, incluindo o controle de posições, margens e garantias.

Metodologia CORE de Margem:

A B3 utiliza a metodologia CORE (Closeout Risk Evaluation) para cálculo de margens. Esta metodologia avalia o risco de encerramento de portfólios em cenários de estresse, considerando correlações entre ativos, volatilidades e liquidez de mercado. O cálculo é feito em nível de portfólio, permitindo a compensação de riscos entre posições.

Clearing (Câmara de Compensação):

A B3 atua como contraparte central (CCP) garantindo a liquidação de todas as operações. Isso significa que, ao invés de as partes assumirem risco de crédito entre si, a B3 interpõe-se como compradora de todo vendedor e vendedora de todo comprador, exigindo garantias proporcionais ao risco.

Passo a Passo

Passo 1 — Credenciamento na B3:

A instituição financeira deve solicitar seu credenciamento como participante da B3, apresentando documentação societária, comprovação de capital mínimo, estrutura operacional e tecnológica. O processo inclui análise cadastral, aprovação pelos comitês da B3 e assinatura de termos de adesão específicos para cada mercado (bolsa, balcão, derivativos).

Passo 2 — Configuração Técnica:

Após o credenciamento, configurar a infraestrutura de conectividade: contratação de circuito na Rede RCB (ou VPN), instalação de certificados digitais, configuração de sessões FIX para negociação e market data, cadastro de credenciais nas APIs REST do portal de desenvolvedores, e realização de testes obrigatórios no ambiente de certificação.

Passo 3 — Registro de Operações:

Registrar todas as operações realizadas nos sistemas da B3. Para operações de bolsa, o registro é automático via Sinacor. Para operações de balcão (derivativos OTC, renda fixa), utilizar o iBalcão para registro dentro dos prazos regulatórios. Cada operação recebe um código de identificação único.

Passo 4 — Gestão de Garantias:

Depositar e gerenciar as garantias exigidas pela B3. Monitorar diariamente a margem requerida (calculada pela metodologia CORE) e garantir que o saldo de garantias depositadas seja sempre suficiente. As garantias podem ser compostas por dinheiro, títulos públicos, ações, CDBs e outros ativos aceitos, cada um com seu respectivo haircut.

Passo 5 — Acompanhamento de Margens:

Monitorar em tempo real as chamadas de margem da B3. Quando a margem requerida exceder as garantias depositadas, a instituição recebe uma chamada de margem e deve depositar garantias adicionais dentro do prazo estipulado (geralmente até as 13h do dia seguinte). O não atendimento pode resultar na liquidação compulsória de posições.

Passo 6 — Liquidação Financeira:

Participar do processo de liquidação financeira coordenado pela B3. A liquidação ocorre em D+2 para ações, D+1 para derivativos (ajuste diário) e D+0 para câmbio. Os valores são liquidados via STR (Sistema de Transferência de Reservas) do Banco Central. Verificar diariamente os relatórios de liquidação e conciliar com os controles internos.

Passo 7 — Relatórios e Compliance:

Acessar e processar os relatórios diários fornecidos pela B3: posições em aberto, margens calculadas, operações registradas, garantias depositadas e eventos corporativos. Utilizar estes dados para conciliação, gestão de risco e atendimento às exigências regulatórias do Banco Central e da CVM.

Requisitos Técnicos

A B3 oferece múltiplos protocolos e canais de integração para atender diferentes necessidades das instituições participantes.

APIs REST (developers.b3.com.br):

  • Portal: https://developers.b3.com.br
  • Protocolo: REST sobre HTTPS (TLS 1.2+)
  • Formato: JSON
  • Autenticação: OAuth 2.0 com client_id e client_secret
  • APIs disponíveis: Cotações, Dados de mercado, Registros de operações, Posições, Garantias
  • Rate limiting: Varia por API (consultar documentação específica)

Protocolo FIX (Financial Information eXchange):

  • Versão: FIX 4.4 e FIX 5.0 SP2
  • Uso: Roteamento de ordens, execução de negócios e market data em tempo real
  • Conexão: Via rede RCB (Rede de Comunicação B3) ou internet com VPN
  • Sessão: Heartbeat a cada 30 segundos, logon com senha e certificado
  • Mensagens: NewOrderSingle (D), ExecutionReport (8), MarketDataRequest (V)

Rede RCB (Rede de Comunicação B3):

  • Rede privada dedicada para conexão com os sistemas da B3
  • Largura de banda: 1 Mbps a 10 Gbps conforme necessidade
  • Latência: < 1ms para colocation, < 5ms para conexão remota
  • Redundância: Circuitos duplos obrigatórios para participantes diretos

Colocation:

  • Possibilidade de instalar servidores no mesmo datacenter da B3
  • Latência ultrabaixa para operações de alta frequência (HFT)
  • Requisitos: Contrato específico, espaço em rack, alimentação elétrica redundante

Certificados e Segurança:

  • Certificado digital ICP-Brasil para assinatura de operações
  • Certificados SSL/TLS para comunicação segura
  • Autenticação multifator para acesso aos portais administrativos
  • Firewall e IPS obrigatórios na infraestrutura do participante

Ambientes:

  • Produção: Acesso mediante credenciamento formal
  • Certificação/Homologação: Testes obrigatórios antes do go-live
  • Sandbox: Ambiente livre para desenvolvimento e testes de API
Leiautes e Especificações

A B3 utiliza estruturas de dados específicas para cada tipo de operação e produto registrado em seus sistemas.

Registro de Derivativos (iBalcão):

```json

{

"tipo_operacao": "SWAP | OPCAO | TERMO | NDF",

"data_registro": "2024-03-15",

"data_vencimento": "2025-03-15",

"participante_comprador": {

"codigo_participante": "001",

"cnpj": "00.000.000/0001-91",

"conta": "12345"

},

"participante_vendedor": {

"codigo_participante": "237",

"cnpj": "60.746.948/0001-12",

"conta": "67890"

},

"ativo_objeto": "DI1 | DOL | IND | IPCA",

"valor_nocional": 10000000.00,

"moeda": "BRL",

"taxa_contratada": 11.50,

"indexador": "CDI | IPCA | SELIC | PRE"

}

```

Estrutura de Margem (CORE):

```json

{

"data_calculo": "2024-03-15",

"codigo_participante": "001",

"conta_cliente": "12345",

"margem_requerida": 2500000.00,

"componentes": {

"risco_mercado": 2000000.00,

"risco_liquidez": 300000.00,

"risco_fluxo_caixa": 200000.00

},

"cenarios_stress": [

{"cenario": "ALTA_JUROS_3PP", "impacto": 1800000.00},

{"cenario": "QUEDA_BOLSA_15PCT", "impacto": 2200000.00}

]

}

```

Tipos de Garantia Aceitos:

  • Títulos Públicos Federais (LTN, NTN-B, NTN-F, LFT) — haircut de 2% a 8%
  • Ações do Ibovespa — haircut de 20% a 40%
  • CDBs de bancos de primeira linha — haircut de 5% a 15%
  • Dinheiro (BRL) — sem haircut
  • Cartas de fiança bancária — sem haircut
  • Ouro — haircut de 5% a 10%

Teste de Estresse:

A B3 aplica diariamente cenários de estresse que simulam movimentos extremos de mercado (alta/queda de juros, câmbio, bolsa). A margem requerida é o maior valor entre o cenário base e os cenários de estresse.

Glossário do Sistema

iBalcão: Plataforma eletrônica da B3 para registro, negociação e liquidação de operações do mercado de balcão organizado. Abrange derivativos OTC, títulos de renda fixa, operações compromissadas e outros instrumentos financeiros que não são negociados no livro de ofertas da bolsa.

Sinacor (Sistema Nacional de Compensação e Registro): Sistema central da B3 que gerencia todo o ciclo de pós-negociação — compensação, liquidação e custódia de ativos. Controla posições, calcula obrigações financeiras e coordena a entrega de ativos e pagamentos entre participantes.

CORE (Closeout Risk Evaluation): Metodologia proprietária da B3 para cálculo de margens de garantia. Avalia o custo de encerramento de portfólios em cenários adversos, considerando a interdependência entre diferentes classes de ativos e a liquidez de cada mercado.

Margem Inicial: Valor de garantia que o participante deve depositar na B3 antes de operar. Calculada pela metodologia CORE com base no risco do portfólio. Atualizada diariamente conforme as condições de mercado e as posições do participante.

Ajuste Diário: Mecanismo de liquidação diária de lucros e perdas em contratos futuros. Ao final de cada pregão, a B3 calcula a diferença entre o preço de ajuste do dia e o do dia anterior, creditando ou debitando os participantes conforme suas posições.

Haircut: Percentual de desconto aplicado sobre o valor de mercado de um ativo aceito como garantia. Reflete o risco de desvalorização do ativo durante eventual processo de execução da garantia. Ativos mais líquidos e menos voláteis têm haircuts menores.

Netting (Compensação): Processo de compensação de obrigações opostas entre participantes, resultando em um valor líquido a pagar ou receber. Reduz significativamente o volume financeiro movimentado na liquidação.

MtM (Mark-to-Market): Marcação a mercado — processo de atualização do valor de posições e garantias com base nos preços correntes de mercado. Realizado diariamente pela B3.

FIX Protocol: Protocolo de comunicação padronizado internacionalmente para troca de informações financeiras em tempo real. Utilizado para roteamento de ordens, execução de negócios e disseminação de dados de mercado.

Documentos Enviados por este Canal 1