B3 (Brasil Bolsa Balcão) · Authentication Profile

B3 Exchange Authentication

Authentication

B3 (Brasil Bolsa Balcão) secures its APIs with oauth2 across 3 declared security schemes, as derived from its OpenAPI definitions. OAuth 2.0 is offered via the clientCredentials and password flow(s).

FinancialMarket DataStocksTradingExchangeDerivativesFixed IncomeReal-TimeReference DataBrazil

Methods: oauth2 Schemes: 3 OAuth flows: clientCredentials, password API key in:

Security Schemes

OAuth2ClientCredentials oauth2

OAuth2ROPC oauth2

OAuth2ResourceAccess oauth2

Source

Authentication Profile

generated: '2026-07-22'
method: searched
source: openapi/ (12 of 14 harvested Swagger 1.1 definitions declare oauth2 authorizations)
docs: https://developers.b3.com.br/apis/autenticacao
summary:
  types: [oauth2]
  oauth2_flows: [clientCredentials, password]
  token_location: header
  header_prefix: Bearer
  scopes_matching: Any
  notes: >-
    All B3 for Developers REST APIs authenticate with OAuth 2.0 bearer tokens.
    The portal documents six token-issuance model APIs - Client Credentials
    (plain, plus category_ID, key, and scope parameter variants) and Resource
    Owner Password Credentials (plain and category_ID variants). Access is
    B2B-only: client_id/client_secret credentials are issued to contracted
    institutions, not self-serve. The Swagger definitions carry a placeholder
    token endpoint (https://localhost:8089/api/oauth/token) that the portal
    substitutes with the client's entitled gateway host at runtime.
schemes:
  - name: OAuth2ClientCredentials
    type: oauth2
    flow: clientCredentials
    token_endpoint_path: /aapi/oauth/token
    token_request:
      method: POST
      content_type: application/x-www-form-urlencoded
      parameters: [client_id, client_secret, grant_type]
    docs: https://developers.b3.com.br/apis/autenticacao
    sources:
      - openapi/b3-exchange-auth-client-credentials-openapi.json
  - name: OAuth2ROPC
    type: oauth2
    flow: password
    token_endpoint_path: /api/oauth/token
    token_request:
      method: POST
      content_type: application/x-www-form-urlencoded
      parameters: [client_id, client_secret, grant_type, username, password]
    docs: https://developers.b3.com.br/apis/autenticacao
    sources:
      - openapi/b3-exchange-auth-ropc-openapi.json
  - name: OAuth2ResourceAccess
    type: oauth2
    description: >-
      Per-API OAuth 2.0 security profile applied across the catalog - bearer
      access token in the Authorization header, scopes resource.READ and
      resource.WRITE, any-scope matching.
    token_location: header
    header_prefix: Bearer
    scopes: [resource.READ, resource.WRITE]
    sources:
      - openapi/b3-exchange-investor-position-openapi.json
      - openapi/b3-exchange-investor-transactions-openapi.json
      - openapi/b3-exchange-isin-openapi.json
      - openapi/b3-exchange-otc-public-info-openapi.json
      - openapi/b3-exchange-tesouro-direto-bonds-openapi.json
      - openapi/b3-exchange-tesouro-direto-positions-openapi.json
      - openapi/b3-exchange-tesouro-direto-orders-openapi.json
      - openapi/b3-exchange-banco-b3-custody-openapi.json
      - openapi/b3-exchange-banco-b3-settlement-openapi.json
      - openapi/b3-exchange-core-calculation-openapi.json
      - openapi/b3-exchange-securities-lending-openapi.json
      - openapi/b3-exchange-insurance-claim-openapi.json

Work with this as data

Every security artifact here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for security posture

4 MCP tools reach this

find_securityBrowse and filter every security artifact in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This security artifact

curl "https://apis.io/api/v1/security/b3-exchange-authentication"

All security posture

curl "https://apis.io/api/v1/security?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.