مراجعة تداولات الشهر الماضي¶

تجيب المراجعة الشهرية عن ثلاثة أسئلة: كم صفقة أُغلقت؟ وما النتائج التي حققتها؟ وأين لا تزال المخاطر قائمة؟ يجمع هذا الدليل الصفقات وسجل الأوامر المكتملة والتعرض الحالي للمخاطر في مجلد مؤرخ، ثم يضم الخطوات في نص برمجي يمكنك إعادة تشغيله بنهاية كل شهر.

export CTID=letstrade
export ACC=7654321
export PWD_FILE=$HOME/.ctrader/pwd

1. الحصول على الصفقات المغلقة خلال الشهر ¶

يعيد deals الصفقات المغلقة فقط: سجلًا واحدًا لكل صفقة إغلاق، متضمنًا الربح أو الخسارة المحققة. هذه هي البيانات نفسها الموجودة في علامة التبويب السجل في cTrader. يرشّح --from و--to الصفقات بحسب وقت إغلاقها، بينما يعيد --count أحدث الصفقات المغلقة. لا يتضمن الناتج عمليات التنفيذ التي تفتح المراكز، ولذلك لا يظهر المركز في deals إلا بعد إغلاقه كليًا أو جزئيًا.

ctrader-cli deals --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
    --from=01/06/2025 --to=30/06/2025

يتضمن ناتج كل صفقة مغلقة الرمز واتجاه التداول والحجم وسعر التنفيذ والربح المحقق.

2. الحصول على سجل الأوامر المكتملة ¶

يعرض orders-history الأوامر المكتملة خلال الفترة نفسها، مع حالتها النهائية (filled أو expired أو cancelled أو error). لا يشمل الناتج الأوامر المعلقة.

ctrader-cli orders-history --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q \
    --from=01/06/2025 --to=30/06/2025

قارن قائمة الصفقات بسجل الأوامر لمعرفة أي أوامر الدخول تقابل أوامر الخروج.

تخضع بيانات السجل في deals وorders-history للقيود التالية:

• تحمّل CLI الفترة الكاملة المحددة بواسطة --from / --to من دون حد لمدة الفترة.
• لكن الاستدعاء الواحد يعيد آخر 200 صفقة (deals) فقط أو آخر 500 أمر (orders-history) ضمن الفترة.
• في حال عدم تحديد --from / --to، يعيد كلا الأمرين بيانات آخر 30 يومًا فقط.

إذا أجريت عددًا كبيرًا من الصفقات خلال الشهر، فقسّم الفترة إلى أجزاء أقصر ونفّذ كل أمر مرة لكل جزء.

3. الاطلاع على التعرض الحالي للمخاطر ¶

يلخّص exposure تعرض المراكز المفتوحة على الحساب للمخاطر، مع تجميع النتائج حسب الرمز. تمنحك هذه البيانات لمحة عن المخاطر التي ستظل قائمة في اليوم التالي للمراجعة.

ctrader-cli exposure --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q

4. حفظ كل نتيجة في ملف مؤرخ ¶

يعيد كل أمر بيانات بصيغة JSON، لذا يكفي إعادة توجيه المخرجات للاحتفاظ بسجل المراجعة.

MONTH=2025-06
ctrader-cli deals          --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=01/06/2025 --to=30/06/2025 > ${MONTH}_deals.json
ctrader-cli orders-history --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=01/06/2025 --to=30/06/2025 > ${MONTH}_orders.json
ctrader-cli exposure       --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q > ${MONTH}_exposure.json

ستحصل على ثلاثة ملفات مؤرخة، ملف لكل سؤال، ويمكن مقارنتها بسهولة بملفات مراجعة الشهر التالي.

5. جمع الخطوات في نص برمجي للمراجعة الشهرية ¶

احفظ التسلسل كاملًا باسم monthly-review.sh. يحسب النص البرمجي اليوم الأول والأخير من الشهر السابق تلقائيًا، لذا يعمل بغض النظر عن تاريخ تشغيله.

#!/usr/bin/env bash
set -euo pipefail

CTID=letstrade
ACC=7654321
PWD_FILE=$HOME/.ctrader/pwd

MONTH=$(date -d "last month" +%Y-%m)
FROM=$(date -d "last month" +01/%m/%Y)
TO=$(date -d "last month" +$(date -d "last day of last month" +%d)/%m/%Y)

mkdir -p ${MONTH}
cd ${MONTH}

ctrader-cli deals          --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=$FROM --to=$TO > ${MONTH}_deals.json
ctrader-cli orders-history --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q --from=$FROM --to=$TO > ${MONTH}_orders.json
ctrader-cli exposure       --ctid=$CTID --pwd-file=$PWD_FILE --account=$ACC -q > ${MONTH}_exposure.json

echo "Review for ${MONTH} saved to $(pwd)/${MONTH}_*.json"

شغّله مرة كل شهر لإنشاء مجلد يحمل طابعًا زمنيًا لكل فترة. في Linux، يقبل date -d التعبيرين last month وlast day of last month مباشرةً. في macOS، استخدم البديل gdate من حزمة coreutils أو حدّد قيمًا ثابتة لـ--from و--to.

6. اكتشاف الأنماط في البيانات ¶

تأتي ملفات JSON في بنية تتيح تحليلها داخل دفتر ملاحظات برمجي أو باستخدام سلسلة بسيطة من أوامر القشرة. من التحليلات الشائعة:

• نسبة الصفقات الرابحة: قارن عدد الصفقات ذات الربح الموجب بعدد الصفقات الخاسرة.
• التوزيع حسب الرمز: اجمع الصفقات بحسب الرمز واحسب مجموع الأرباح لكل مجموعة.
• أكبر خسارة فردية: رتّب الصفقات حسب الربح وحدّد أدنى قيمة.
• مخاطر المراكز المفتوحة: راجع ملف التعرض للمخاطر لمعرفة الرموز التي لا تزال عليها مراكز مفتوحة.

أضف إلى هذه التحليلات لقطة account-stats من اليوم نفسه للحصول على صورة أوضح لكيفية تغير حالة الحساب خلال الشهر.

تسرد مراجع أوامر cTrader CLI جميع الخيارات المتاحة للأوامر المستخدمة في هذا الإجراء.