Bitvavo FIX Trade Connector

Features

fix-bitvavoConnector Key

Instruments

FX

Request Types

SUBMITCANCELREPLACE

Order Types

MARKETLIMITSTOPSTOP_LIMIT

Time In Force

GTCIOCFOK

Order ID Mapper

UUID

✓

Order Status Request

✗

Cancel On Disconnect

✓

Commission

✓

Post Only

✓

Fast Cancel

✓

Fast Replace

Notes

Connectivity

To connect to FIX server it is required to set up AWS Private Link. See Private link requirements

Operator ID

Bitvavo requires OperatorID(5002) on submit, cancel and replace requests. Configure operatorId or override it per order with attribute 5002.

Symbology

Use Bitvavo market symbols in Symbol(55), for example BTC-EUR. Configure instruments with Ember FX-style currency updates and set the broker symbol to the Bitvavo market when it differs from the Ember symbol.

Schedule

Bitvavo market availability depends on the market status. Markets may be trading, halted, auction, auction matching, or cancel-only.

Configuration

Connector settings

Parameter	Default Value	Description
apiKey		Bitvavo FIX API key used as Username(553) on Logon.
apiSecret		Bitvavo API secret used to generate the HMAC-SHA256 Password(554) on Logon.
account		Optional Account(1). If omitted, Bitvavo uses SenderCompID.
useAccount	false	The flag to define whether to use order account in preference of default account.
selfMatchPreventionInstruction		Optional default SelfMatchPreventionInstruction(2964). Supported values: CANCEL_AGGRESSIVE, CANCEL_PASSIVE, CANCEL_BOTH, DECREMENT_AND_CANCEL, DEFAULT.
triggerPriceType		Optional default TriggerPriceType(1107). Applied only for STOP and STOP_LIMIT orders. Supported values: BEST_OFFER, LAST_TRADE, BEST_BID, BEST_MID, DEFAULT.
operatorId		Operator ID is an integer that you specify to identify the trader or algorithm responsible for each order submitted using your API integration. It enables clearer attribution of trading activity, which is critical for compliance and auditability. Optional, if omitted source id is used.
clientTerm	0	The constant value for MSB (most significant bits) in client order id UUID.

Supported order attributes

Key	Description
1	Account(1). Optional account identifier; if omitted, Bitvavo uses SenderCompID.
18	ExecInst(18). Set to 6 for Post-Only orders.
1107	TriggerPriceType(1107). Supported values: 1 - Best Offer, 2 - Last Trade, 3 - Best Bid, 6 - Best Mid.
2964	SelfMatchPreventionInstruction(2964). Supported values: 1 - cancel aggressive, 2 - cancel passive, 3 - cancel both, 4 - decrement and cancel.
5002	OperatorID(5002). Optional, if omitted source id is used.

Config sample

connectors {
  BITVAVO: ${template.connector.fix.bitvavo} {
    settings: {
      host = "connection.bitvavo.com"
      port = 8001

      senderCompId = "<YOUR_UNIQUE_ACCOUNT_IDENTIFIER>"
      targetCompId = "VAVO"

      apiKey = "<API_KEY>"
      apiSecret = "<API_SECRET>"

      operatorId = <OPERATOR_ID> # numeric
    }
  }
}