FIX Antenna Rust - Getting Started

This guide helps you install and run the FIX Antenna Rust API package, generate local docs, and launch the included examples.

Alpha note: This is an early release. Expect changes between versions.

You need a Rust toolchain to build the crate and run examples.

Ubuntu:

sudo apt install rustup
rustup default stable

(If you’re on Windows/macOS, install Rust via rustup and select stable.)

Place a valid FIX Antenna license file named:

into the package root directory (the top-level folder you extracted).

The simplest way to verify everything works is to run the included EchoServer (a FIX acceptor).

cargo run --release --example echoserver

Optional: run with an explicit properties file:

cargo run --release --example echoserver -- /path/to/engine_echoserver.properties

The server starts listening (default: port 9105 in the example configuration)
You’ll see an interactive menu like:

Choose command:
1 - show EchoServer's statistics
2 - close all active sessions
3 - stop EchoServer

Logs are created automatically under:

A minimal EchoServer variant intended for performance testing:

cargo run --release --example echoserver_benchmark

With a custom properties file:

cargo run --release --example echoserver_benchmark -- /path/to/engine_benchmark.properties

If you prefer generating docs locally from the source:

cargo doc --release --no-deps --open

Docs location:

If you want to validate your setup via unit tests:

cargo test --release -- --test-threads=1

(Tests run single-threaded because some share a session to reduce startup/licensing overhead.)

When you build or run examples with --release, Cargo will produce artifacts under:

You typically don’t need to interact with these directly—cargo run and cargo test handle it.

To build your own FIX application, you’ll implement the FixApplication trait (message processing + session events), and register it for a session.

A complete working pattern is in:

FIX Antenna Rust Programmer's Guide