fixcli is FIX (Financial Information Exchange) Command-Line Client.
It supports Logon, Resend Request, and Logout message types. The purpose of the client is to test basix FIX connectibity by logging into a FIX session, creating a new order, receiving execution report, if any, requesting retransmission of previously received message, and logging out of the session.
usage: fixcli [-h] --host HOST [-p PORT] -s SENDER_COMP_ID -t TARGET_COMP_ID
[-e EXCHANGE] [-n SEQNUM] [-u USERNAME] [-m MODE] [-l LEVEL]
fixcli - FIX client application with limited functionality
optional arguments:
-h, --help show this help message and exit
-l LEVEL, --log-level LEVEL
Log level (default: 0, max: 2)
arguments:
--host HOST FIX API Endpoint IP address
-p PORT, --port PORT FIX API Endpoint port number
-s SENDER_COMP_ID, --sender SENDER_COMP_ID
Sending firm
-t TARGET_COMP_ID, --target TARGET_COMP_ID
Receiving firm
-e EXCHANGE, --exchange EXCHANGE
Trading Venue/Exchange
-n SEQNUM, --seqnum SEQNUM
Starting Sequence Number
-u USERNAME, --username USERNAME
Username
-m MODE, --mode MODE Mode of operation (default: dormant)
github: https://github.com/greenpau/fixcli
fixcli --host 10.10.10.10 -p 23456 -s TRADER -t EXCHANGE -l 2
The above command accomplishes the following:
- Connects to FIX engine at IP address
10.10.10.10over TCP port23456 - Identifies itself as
TRADERvia FIX tagSenderCompID - Identifies a counterparty as
EXCHANGEvia FIX tagTargetCompID - Enables
DEBUGlogging level - Sends
Logonmessage and waits for incoming messages
Please note that the client will not respond to Test Request messages
by the FIX engine. Thus, at some point, the FIX engine will disconnect
the client.
fixcli --host 10.10.10.10 -p 23456 -s TRADER -t EXCHANGE -l 2 --mode gapfill
The above command uses gapfill mode (--mode gapfill). When used, the client
sends Resend Request message after it successfully authenticates to the
FIX engine.
fixcli --host 10.10.10.10 -p 23456 -s TRADER -t EXCHANGE -l 2 --mode keepalive
The keepalive mode enables the client to respond with Heartbeat message
in response to Test Request message by the FIX engine.
Ctrl + C to close the client's session to the FIX engine.
First, build the greenpau/fixcli image:
docker build -t greenpau/fixcli - < docker/alpine/Dockerfile
Then, run the tool directly:
docker run --rm greenpau/fixcli fixcli --host 10.10.10.10 -p 23456 -s TRADER -t EXCHANGE -l 2
Alternatively, create a container with a background process and execute commands. This allows the preservation of the session data created by the tool.
docker run -d -t --name=fixcli_greenpau --privileged --cap-add all --net=host greenpau/fixcli /bin/bash
docker exec -it fixcli_greenpau /bin/bash
After that, run the tool:
bash$ fixcli --host 10.10.10.10 -p 23456 -s TRADER -t EXCHANGE -l 2