Open Source FIX Protocol library implemented in Go
To install QuickFIX/Go, use
$ go get github.com/quickfixgo/quickfix
To update QuickFIX/Go to the latest version, use
go get -u github.com/quickfixgo/quickfix.
See examples for some simple examples of using QuickFIX/Go.
QuickFIX/Go includes separate packages for tags, fields, enums, messages, and message components generated from the FIX 4.0 - FIX5.0SP2 specs. See:
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
generate-fix tool included with QuickFIX/Go.
generate-fix is installed to
$GOPATH/bin/generate-fix --help for usage instructions.
If you wish to work on QuickFIX/Go itself, you will first need Go installed and configured on your machine (version 1.13+ is preferred, but the minimum required version is 1.6).
As of Go version 1.13, QuickFIX/Go uses modules to manage dependencies. You may require
GO111MODULE=on. To install dependencies, run
go mod download
Note: No vendored dependencies are included in the QuickFIX/Go source.
The default make target runs go vet and unit tests.
If this exits with exit status 0, then everything is working!
Generated code from the FIX40-FIX50SP2 specs are available as separate repos under the QuickFIX/Go organization. The source specifications for this generated code is located in
spec/. Generated code can be identified by the
.generated.go suffix. Any changes to generated code must be captured by changes to source in
cmd/generate-fix. After making changes to the code generator source, run the following to re-generate the source
$ make generate-dist
If you are making changes to the generated code, please create Pull Requests for these changes for the affected repos.
QuickFIX/Go has a comprehensive acceptance test suite covering the FIX protocol. These are the same tests used across all QuickFIX implementations.
QuickFIX/Go acceptance tests depend on ruby in path.
To run acceptance tests,
# generate code locally make generate # build acceptance test rig make build_accept # run acceptance tests make accept
If you are developing QuickFIX/Go, there are a few tasks you might need to perform related to dependencies.
If you are adding or updating a dependency, you will need to update the
go.sum in the same Pull Request as the code that depends on it. You should do this in a separate commit from your code, as this makes PR review easier and Git history simpler to read in the future.
go get -u github.com/foo/bar
go mod tidy
Note that to specify a specific revision, you can manually edit the
go.mod file and run
go mod tidy
This software is available under the QuickFIX Software License. Please see the LICENSE.txt for the terms specified by the QuickFIX Software License.