API FIX Institusional (4.2 / 4.4 / 5.0 / 5.2)

GaiaEx Native C++26 Institutional FIX Gateway menyediakan Order Entry berlatensi sangat rendah dan deterministik, Real-Time Drop Copy, Penyelidikan Posisi & Pesanan, serta streaming Data Pasar L1/L2 melalui sesi TCP/TLS persisten.

Negosiasi Versi & Aturan Wire

Setiap sesi FIX dimulai dengan frame Logon (35=A) yang diautentikasi melalui GaiaEx API Key (Tag 553), API Secret (Tag 554), dan tanda tangan HMAC-SHA256 heksadesimal huruf kecil dalam RawData (Tag 96).

import hmac, hashlib

def sign_fix_logon(api_secret: str, sending_time: str, seq_num: int, sender_comp_id: str, target_comp_id: str) -> str:
    # Canonical prehash string: SendingTime(52) | MsgType(35) | MsgSeqNum(34) | SenderCompID(49) | TargetCompID(56)
    payload = f"{sending_time}|A|{seq_num}|{sender_comp_id}|{target_comp_id}"
    return hmac.new(api_secret.encode("utf-8"), payload.encode("utf-8"), hashlib.sha256).hexdigest()

Pemulihan Gap (35=2 & 35=4) & Cancel-on-Disconnect (CoD)

• Deteksi Gap Masuk: Jika pesan masuk membawa MsgSeqNum (34) > ExpectedSeqNum, gateway segera memancarkan ResendRequest (35=2, 7=ExpectedSeqNum, 16=0). Jika MsgSeqNum (34) < ExpectedSeqNum tanpa PossDupFlag (43=Y), gateway memancarkan Logout (35=5, 1409=6) dan menutup soket.
• Replay Keluar: Ketika klien mengirimkan ResendRequest (35=2), gateway memutar ulang semua pesan aplikasi (termasuk laporan Drop Copy 35=8) dengan 43=Y dan 122=OrigSendingTime, serta menggabungkan frame administratif ke dalam SequenceReset-GapFill (35=4, 123=Y).
• Cancel-on-Disconnect (CoD) Otomatis: Ketika sesi Order Management terputus, semua pesanan resting terbuka (OrdStatus 39=0) yang ditempatkan pada sesi tersebut secara otomatis dibatalkan (150=4, 39=4, 103=3020) dan disiarkan secara real-time ke sesi Drop Copy mana pun yang aktif.

NewOrderSingle (35=D)

Amandemen (35=G), Batal (35=F), Pembatalan Massal (35=q), Status (35=H), Posisi (35=AN) & Batas (35=XLQ)

Drop Copy menyediakan prime broker, risk engine, dan sistem rekonsiliasi back-office dengan stream hanya-baca real-time dari semua peristiwa ExecutionReport (35=8) di seluruh sesi FIX Order Entry dan pesanan REST/HTTP API.

• Flag Langganan Universal: Sambungkan ke port 9878 dan kirimkan Logon (35=A) dengan 797=Y (CopyMsgIndicator), 9406=Y (DropCopyFlag), atau 50=DROPCOPY (SenderSubID).
• Pemberian Tanda Tag Ganda Keluar: Setiap frame 35=8 Drop Copy membawa 57=DROPCOPY, 797=Y, dan 9406=Y, ditambah rincian biaya/rabat lengkap (381=GrossTradeAmt, 1057=AggressorIndicator, 136=1|137=MiscFeeAmt|138=MiscFeeCurr|139=4, 20000=TradeFeeRebateAmt).
• Perlindungan Read-Only yang Ketat: Upaya apa pun untuk mengirimkan 35=D, 35=F, 35=G, atau 35=q pada sesi Drop Copy akan langsung ditolak via BusinessMessageReject (35=j, 380=4).
• Pemulihan Gap Urutan: Laporan Drop Copy keluar disimpan secara persisten di penyimpanan urutan sesi dan dapat diputar ulang via ResendRequest (35=2) dengan PossDupFlag (43=Y).

Sambungkan ke port 9879 untuk streaming Data Pasar khusus atau tanyakan spesifikasi instrumen via SecurityListRequest (35=x).

• MarketDataRequest (35=V): Kirimkan 262=MDReqID, 263=1 (Snapshot + Pembaruan) atau 0 (Snapshot), 264=1 (Top of Book) atau 20 (Kedalaman Penuh), dan 55=Symbol. Mengembalikan MarketDataSnapshotFullRefresh (35=W) diikuti oleh MarketDataIncrementalRefresh (35=X). Simbol yang tidak dikenal mengembalikan MarketDataRequestReject (35=Y, 281=0).
• SecurityListRequest (35=x): Kirimkan 320=SecurityReqID dan 559=0 (simbol tunggal dalam 55) atau 559=4 (semua instrumen). Mengembalikan SecurityList (35=y) dengan tick size (969=MinPriceIncrement), kuantitas pesanan min/maks (8000/8001), dan presisi desimal (8002/8003).
• TradingSessionStatus (35=h): Mengembalikan 340=2 (Buka 24x7x365) atau 340=1 (Dihentikan Sementara).

Templat Konfigurasi Klien QuickFIX (gaiaex_fix.cfg)

[DEFAULT]
ConnectionType=initiator
ReconnectInterval=5
FileStorePath=./store
FileLogPath=./log
StartTime=00:00:00
EndTime=00:00:00
UseDataDictionary=Y
DataDictionary=./fix-dictionary.xml
ValidateUserDefinedFields=N
ValidateFieldsOutOfOrder=N
HeartBtInt=30

[SESSION]
BeginString=FIX.4.4
SenderCompID=INST_CLIENT_OE
TargetCompID=GAIAEX_PROD
SocketConnectHost=10.10.0.51
SocketConnectPort=9878
ResetOnLogon=N

[SESSION]
BeginString=FIX.4.4
SenderCompID=INST_CLIENT_DC
TargetCompID=GAIAEX_PROD
SenderSubID=DROPCOPY
SocketConnectHost=10.10.0.51
SocketConnectPort=9878
ResetOnLogon=N