Adding a B3 connection

To add a B3 connection:

  1. Click Connections in the left navigation panel.
  2. Click +New Connection
  3. Configure the settings in the General Settings section:

    • Connection enabled: Check this setting to activate the connection. Uncheck to deactivate the connection.
    • Name: This is a required field for creating a connection.
    • Exchange: Select B3. Only one exchange is allowed per connection.
    • In the Type field, select either BM&F Derivatives or BOVESPA Equities. This field sets the connection to route orders for either derivatives products or equities products on B3.
  4. Configure the settings in the Additional Settings section.

  5. Configure the following B3 settings per connection:

    • Primary IP — Sets the exchange-provided IP address for connecting to the exchange. This is required.
    • Primary Port — Sets the exchange-provided port for connecting to the exchange. This is required.
    • Password — The session password provided by the exchange.
    • Target Comp ID — The ID of the firm receiving messages from the exchange host. This ID is generated and provided by the exchange based on your firm name. This field populates the value of Tag 56 (TargetCompID) in all inbound messages on this connection.
    • Sender Comp ID — Identifies the name of the firm that sends messages to the exchange. Enter the exchange-provided ID. This field populates the value of Tag 49 (SenderCompID) in all outbound messages for the connection.
    • Sender Location — Identifies the order originator. Enter "BVMF" for Desk Traders, or the 3-character code provided by the exchange for DMA traders. Sent to the exchange API as PartyRole Tag 452=54.
    • Entering Firm — Sets the broker identifier for the Desk Trader's firm. Enter the numeric code provided by the Exchange. Sent to the exchange API as PartyRole Tag 452=7.
    • Cancel Orders on Disconnect — Sets whether to enable use of the exchange's Cancel on Disconnect functionality. When this setting is checked, all orders except GTC and GTDate orders are canceled when the session disconnects. By default, this setting is unchecked and all orders are persisted at the exchange when the session disconnects. Sent to the exchange API as Tag 35002.
  6. Click Create.

    You can select the connection in the data grid and review the connection settings in the Settings tab.

  7. Click the Accounts tab to assign an existing account to the connection. Multiple accounts can be added to a single connection.

    Note: The connection will not become active until at least one account is assigned.

  8. Click Save Changes.