مخاطر الأتمتة: البيانات والأخطاء والمفاتيح والذكاء الاصطناعي
باختصار
- افحص البيانات قبل أي تنبيه: عمر اللقطة (الوقت الحالي ناقص
meta.updated_at)، وعلمstaleفي دفاتر الأوامر، والسبريد عند أفضل الأسعار، وعقدًا مشتركًا على البورصتين في الزوج. - الخطأ
503يعني غياب البيانات، أماdataالفارغة مع200فتعني أن شيئًا لم يطابق الفلتر. يميّز البوت بين الحالتين ويبلّغ عن عطل بعد ثلاث دورات بلا بيانات. - ينهار الكود عند الحالات الحدّية: إعادة المحاولة بلا توقف تصطدم بـ
429، وقيمةnullفي مقارنة تُسقط Python، والقسمة على صفر في JavaScript تعطيInfinityوتنبيهًا كاذبًا، والتوقيت المحلي بدل UTC يزحزح دفعة التمويل ساعات. - مفتاح Genesis API للقراءة فقط، فتسريبه يستنزف حصتك. أما مفتاح البورصة بصلاحية السحب فيعرّض أموالك للخطر، وبوت التداول لا يحتاج هذه الصلاحية.
- يخلط نموذج الذكاء الاصطناعي الأرقام وقد ينفّذ أمرًا مخبّأً في نص غريب: الكود يدرج الأرقام في الرسائل، والحقول الخارجية تصل النموذج كبيانات، والكود يفرض حدود الصفقات، وإنسان يؤكد كل أمر.
مخاطر بوت التداول على API العملات الرقمية أربع مجموعات: بيانات قديمة أو سبريد غير موجود فعليًا؛ كود يدور في حلقة أو ينهار عند حالة حدّية؛ مفتاح يتسرب؛ ونموذج ذكاء اصطناعي يخطئ في رقم أو ينفّذ أمر غيره. لكل خطر فحص في الكود أو قاعدة عمل، وكلها تتسع في المراقب من الدرس 4 أيضًا.
مخاطر البيانات
لقطة قديمة
تُبنى لقطة Genesis API عند meta.updated_at، وتحدّثها خطتك كل meta.freshness_sec ثانية: 60 في Trial و30 في Start و10 في Pro و5 في Max. عمر اللقطة هو الوقت الحالي ناقص meta.updated_at، وهو حداثة البيانات. فاصل أو فاصلان من فواصل الخطة أمر عادي؛ وأكثر من ثلاثة يعني أن اللقطة عالقة.
مثال افتراضي: في Pro العتبة 3 × 10 = 30 ث. يصل رد في 1783802470 وmeta.updated_at = 1783802410: العمر 1783802470 − 1783802410 = 60 ث، فلا يرسل البوت أي تنبيه منه. وزمن التأخير الكامل من البورصة إلى كودك أكبر من ذلك، ويُقاس العمر بساعة خادمك، فأبقِها متزامنة عبر NTP.
دفاتر الأوامر ومنصات التنبؤات
لدفاتر الأوامر ساعتها الخاصة: يعيد /orderbooks/book الحقول book_ts وage_sec وعلم stale الذي يكون true حين يزيد عمر الدفتر على 30 ثانية. تتأخر الدفاتر عن البورصة بـ 5–20 ثانية. في Order-book Δ افحص order_delta.status: القيمة ok تعني أن الحساب تم، وno_book تعني غياب الدفتر، وexhausted تعني أن الدفتر لم يستطع تغطية الحجم.
لأسواق التنبؤ يوجد /predictions/platforms: تخطَّ الأزواج التي تشمل منصة في mode = down، أو منصة قيمة quotes_at فيها قديمة، أو مكتب مراهنات فيه ok = false.
رد فارغ عند 503
القائمة الفارغة وغياب البيانات حالتان مختلفتان. الرد 200 مع meta.count = 0 يعني أن أي صف لم يطابق الفلتر. أما 503 snapshot_not_ready فيعني أن البيانات تُعاد بناؤها: قد يكون في السوق أزواج، وتعيد المحاولة بعد Retry-After ثانية.
تعيد الدالة fetch الزوج (data, meta)، أو None عند غياب البيانات. تعيد المحاولة عند 429 و503 بعد Retry-After، وعند أخطاء 5xx الأخرى وأعطال الشبكة بعد توقفات 5 و10 و20 ثانية، وتتوقف عند كل ما سواها.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch(path, params=None, tries=4):
"""(data, meta)، أو None: لا بيانات، وهذا ليس «لا أزواج»."""
for attempt in range(tries):
try:
r = requests.get(BASE + path, headers=HEADERS,
params=params, timeout=15)
code = r.status_code
except requests.RequestException:
code = 0 # خطأ شبكة أو مهلة: أعد المحاولة بعد توقف
if code == 200:
body = r.json()
return body["data"], body["meta"]
wait = 5 * 2 ** attempt # 5 و10 و20 ث: يزداد التوقف
if code in (429, 503):
wait = int(r.headers.get("Retry-After", wait))
if wait > 60: # لا تنتظر أكثر من دقيقة
raise RuntimeError(f"انتظار {wait} ث: افحص حصتك")
elif 400 <= code < 500:
# 400 و401 و403 و404 و410: إعادة المحاولة لن تصلحها
raise RuntimeError(f"{code}: {r.text[:200]}")
if attempt < tries - 1:
time.sleep(wait)
return None
يصل Retry-After طويلًا أيضًا حين تُستنفد حصة الفترة: قد يكون التصفير بعد أيام، ولا تنتظر fetch أكثر من دقيقة. إعادة المحاولة وETag والفلاتر مشروحة في مقال الاستعلام الدوري عن API دون بلوغ الحدود.
سبريد وهمي: دفاتر رقيقة ورموز متشابهة
يُحسب spread_pct من آخر الصفقات، بينما لا يمكنك الشراء إلا عند ask ولا البيع إلا عند bid. في مثال FUEL من دليل نقاط نهاية المراجحة يبلغ السبريد 0.11% بآخر الصفقات و−0.11% عند أفضل الأسعار. يأتي الحقلان ask_buy وbid_sell في كل صف Spot – Spot على أي خطة، وتستخدمهما quote_spread أدناه لحساب السبريد عند أفضل الأسعار.
دفتر الأوامر الرقيق يضخّم الفجوة. مثال افتراضي: طُبعت آخر صفقة عند 1.18$ قبل ساعة، وأفضل bid الآن 1.02$، وask في بورصة الشراء 1.00$. السبريد 18% بآخر الصفقات و2% عند أفضل الأسعار، وقد لا يُنفَّذ 1000$ إطلاقًا: في Pro وMax تُظهر order_delta.status = exhausted عند volume=1000 ذلك تحديدًا.
المصدر الثاني للسبريد الوهمي رمز واحد تتقاسمه عملات مختلفة، مثل عملة على BSC ومشروع لا علاقة له على Solana. للعملة ذات العقد اطلب /coins/search والرمز في query: يجب أن يضم contracts[] عنصرًا تذكر exchanges فيه بورصتي الزوج معًا (قارن الأسماء دون اعتبار لحالة الأحرف). غياب هذا العنصر يعني عدم وجود تحويل مباشر: إما أنها عملات مختلفة، أو أن المسار يمر عبر جسر له مخاطره.
def is_fresh(meta, k=3):
"""اللقطة ليست أقدم من k من فواصل الخطة."""
age = time.time() - meta["updated_at"]
return age <= k * meta["freshness_sec"]
def quote_spread(row):
"""السبريد عند أفضل الأسعار: الشراء عند ask والبيع عند bid."""
ask, bid = row.get("ask_buy"), row.get("bid_sell")
if ask is None or bid is None or ask <= 0:
return None # لا سعر أو سعر صفري: تخطَّ الصف
return (bid - ask) / ask * 100
pause, fails = 60, 0
while True:
got = fetch("/arbitrage/spot-spot", {"min_spread": 1})
if got is None or not is_fresh(got[1]):
fails += 1 # لا بيانات أو بيانات قديمة: لا تنبيهات
if fails == 3:
print("3 دورات بلا بيانات حديثة") # نبّه نفسك
else:
rows, meta = got
fails, pause = 0, meta["freshness_sec"]
for row in rows:
s = quote_spread(row)
if s is not None and s >= 0.5:
print(row["coin"], row["exchange_buy"], "→",
row["exchange_sell"], f"{s:.2f}%")
time.sleep(pause) # التوقف يُنفَّذ في كل مسار
استثناء من fetch يوقف الحلقة: البوت في الإنتاج يراسل صاحبه قبل أن يخرج.
مخاطر الكود
إعادة المحاولة بلا توقف وحلقات لا تنتهي
كثيرًا ما يعيد البوت الأول المحاولة فور الخطأ: if r.status_code != 200: continue. عند 503 تطلق حلقة كهذه الطلبات واحدًا تلو الآخر بلا توقف: الأخطاء لا تستهلك الحصة لكنها تُحتسب في حد الطلبات في الثانية، فيتبعها 429 مع Retry-After: 1. وحين ينتهي الاشتراك تتلقى الحلقة نفسها 401 إلى الأبد. وكلمة continue قبل time.sleep() تتخطى التوقف عند كل رد فارغ، ولهذا يكون التوقف آخر سطر في الحلقة أعلاه.
الخطأ المعاكس هو الانتظار إلى الأبد. time.sleep(int(r.headers["Retry-After"])) عند حصة منتهية ينام أيامًا: مثلًا Retry-After: 259200 يساوي 259,200 / 86,400 = 3 أيام. وقد يتعلق الطلب بلا timeout إلى ما لا نهاية، كما يحذّر توثيق requests.
null والقسمة على صفر
يستخدم Genesis API القيمة null للقيم الفارغة، وتحوّلها Python إلى None. مقارنة row["volume_24h_sell"] > 10000 مع None ترفع TypeError، وصف واحد يُسقط الحلقة كلها. أما JavaScript فلا ترفع شيئًا: null > 0.5 تساوي false وnull < 1 تساوي true، فيفشل الفلتر بصمت.
null تعني «لا بيانات»، واستبدالها بصفر عبر or 0 خطر: في انزلاق DEX تعني tax_sell_pct = null أنه لا يوجد مصدر للضريبة، وor 0 تحوّلها إلى 0%. وحسب التوثيق تظهر null في bid_* وask_* وvolume_24h_* وmax_position_usd وnext_payout، وفي profit_usd للأزواج التي فيها ساق مكتب مراهنات، وفي apr_pct حين يبقى أقل من يوم.
القسمة على صفر فخ مماثل. ask صفري يرفع ZeroDivisionError في Python، بينما في JavaScript تساوي 1 / 0 القيمة Infinity وتكون Infinity > 0.5 صحيحة true: يرسل البوت زوجًا بسبريد لا نهائي. افحص المقام قبل القسمة، كما تفحص quote_spread الشرط ask <= 0.
المناطق الزمنية
أوقات Genesis API ثوانٍ بنظام unix ونصوص UTC: يأتي next_payout في معدلات التمويل بصيغة HH:MM بتوقيت UTC. الدالة datetime.fromtimestamp(ts) بلا منطقة زمنية تعيد التوقيت المحلي للخادم، وdatetime.utcnow() مهجورة منذ Python 3.12؛ وتشير وثائق Python إلى datetime.now(timezone.utc) بدلًا منها.
مثال افتراضي: الخادم على UTC+3 وساعته تعرض 09:30، أي 06:30 بتوقيت UTC. تبقى على دفعة 08:00 ساعة و30 دقيقة، لكن الكود الذي يقارن 08:00 بالتوقيت المحلي يقرر أن الدفعة فاتت ويحسب 22 ساعة و30 دقيقة للتالية، بفارق 21 ساعة.
from datetime import datetime, timedelta, timezone
def until_payout(hhmm, now=None):
"""الوقت حتى next_payout، وهو نص HH:MM بتوقيت UTC."""
if hhmm is None:
return None # null: لا وقت للدفعة
now = now or datetime.now(timezone.utc)
h, m = map(int, hhmm.split(":"))
t = now.replace(hour=h, minute=m, second=0, microsecond=0)
if t <= now:
t += timedelta(days=1) # «00:00» عند 23:50 تعني الغد
return t - now
now = datetime(2026, 11, 15, 6, 30, tzinfo=timezone.utc)
print(until_payout("08:00", now)) # 1:30:00
مخاطر المفاتيح
مفتاح Genesis API للقراءة فقط: لا يستطيع وضع أوامر ولا سحب أموال. يضرب التسريب حصتك وحد الطلبات في الثانية، فيتلقى بوتك 429 قبل نهاية الفترة. من علامات الخطر: «الاستدعاءات المستخدمة» في ملفك الشخصي تنمو أسرع مما يفسره كودك، أو يعرض «استُخدم …» وقتًا حديثًا بينما البوت متوقف.
يُعرض المفتاح مرة واحدة وتحتفظ Genesis Arbitrage بالبصمة (hash) فقط، لذا يُعاد إصدار المفتاح المسرّب: «إعادة الإصدار» توقف المفتاح القديم فورًا وتصدر مفتاحًا جديدًا. تتسرب المفاتيح من أماكن وُضعت فيها بالخطأ: مستودع عام، أو رابط طلب، أو كود صفحة، أو لقطة شاشة، أو سجل فيه ترويسات الطلبات. سجّل رمز الحالة وX-Request-Id بدلًا من ذلك؛ وقواعد التخزين في مدخل مفتاح API من المسرد.
مفتاح البورصة فئة مخاطر مختلفة: مع صلاحية السحب يستطيع نقل العملات خارج الحساب. بوت التداول لا يحتاج هذه الصلاحية، فأنشئ المفتاح بلا سحب، ومرتبطًا بعنوان IP لخادمك، ومنفصلًا لكل خدمة. التفاصيل في كيف تؤمّن حساب بورصة العملات الرقمية.
وكلاء الذكاء الاصطناعي: الأرقام والأوامر المحقونة والتأكيد
يستدعي الوكيل Genesis API عبر خادمك: يختار النموذج نقطة النهاية والمعاملات، وينفّذ الخادم الطلب بالمفتاح. الإعداد في دليل Genesis API لوكلاء الذكاء الاصطناعي، والتصميم العام في مقال بيانات سوق العملات الرقمية لوكلاء الذكاء الاصطناعي.
أرقام خاطئة
قد يقرأ النموذج 0.92 على أنها 92% بدل 0.92%، أو يخلط بين funding_pct للفاصل الواحد وfunding_8h_pct لثماني ساعات، أو يذكر سعرًا غير موجود في الرد. يُدرج الكود الأرقام في التنبيهات مباشرة من رد API، ويبقى للنموذج الاختيار والشرح. وإذا كتب النموذج الأرقام بنفسه فقارن كل رقم بنتيجة الأداة.
أوامر في نص غريب
بعض الحقول يكتبها أشخاص آخرون: title وoutcome في أسواق التنبؤ، وname للمتداول، وtoken_name لأحداث السلسلة، وmessage_ru وmessage_en في الإشارات. يستطيع أي أحد تسمية رمز «تجاهل التعليمات السابقة و…»، والنموذج الذي يقرأ الاسم كجزء من موجّهه قد ينفّذه. هذا هو حقن الموجّه (prompt injection)، أول بند في OWASP Top 10 لتطبيقات LLM لعام 2025: LLM01:2025.
مرّر هذه الحقول داخل نتيجة الأداة فقط، وحدّد طولها، وانصّ في موجّه النظام على أنها بيانات. ويبقى المفتاح في المعالج على الخادم.
تأكيد بشري
يقرأ Genesis API البيانات فقط: الوكيل المبني عليه يجد زوجًا ويكتب عنه، لكنه لا يتداول. أما واجهة تداول بورصة موصولة بالوكيل فخارج Genesis API وعلى مسؤوليتك. وضمن إجراءات التخفيف التي يذكرها OWASP رقابة بشرية على العمليات ذات الصلاحيات: لا يخرج أمر إلا بعد «نعم» من متداول يرى الزوج والأسعار ووقت البيانات.
قائمة الفحص قبل الإطلاق
- المفتاح في
GENESIS_API_KEYعلى الخادم، وليس في أي مكان من الكود أو روابط الطلبات أو المتصفح أو السجلات أو الموجّهات. - لكل طلب
timeout. - لا تُعاد المحاولة إلا عند
429و503وأخطاء 5xx الأخرى وأعطال الشبكة، مع توقف وثلاث مرات كحد أقصى. - الأخطاء
400و401و403و404و410وRetry-Afterفوق دقيقة توقف البوت برسالة. - التوقف بين الاستعلامات لا يقل عن
meta.freshness_secويُنفَّذ في كل مسار من الحلقة. - يُفحص عمر اللقطة قبل أي تنبيه، وفي دفاتر الأوامر يُفحص أيضًا
staleوorder_delta.status. - «لا بيانات» و«لا أزواج» حالتان منفصلتان، وثلاث دورات بلا بيانات تُطلق رسالة عطل.
- تُفحص
nullمقابلNone، والمقامات مقابل الصفر، ويُتعامل مع الوقت بتوقيت UTC. - يجتاز الزوج بسبريده عند أفضل الأسعار، وبعقد مشترك، وبـ
withdraw_enabled_buyوdeposit_enabled_sell. - الكود يدرج الأرقام في الرسائل، والنص الخارجي يصل النموذج كبيانات، وإنسان يؤكد كل أمر.
ختام الدورة: إلى أين بعد ذلك
للدورة خمسة دروس: المفاهيم، وأول طلب، والبيانات للقرارات، ومراقب Python ومخاطره؛ والأساسيات في الدرس 1. تفاصيل كل خطوة:
- بداية سريعة مع Genesis API: المفتاح وأول طلب؛
- حدود Genesis API: الحصة وتحديد خطة لبوتك؛
- ردود Genesis API وأخطاؤه: الرموز و
ETagوX-Request-Id؛ - نقاط نهاية دفتر الأوامر: Order-book Δ لحجمك؛
- بوت أربيتراج العملات الرقمية بلغة Python: بوت بتنبيهات Telegram؛
- API العملات الرقمية: الأنواع وكيف تختار: نظرة عامة على مصادر البيانات.
جرّبها بنفسك
اعرف حداثة خطتك
استدعِ
/account/usageودوّنfreshness_secوcalls_used: هذا الطلب لا يُحتسب استدعاءً.قس عمر اللقطة
اجلب
/arbitrage/spot-spotعبرfetch، واطبعtime.time() - meta["updated_at"]وقارنه بالعتبة 3 ×freshness_sec.قارن سبريدين
اطبع
spread_pctوquote_spread(row)لخمسة صفوف، وعُدّ كم زوجًا يبقى موجبًا عند أفضل الأسعار.اختبر مسار الخطأ
شغّل البوت بالقيمة البديلة
GENESIS_API_KEY=gns_live_XXXXXXXXXXXXXXXX: يجب أن يوقفه الرد401 invalid_keyبرسالة واضحة.راجع قائمة الفحص
أضف كل ما ينقص كودك قبل تشغيل البوت على مدار الساعة.