يحتفظ TopstepX بقائمة بكل صفقة كاملة تغلقها، مع الرسوم والأوقات الدقيقة. ويسمح أيضًا بحفظ هذه القائمة ملفَّ CSV. يقرأ SetupBook هذا الملف كما هو: بلا مفتاح API، وبلا اشتراك شهري للوصول إلى API، وبلا تثبيت أي شيء. صدّر، أسقط، راجع المعاينة، استورد. يعرض هذا الدليل النقرات، ويقول ما في الملف، ويسمّي الشيء الوحيد الذي تتحقق منه بعد أول استيراد.
لا تبيع Topstep منذ يوليو 2025 سوى TopstepX، فهذا هو الملف الذي يملكه كل متداول لدى Topstep. إن كانت شركتك تعمل على Tradovate أو NinjaTrader أو Rithmic فلكلٍّ منها دليله: Tradovate وNinjaTrader 8 وR Trader Pro.
قبل أن تبدأ
- حساب في SetupBook. استيراد الملفات جزء من Pro، وكل يومية تبدأ بـ 14 يومًا منه: ابدأ 14 يومًا مجانًا.
- حساب في SetupBook من نوع Prop لحساب Combine أو الحساب الممول، كي تظهر قواعد شركة التمويل على لوحة المعلومات. صفحة يومية شركات التمويل تشرح المقاييس الثلاثة.
- TopstepX مفتوح في المتصفح أو في تطبيق سطح المكتب، وقد سجّلت الدخول.
1. افتح تبويب Trades لا Orders
في أسفل شاشة TopstepX لوحة بتبويبات: Positions وOrders وTrades وAlerts. انقر Trades. يعرض هذا التبويب الصفقات الكاملة المنتهية: صف لكل صفقة، مع الدخول والخروج والحجم والربح والخسارة والرسوم. أما تبويب Orders فيعرض كل أمر أرسلته، نُفّذ أم لا، وذلك الملف لا دخول فيه ولا خروج. يتعرف SetupBook على تصدير Orders ويخبرك أن تأخذ تبويب Trades بدلًا منه.
2. صدّر نطاقًا من التواريخ
انقر Export على يمين اللوحة. تسألك نافذة صغيرة عن أول يوم وآخر يوم. اختر النطاق وانقر Export مرة أخرى. تخبرك رسالة في الزاوية السفلية اليسرى أن الملف جاهز؛ يحفظه المتصفح بصيغة CSV.
إن كان الملف فارغًا فالنطاق كان قصيرًا جدًا أو أُغلقت الصفقات خارجه. اختر نطاقًا أطول وصدّر مجددًا. استيراد الصفقات نفسها مرتين لا يضر: يتخطى SetupBook الصفوف التي معرّفها موجود في اليومية.
3. ما الذي يحويه الملف
في الملف صف لكل صفقة كاملة وهذه الأعمدة: Id وContractName وEnteredAt وExitedAt وEntryPrice وExitPrice وFees وPnL وSize وType. تضيف بعض التصديرات TradeDay وTradeDuration وCommissions.
ثلاثة أمور تهم اليومية:
- المنطقة الزمنية داخل الملف. ينتهي كل وقت بفرق مثل
+03:00أو-05:00. يقرأ SetupBook هذا الفرق ويتجاهل محدد المنطقة لهذا الملف، فلا يمكنك اختيار منطقة خاطئة. - اسم العقد يحمل تاريخ الاستحقاق.
MESH5هو عقد مارس 2025 من MES. يحتفظ SetupBook بـMESرمزًا، فتبقى الأداة الواحدة سطرًا واحدًا في إحصاءاتك عبر كل ربع سنة، ويكتب الاسم الكامل في ملاحظة الصفقة. - الرسوم أعمدة منفصلة. يُجمع Fees، وCommissions إن وُجد، تكلفةً للصفقة. أما هل عمود PnL قبل هذه التكاليف أم بعدها فلا يُذكر في أي مكان. يفترض SetupBook أنه قبلها، فالصافي = PnL ناقص Fees ناقص Commissions. بعد أول استيراد افتح صفقة في SetupBook وقارن صافيها بالصفقة نفسها في TopstepX. إن كان TopstepX يعرض الرقم الذي يسميه SetupBook إجماليًا فأخبرنا عبر نموذج الاتصال ونبدّل القاعدة.
4. استورد إلى SetupBook
في SetupBook افتح الصفقات واضغط استيراد. أسقط ملف CSV في منطقة الملف. تظهر الصيغة مكتشفة تلقائيًا: صفقات TopstepX (CSV). اختر الحساب. يمكن ترك محدد المنطقة كما هو لأن هذا الملف يحمل فروق توقيته. اقرأ المعاينة: الرمز والاتجاه والحجم والدخول والخروج والصافي لكل صف، وموجودة عند أي صفقة في اليومية أصلًا. اضغط استيراد.
بعد الاستيراد حدد الصفوف الجديدة في جدول الصفقات وعيّن الاستراتيجية أو الأخطاء أو الجلسة لكلها دفعة واحدة. في دليل الاستيراد المزيد عن وسم الصفقات القديمة دفعة واحدة.
مشكلات
- الملف فارغ. وسّع نطاق التواريخ. تُحسب الصفقات بيوم الخروج.
- "هذا تصدير Orders." صدّرت تبويب Orders. عد إلى الخطوة 1 وافتح Trades.
- كل صفقة تقول موجودة. استُورد الملف من قبل. لا يُكتب شيء مرتين.
- رقم صافٍ يختلف عن TopstepX. قارن الرسوم أولًا. إن كان PnL في ملفك صافيًا من الرسوم أصلًا فأخبرنا ونعدّل القاعدة للجميع.
أسئلة شائعة
هل يتصل SetupBook بـ TopstepX عبر API؟
ليس بعد. تبيع Topstep الوصول إلى API اشتراكًا منفصلًا، ويمنح المفتاح صلاحيات تداول كاملة على كل حساب، ولا يتوفر في الحسابات الممولة. يغطي ملف CSV الصفقات نفسها مجانًا، فالملف أولًا. أما اتصال API للقراءة فقط فقرار منفصل.
أي منطقة زمنية أختار؟
لا شيء. كل وقت في ملف TopstepX ينتهي بفرق توقيته عن UTC، وSetupBook يستخدمه. المحدد لا يهم إلا في الملفات التي بلا فرق توقيت.
هل يحوي الملف الرسوم؟
نعم. Fees، وCommissions في التصديرات الأحدث، عمودان مستقلان ويُجمعان تكلفةً للصفقة. السؤال المفتوح هو هل PnL مخصوم منه هذه الرسوم أصلًا؛ تحقق من صفقة واحدة بعد أول استيراد.
هل أستورد الملف نفسه مجددًا الأسبوع القادم؟
نعم. لكل صف Id، ويتخطى SetupBook الصفقات الموجودة لديه. صدّر الشهر كله في كل مرة إن كان ذلك أسهل.
ماذا عن شركات ProjectX غير Topstep؟
أنهى ProjectX دعم الأطراف الثالثة في فبراير 2026، فصيغة الملف تعني الآن TopstepX. الأعمدة هي نفسها التي استخدمتها تصديرات ProjectX القديمة، فملف قديم من شركة أخرى يُقرأ أيضًا.