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

GaiaEx Yerel C++26 Kurumsal FIX Ağ Geçidi; kalıcı TCP/TLS oturumları üzerinden deterministik, ultra düşük gecikmeli Emir Girişi, Gerçek Zamanlı Drop Copy, Pozisyon ve Emir Sorgulama ile L1/L2 Piyasa Verisi akışı sağlar.

Sürüm Müzakeresi ve Hat Kuralları

Her FIX oturumu, GaiaEx API Anahtarınız (Tag 553), API Gizli Anahtarınız (Tag 554) ve RawData (Tag 96) içindeki küçük harfli onaltılık HMAC-SHA256 imzası ile doğrulanmış bir Logon (35=A) çerçevesiyle başlar.

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()

Boşluk Kurtarma (35=2 & 35=4) ve Bağlantı Kesildiğinde İptal Et (CoD)

• Gelen Mesaj Boşluk Tespiti: Gelen bir mesaj MsgSeqNum (34) > ExpectedSeqNum taşıyorsa, ağ geçidi derhal ResendRequest (35=2, 7=ExpectedSeqNum, 16=0) yayınlar. Eğer PossDupFlag (43=Y) olmadan MsgSeqNum (34) < ExpectedSeqNum tespit edilirse, ağ geçidi Logout (35=5, 1409=6) yayınlar ve soketi kapatır.
• Giden Mesaj Yeniden Oynatma: İstemci ResendRequest (35=2) gönderdiğinde, ağ geçidi tüm uygulama mesajlarını (Drop Copy 35=8 raporları dahil) 43=Y ve 122=OrigSendingTime ile yeniden oynatır ve yönetimsel çerçeveleri SequenceReset-GapFill (35=4, 123=Y) içinde birleştirir.
• Otomatik Bağlantı Kesildiğinde İptal Et (CoD): Bir Emir Yönetimi oturumunun bağlantısı kesildiğinde, o oturumda verilen tüm açık bekleyen emirler (OrdStatus 39=0) otomatik olarak iptal edilir (150=4, 39=4, 103=3020) ve aktif durumdaki herhangi bir Drop Copy oturumuna gerçek zamanlı olarak yayınlanır.

NewOrderSingle (35=D)

Değiştirme (35=G), İptal (35=F), Toplu İptal (35=q), Durum (35=H), Pozisyonlar (35=AN) ve Limitler (35=XLQ)

Drop Copy; ana aracı kurumlara (prime brokers), risk motorlarına ve arka ofis mutabakat sistemlerine hem FIX Emir Girişi oturumları hem de REST/HTTP API emirleri genelindeki tüm ExecutionReport (35=8) olaylarının gerçek zamanlı, yalnızca okunabilir bir akışını sunar.

• Evrensel Abonelik Bayrakları: 9878 numaralı bağlantı noktasına bağlanın ve 797=Y (CopyMsgIndicator), 9406=Y (DropCopyFlag) veya 50=DROPCOPY (SenderSubID) ile birlikte Logon (35=A) gönderin.
• Çift Etiketli Giden Damgalama: Her Drop Copy 35=8 çerçevesi, eksiksiz komisyon/iade dökümünün (381=GrossTradeAmt, 1057=AggressorIndicator, 136=1|137=MiscFeeAmt|138=MiscFeeCurr|139=4, 20000=TradeFeeRebateAmt) yanı sıra 57=DROPCOPY, 797=Y ve 9406=Y taşır.
• Katı Yalnızca Okunabilir Koruma: Drop Copy oturumunda 35=D, 35=F, 35=G veya 35=q gönderme girişimleri derhal BusinessMessageReject (35=j, 380=4) aracılığıyla reddedilir.
• Sıra Boşluğu Kurtarma: Giden Drop Copy raporları, oturum sıra deposunda kalıcı olarak saklanır ve PossDupFlag (43=Y) ile birlikte ResendRequest (35=2) aracılığıyla yeniden oynatılabilir.

Özel Piyasa Verisi akışı için 9879 numaralı bağlantı noktasına bağlanın veya SecurityListRequest (35=x) aracılığıyla enstrüman özelliklerini sorgulayın.

• MarketDataRequest (35=V): 262=MDReqID, 263=1 (Anlık Görüntü + Güncellemeler) veya 0 (Anlık Görüntü), 264=1 (Emir Defteri Tepesi) veya 20 (Tam Derinlik) ve 55=Symbol gönderin. MarketDataSnapshotFullRefresh (35=W) ve ardından gelen MarketDataIncrementalRefresh (35=X) döner. Bilinmeyen semboller MarketDataRequestReject (35=Y, 281=0) döndürür.
• SecurityListRequest (35=x): 320=SecurityReqID ve 559=0 (55 içinde tek sembol) veya 559=4 (tüm enstrümanlar) gönderin. Fiyat adımı (969=MinPriceIncrement), min/maks emir miktarı (8000/8001) ve ondalık basamak hassasiyeti (8002/8003) içeren SecurityList (35=y) döner.
• TradingSessionStatus (35=h): 340=2 (7/24/365 Açık) veya 340=1 (Durduruldu) döndürür.

QuickFIX İstemci Yapılandırma Şablonu (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