ادارہ جاتی FIX API (4.2 / 4.4 / 5.0 / 5.2)

GaiaEx کا نیٹیو C++26 ادارہ جاتی FIX گیٹ وے مستقل TCP/TLS سیشنز پر ڈیٹرمنسٹک، انتہائی کم تاخیر والا Order Entry، ریئل ٹائم Drop Copy، پوزیشن اور آرڈر انکوائری، اور L1/L2 مارکیٹ ڈیٹا سٹریمنگ فراہم کرتا ہے۔

ورژن نیگوشیئشن اور وائر رولز

ہر FIX سیشن کا آغاز ایک Logon (35=A) فریم سے ہوتا ہے جس کی تصدیق آپ کی GaiaEx API Key (Tag 553)، API Secret (Tag 554)، اور RawData (Tag 96) میں ایک لوئرکیس ہیکس HMAC-SHA256 دستخط کے ذریعے کی جاتی ہے۔

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

گیپ ریکوری (35=2 اور 35=4) اور منقطع ہونے پر منسوخی (CoD)

• ان باؤنڈ گیپ کا پتہ لگانا: اگر آنے والے میسج میں MsgSeqNum (34) > ExpectedSeqNum ہو، تو گیٹ وے فوری طور پر ResendRequest (35=2, 7=ExpectedSeqNum, 16=0) جاری کرتا ہے۔ اگر PossDupFlag (43=Y) کے بغیر MsgSeqNum (34) < ExpectedSeqNum ہو، تو گیٹ وے Logout (35=5, 1409=6) جاری کرتا ہے اور ساکٹ بند کر دیتا ہے۔
• آؤٹ باؤنڈ ری پلے: جب کلائنٹ ResendRequest (35=2) بھیجتا ہے، تو گیٹ وے تمام ایپلیکیشن پیغامات (بشمول Drop Copy 35=8 رپورٹس) کو 43=Y اور 122=OrigSendingTime کے ساتھ دوبارہ چلاتا ہے، اور ایڈمنسٹریٹو فریمز کو SequenceReset-GapFill (35=4, 123=Y) میں یکجا کر دیتا ہے۔
• منقطع ہونے پر خودکار منسوخی (CoD): جب کوئی Order Management سیشن منقطع ہوتا ہے، تو اس سیشن پر لگائے گئے تمام اوپن ریسٹنگ آرڈرز (OrdStatus 39=0) خود بخود منسوخ (150=4, 39=4, 103=3020) ہو جاتے ہیں اور کسی بھی فعال Drop Copy سیشن پر ریئل ٹائم میں براڈکاسٹ کر دیے جاتے ہیں۔

NewOrderSingle (35=D)

ترمیم (35=G)، منسوخی (35=F)، بڑے پیمانے پر منسوخی (35=q)، اسٹیٹس (35=H)، پوزیشنز (35=AN) اور حدود (35=XLQ)

Drop Copy پرائم بروکرز، رسک انجنوں، اور بیک آفس مفاہمتی نظاموں کو FIX Order Entry سیشنز اور REST/HTTP API آرڈرز دونوں کے تمام ExecutionReport (35=8) ایونٹس کی ایک ریئل ٹائم، صرف پڑھنے کے لیے (read-only) اسٹریم فراہم کرتا ہے۔

• عالمگیر سبسکرپشن فلیگز: پورٹ 9878 سے جڑیں اور 797=Y (CopyMsgIndicator)، 9406=Y (DropCopyFlag)، یا 50=DROPCOPY (SenderSubID) کے ساتھ Logon (35=A) بھیجیں۔
• ڈوئل ٹیگ آؤٹ باؤنڈ اسٹیمپنگ: ہر Drop Copy 35=8 فریم پر 57=DROPCOPY، 797=Y، اور 9406=Y کے ساتھ مکمل فیس/ریبیٹ بریک ڈاؤن (381=GrossTradeAmt، 1057=AggressorIndicator، 136=1|137=MiscFeeAmt|138=MiscFeeCurr|139=4، 20000=TradeFeeRebateAmt) درج ہوتا ہے۔
• سخت Read-Only تحفظ: Drop Copy سیشن پر 35=D، 35=F، 35=G، یا 35=q جمع کرانے کی کوئی بھی کوشش فوری طور پر BusinessMessageReject (35=j, 380=4) کے ذریعے مسترد کر دی جاتی ہے۔
• سیکوئنس گیپ ریکوری: آؤٹ باؤنڈ Drop Copy رپورٹس سیشن کے سیکوئنس اسٹور میں محفوظ رہتی ہیں اور انہیں PossDupFlag (43=Y) کے ساتھ ResendRequest (35=2) کے ذریعے دوبارہ چلایا جا سکتا ہے۔

مخصوص مارکیٹ ڈیٹا سٹریمنگ کے لیے پورٹ 9879 سے جڑیں یا SecurityListRequest (35=x) کے ذریعے انسٹرومنٹ کی تفصیلات دریافت کریں۔

• MarketDataRequest (35=V): 262=MDReqID، 263=1 (سنیپ شاٹ + اپ ڈیٹس) یا 0 (سنیپ شاٹ)، 264=1 (ٹاپ آف بک) یا 20 (مکمل ڈیپتھ)، اور 55=Symbol بھیجیں۔ یہ MarketDataSnapshotFullRefresh (35=W) کے بعد MarketDataIncrementalRefresh (35=X) واپس کرتا ہے۔ نامعلوم علامات MarketDataRequestReject (35=Y, 281=0) واپس کرتی ہیں۔
• SecurityListRequest (35=x): 320=SecurityReqID اور 559=0 (55 میں سنگل علامت) یا 559=4 (تمام انسٹرومنٹس) بھیجیں۔ ٹک سائز (969=MinPriceIncrement)، کم از کم/زیادہ سے زیادہ آرڈر کی مقدار (8000/8001)، اور اعشاریائی درستگی (8002/8003) کے ساتھ SecurityList (35=y) واپس کرتا ہے۔
• TradingSessionStatus (35=h): 340=2 (کھلا ہے 24x7x365) یا 340=1 (معطل) واپس کرتا ہے۔

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