fixtojson

README

FIXtoJSON

FIXtoJSON is a Go library that converts Financial Information eXchange (FIX) protocol messages to JSON format. This library is designed to simplify the process of working with FIX messages by providing an easy-to-use JSON representation.

Features

• Converts raw FIX messages to structured JSON
• Handles repeating groups in FIX messages
• Supports nested JSON within FIX fields
• Uses FIX data dictionary for accurate field interpretation
• Handles unknown fields gracefully

Why FIXtoJSON?

FIX protocol messages are widely used in financial trading systems but can be difficult to read and process due to their tag-value pair format. FIXtoJSON addresses this challenge by:

1. Improving Readability: Converting FIX messages to JSON makes them human-readable and easier to understand.

2. Simplifying Integration: JSON is a universally supported data format, making it easier to integrate FIX data with various systems and programming languages.

3. Enhancing Debugging: The JSON format makes it easier to inspect and debug FIX messages during development and troubleshooting.

4. Supporting Complex Structures: FIXtoJSON handles repeating groups and nested structures in FIX messages, preserving the hierarchical nature of the data.

5. Facilitating Data Analysis: JSON format allows for easier parsing and analysis of FIX message data using standard JSON tools and libraries.

Installation

To install FIXtoJSON, use go get -u github.com/goemon-xyz/fixtojson@latest

Contributing

Contributions to FIXtoJSON are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Documentation

Index

• type Converter
  • func NewConverter(dictionaryPath string) (*Converter, error)
  • func (c *Converter) FIXToJSON(raw []byte) ([]byte, error)
  • func (c *Converter) FieldMapToJSON(fm quickfix.FieldMap, fieldDefs FieldDefs) map[string]interface{}
• type FieldDefs
  • func NewFieldDefs(Parts []datadictionary.MessagePart, MapFields map[int]*datadictionary.FieldDef) FieldDefs
  • func NewFieldDefsFromArr(MapFields []*datadictionary.FieldDef) FieldDefs
  • func (t FieldDefs) Find(tag quickfix.Tag) *datadictionary.FieldDef

Types

type Converter

type Converter struct {
	// contains filtered or unexported fields
}

func NewConverter

func NewConverter(dictionaryPath string) (*Converter, error)

func (*Converter) FIXToJSON

func (c *Converter) FIXToJSON(raw []byte) ([]byte, error)

func (*Converter) FieldMapToJSON

func (c *Converter) FieldMapToJSON(fm quickfix.FieldMap, fieldDefs FieldDefs) map[string]interface{}

type FieldDefs

type FieldDefs []*datadictionary.FieldDef

func NewFieldDefs

func NewFieldDefs(Parts []datadictionary.MessagePart, MapFields map[int]*datadictionary.FieldDef) FieldDefs

func NewFieldDefsFromArr

func NewFieldDefsFromArr(MapFields []*datadictionary.FieldDef) FieldDefs

func (FieldDefs) Find

func (t FieldDefs) Find(tag quickfix.Tag) *datadictionary.FieldDef