واجهة برمجة التطبيقات المؤسسية FIX (4.2 / 4.4 / 5.0 / 5.2)

توفر بوابة المؤسسات FIX الأصلية المكتوبة بلغة C++26 في GaiaEx إمكانية إدخال الأوامر بزمن انتقال فائق الانخفاض وحتمي، وتغذية Drop Copy في الوقت الفعلي، والاستعلام عن المراكز والأوامر، بالإضافة إلى بث بيانات السوق L1/L2 عبر جلسات TCP/TLS الدائمة.

التفاوض على الإصدار وقواعد الإرسال عبر الشبكة

تبدأ كل جلسة FIX بإطار Logon (35=A) تتم مصادقته عبر مفتاح GaiaEx API الخاص بك (Tag 553)، وسر API (Tag 554)، وتوقيع HMAC-SHA256 سداسي عشري بأحرف صغيرة في 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()

استرداد الفجوات (35=2 و35=4) والإلغاء عند انقطاع الاتصال (CoD)

• اكتشاف الفجوات الواردة: إذا كانت الرسالة الواردة تحمل MsgSeqNum (34) > ExpectedSeqNum، تصدر البوابة فورًا ResendRequest (35=2, 7=ExpectedSeqNum, 16=0). إذا كانت MsgSeqNum (34) < ExpectedSeqNum بدون PossDupFlag (43=Y)، تصدر البوابة Logout (35=5, 1409=6) وتغلق المقبس.
• إعادة إرسال الرسائل الصادرة: عندما يرسل العميل ResendRequest (35=2)، تعيد البوابة إرسال جميع رسائل التطبيق (بما في ذلك تقارير Drop Copy 35=8) مع 43=Y و122=OrigSendingTime، وتدمج الأطر الإدارية في SequenceReset-GapFill (35=4, 123=Y).
• الإلغاء التلقائي عند انقطاع الاتصال (CoD): عند انقطاع اتصال جلسة إدارة الأوامر، يتم تلقائيًا إلغاء جميع الأوامر المفتوحة القائمة (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 لوسطاء الحفظ المالي (Prime Brokers)، ومحركات المخاطر، وأنظمة التسوية للمكاتب الخلفية بثًا لحظيًا للقراءة فقط لجميع أحداث ExecutionReport (35=8) عبر كل من جلسات إدخال أوامر FIX وأوامر واجهة برمجة التطبيقات REST/HTTP.

• علامات الاشتراك العامة: اتصل بالمنفذ 9878 وأرسل Logon (35=A) مع 797=Y (CopyMsgIndicator)، أو 9406=Y (DropCopyFlag)، أو 50=DROPCOPY (SenderSubID).
• الوسم الثنائي الصادر: يحمل كل إطار 35=8 في Drop Copy الوسوم 57=DROPCOPY، و797=Y، و9406=Y، بالإضافة إلى تفصيل كامل للرسوم/الخصومات (381=GrossTradeAmt، 1057=AggressorIndicator، 136=1|137=MiscFeeAmt|138=MiscFeeCurr|139=4، 20000=TradeFeeRebateAmt).
• حماية صارمة للقراءة فقط: يتم رفض أي محاولة لإرسال 35=D، أو 35=F، أو 35=G، أو 35=q عبر جلسة Drop Copy فورًا من خلال BusinessMessageReject (35=j, 380=4).
• استرداد فجوات التسلسل: يتم حفظ تقارير Drop Copy الصادرة في مخزن تسلسل الجلسة ويمكن إعادة بثها عبر ResendRequest (35=2) مع PossDupFlag (43=Y).

اتصل بالمنفذ 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 (جميع الأدوات المالية). يعيد SecurityList (35=y) متضمنًا حجم التكة (969=MinPriceIncrement)، والحد الأدنى/الأقصى لكمية الأمر (8000/8001)، والدقة العشرية (8002/8003).
• TradingSessionStatus (35=h): يعيد 340=2 (مفتوح على مدار الساعة 24×7×365) أو 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