fixer

Open Source FIX Protocol library implemented in Rust.

Note: This project is still under heavy development.

About

fixer is a FIX Protocol Community implementation for the Rust programming language.

100% free and open source
Supports FIX versions 4.0 - 5.0SP2
Spec driven run-time message validation
Spec driven code generation of type-safe FIX messages, fields, and repeating groups
Support for protocol customizations
Session state storage options: SQL, MongoDB, On-disk, or In-memory
Logging options: File, Screen
Failover and High Availability
Daily and weekly scheduling of session connections
Integrated support for TLS communications
Automated unit and acceptance tests

Installation

Add the following to your Cargo.toml:

[dependencies]
fixer = { git = "https://github.com/fixer-rs/fixer" }

FIX Messaging Model

To send and receive FIX messages, your application will use the generated type-safe message packages.

fixer includes a code generator (fixer-gen) that produces Rust modules from the FIX 4.0 - FIX 5.0SP2 XML specifications. The generated code lives in the fixer-fix crate and provides:

tag — Tag constants
field — Typed field wrapper structs
enums — Field enumeration values
fix40 through fix50sp2 — Per-version message types with constructors, setters, and getters
fixt11 — FIXT 1.1 session-level messages

For most FIX applications, these generated resources are sufficient. Custom FIX applications may generate source specific to the FIX spec of that application using the fixer-gen tool.

Code Generation

To regenerate the FIX message types from the XML specifications:

make generate

To generate with f64 instead of Decimal for numeric fields:

make generate-float

Examples

The examples/ directory contains working applications that demonstrate how to use fixer:

Echo Server — A FIX Acceptor that echoes incoming messages back to the sender
Trade Client — A FIX Initiator that sends a NewOrderSingle after logon and prints execution reports

Run both together to see a complete FIX session:

# Terminal 1: start the echo server
cargo run --example echo_server -- examples/echo_server/echo_server.cfg

# Terminal 2: start the trade client
cargo run -p fixer-fix --example trade_client -- examples/trade_client/trade_client.cfg

See examples/README.md for more details.

Build and Test

# run lints and tests
make clippy
make test

# format code
make fmt

General Support

FIX Protocol

More information about the FIX protocol can be found at the FIX Trading Community website.

Bugs and Issues

Bugs and issues can be submitted through the GitHub repository issues list.

Please provide sample code, logs, and a description of the problem when submitting an issue.

Contributing

Contributions are welcome. Please open an issue or pull request on GitHub.

Collaboration

I'm Karuna Murti, the author of fixer. I'm interested in working together with people who want to build a company or implement this in their company. If you're interested, feel free to reach out at karuna.murti@gmail.com.

Licensing

This software is available under the QuickFIX Software License. Please see the LICENSE.txt for the terms specified by the QuickFIX Software License.

fixer-fix 0.10.3