Binance

Binance spot, for crypto. The OMS routes orders to Binance and marks crypto positions from Binance’s public order book.

Note

This page covers setup only. A full walkthrough, verified end to end on the Binance testnet, is still to come.

What it covers

Order entry	REST (default) or FIX
Executions	The user-data stream (REST) or FIX execution reports
Instruments	Spot pairs
Catalog	Broker connections → Instrument universe in the cockpit
Prices	Binance’s public spot book; Bybit’s as backup

Credentials

Binance uses an Ed25519 API key: you generate a key pair, register the public key with Binance, and give the OMS the API key and the private key. For PAPER, register at the spot testnet; for LIVE, under API management.

Create a broker connection with Binance as the venue; its credentials drawer opens with these fields:

Field	What it is	PAPER / LIVE value
API key	Shown after you register your public key. For FIX it needs the FIX_API permission	yours
Private key (PEM)	The contents of your Ed25519 private key file, starting -----BEGIN PRIVATE KEY-----. Not a path; Binance never sees it	yours

Under FIX session, used only when the transport is FIX (REST is the default) and filled in for you:

Field	What it is	PAPER / LIVE value
Host	Binance’s FIX order-entry host	fix-oe.testnet.binance.vision / fix-oe.binance.com
Port	Its port	9000
SenderCompID	Any ID you choose: 1-8 letters, digits, - or _, different for each session open at the same time	OMS
TargetCompID	Always SPOT for Binance spot	SPOT

Then reload:

export OMS_ADMIN=$(sed -n 's/^admin_password = "\(.*\)"/\1/p' ~/.config/oms/oms.toml)

curl -s -X POST localhost:3001/admin/connections/reload -H "Authorization: Bearer $OMS_ADMIN"

A FIX session cannot be swapped while running: for a FIX connection the reload reports that a restart is required, and the new credentials apply at the next start.

Paper or live, REST or FIX

Variable	Values	Default
BINANCE_ENV	PAPER (testnet) or LIVE	PAPER
BINANCE_PAPER_TRANSPORT / BINANCE_LIVE_TRANSPORT	rest or fix	rest

Loading instruments

Saving the credentials offers to load Binance’s spot pairs as a background job; the Instrument universe column on Broker connections shows its state and has Load / Reload. From a terminal: oms setup sync-broker --broker binance --no-enrich.