API دفتر أوامر العملات الرقمية: العمق وسعر التنفيذ والانزلاق بين المنصات
باختصار
- يعيد API دفتر الأوامر مستويات الشراء والبيع، أي السعر والحجم عند كل مستوى، على شكل لقطة REST أو تدفق WebSocket للتغييرات. أفضل سعر شراء وبيع يصفان الدولارات الأولى من الصفقة فقط.
- العمق هو ما يحدد سعر الأمر الكبير. في مثال افتراضي يمرّ أمر شراء بقيمة 10,000$ عبر خمسة مستويات، فيقع متوسط سعره أعلى من منتصف الدفتر بـ 25 نقطة أساس، ويتقلص الفرق بين المنصتين من 1.20% إلى 0.70%.
- في خطتي Pro وMax يعيد Genesis API أسعار تنفيذ جاهزة من 500$ إلى 10,000$، وΔ دفتر الأوامر لصفوف المراجحة، وعمر الدفتر وعمقه، وسجل الانزلاق، وسلّم انزلاق DEX. REST فقط؛ والدفاتر متأخرة عن المنصة بمقدار 5–20 ثانية.
يعيد API دفتر أوامر العملات الرقمية أوامر الشراء والبيع الحالية لزوج تداول، مجمّعة حسب مستوى السعر: لكل مستوى سعر والحجم المنتظر عنده. من هذه المستويات تحسب سعر تنفيذ أمر بحجم معين، وانزلاقه، وعمق السوق، ومن دفتري منصتين تحسب كم من الفرق يبقى بعد صفقة فعلية.
تقدّم المنصة دفترها بنفسها على شكل لقطة REST أو تدفق WebSocket، أما Genesis API في خطتي Pro وMax فيقدّم أسعار تنفيذ جاهزة وعمقاً وΔ دفتر الأوامر لكثير من المنصات دفعة واحدة.
ما الذي يعيده API دفتر الأوامر
دفتر الأوامر هو قائمة أوامر الحد المنتظرة لزوج واحد. أوامر الشراء (bids) مرتبة من أعلى سعر إلى أدنى، وأوامر البيع (asks) من أدنى سعر إلى أعلى. المستوى هو سعر واحد وإجمالي الحجم عنده؛ والفجوة بين أفضل ask وأفضل bid هي السبريد في الدفتر.
لقطة REST هي الاستجابة لطلب واحد: المستويات في تلك اللحظة. نقطة نهاية دفتر الأوامر في Binance عامة ولا تحتاج مفتاح API؛ إليك طلب لأعلى خمسة مستويات في BTC/USDT واستجابة له (الأرقام افتراضية):
curl "https://api.binance.com/api/v3/depth?symbol=BTCUSDT&limit=5"
{
"lastUpdateId": 81273645120,
"bids": [["96015.90000000", "1.25000000"], …],
"asks": [["96016.00000000", "0.84100000"], …]
}
يصل كل مستوى على شكل زوج من النصوص [السعر، الكمية]، والكمية بالعملات: أفضل bid يحمل 1.25 × 96,015.9 = 120,019.88$. القيمة الافتراضية للمعامل limit هي 100، ويصل حتى 5,000 مستوى لكل جانب (وثائق Binance).
يُدفع تدفق WebSocket من المنصة عبر اتصال دائم. لدى Binance نوعان من تدفقات الدفتر: btcusdt@depth5 وbtcusdt@depth10 وbtcusdt@depth20 تدفع أعلى 5 أو 10 أو 20 مستوى، بينما btcusdt@depth يدفع التغييرات فقط. كلاهما يتحدث كل 1000 مللي ثانية، أو كل 100 مللي ثانية مع اللاحقة @100ms (تدفقات WebSocket في Binance).
يُبنى دفتر محلي كامل من لقطة زائد تدفق الفروقات، بمطابقة lastUpdateId الخاص باللقطة مع معرّفات تحديث الأحداث؛ وإذا فاتك حدث يُعاد بناء الدفتر من الصفر.
| الطريقة | ما تحصل عليه | الاستخدام |
|---|---|---|
| لقطة REST | المستويات وقت الطلب، حتى 5,000 لكل جانب في Binance | فحوص لمرة واحدة، استطلاع غير متكرر |
| تدفق WebSocket | أعلى المستويات أو التغييرات كل 100–1000 مللي ثانية | دفتر محلي في الذاكرة، بوت تداول |
| Genesis API عبر REST | المستويات بصيغة [السعر، المبلغ بالدولار] وسعر التنفيذ والعمق وعمر الدفتر | مقارنة المنصات، فحص التركيبة |
لماذا يضلل أفضل سعر شراء وبيع عند الأحجام الكبيرة
أفضل ask هو سعر المستوى الأول فقط. أمر شراء بسعر السوق أكبر من هذا المستوى يأخذ المستويات التالية الأغلى، فيرتفع متوسط سعر التنفيذ، وهذا هو الانزلاق.
مثال افتراضي: الرمز ABC في المنصة A، أفضل bid 0.9996، أفضل ask 1.0004، منتصف الدفتر 1.0000. أمر شراء بسعر السوق بقيمة 10,000$ يمرّ عبر خمسة مستويات ask:
| سعر ask | في الدفتر، $ | المأخوذ، $ | العملات |
|---|---|---|---|
| 1.0004 | 1,100 | 1,100 | 1,099.56 |
| 1.0010 | 1,400 | 1,400 | 1,398.60 |
| 1.0018 | 2,600 | 2,600 | 2,595.33 |
| 1.0030 | 3,000 | 3,000 | 2,991.03 |
| 1.0050 | 6,000 | 1,900 | 1,890.55 |
يشتري الأمر 9,975.07 عملة في المجموع. متوسط سعر التنفيذ هو VWAP، أي المتوسط المرجّح بالحجم: 10,000 / 9,975.07 ≈ 1.0025.
الانزلاق عن أفضل ask: (1.0025 − 1.0004) / 1.0004 × 100 ≈ 0.21%. وعن منتصف الدفتر: (1.0025 − 1.0000) / 1.0000 × 10,000 = 25 نقطة أساس. أربع منها نصف سبريد الدفتر، يدفعه كل أمر شراء بسعر السوق؛ والـ 21 الباقية سببها العمق.
عمق السوق ضمن ±X% والجدران
عمق السوق هو إجمالي حجم الأوامر ضمن مسافة معينة من أفضل سعر. في المثال، مجموع أوامر ask ضمن +0.2% من الأفضل، حتى 1.0024، هو 1,100 + 1,400 + 2,600 = 5,100$، وضمن +0.5%، حتى 1.0054، هو 14,100$.
اقرأ العمق كسعة: الأمر الأكبر من العمق ضمن +0.2% سيُنفَّذ عند مستويات خلف هذا الحد. في المنصة A يتسع أمر شراء بقيمة 5,000$ داخله، ولا يتسع أمر بقيمة 10,000$.
الجدار أمر كبير عند مستوى واحد، أكبر بوضوح من جيرانه: 6,000$ عند 1.0050 في المثال. ما دام الجدار قائماً فهو يثبّت السعر، لكن يمكن سحبه قبل وصول أمرك إليه بثانية، فيُنفَّذ الشراء عندئذ عند المستويات التي خلفه.
في Genesis API يأتي العمق من /orderbooks/book، وهو دفتر سوق واحد، ومن /orderbooks/coin/{coin}، وهو دفاتر عملة في كل المنصات والأسواق دفعة واحدة (دفتر أوامر السوق، دفاتر أوامر العملة). تحمل الاستجابة أعلى 10 مستويات bids وasks بصيغة [السعر، المبلغ بالدولار]، وأكبر الجدران في walls_bid وwalls_ask، وعمق الجانب كله ضمن ±50% من أفضل سعر في depth_bid_usd وdepth_ask_usd. نطاق ±50% واسع، لذا لحجم محدد انظر إلى المستويات أو إلى سعر التنفيذ الجاهز.
عمر الدفتر: الدفاتر القديمة والعمق المحدود
لكل لقطة دفتر عمر. إذا كان دفتر منصة أقدم من دفتر الأخرى بـ 15 ثانية، فقد يكون جزء من الفرق بينهما فجوة زمنية: السعر في الدفتر الأقدم تحرك بالفعل.
في Genesis API تتأخر الدفاتر عن المنصة بمقدار 5–20 ثانية، ويحمل كل دفتر عمره. بداية استجابة /orderbooks/book من الوثائق:
{
"exchange": "Binance",
"market": "spot",
"coin": "BTC",
"book_ts": 1794675858,
"age_sec": 6,
"stale": false,
"source": "ws",
"depth_limited": false,
"levels_bid": 500,
"levels_ask": 500,
…
}
book_ts هو وقت الدفتر بثواني unix، وage_sec عمره بالثواني، وstale: true يعلّم الدفتر الأقدم من 30 ثانية. يبيّن source كيف أُخذ الدفتر من المنصة: عبر WebSocket (ws) أو بطلبات REST (rest).
depth_limited: true يعني أن المنصة تنشر عمقاً محدوداً: الإجماليات جزئية، وقد لا يُنفَّذ الأمر الكبير بالكامل. عندما تنفد الأوامر يعيد /orderbooks/exec القيمة null بدل السعر، ويعيد Δ دفتر الأوامر الحالة exhausted.
الفرق القابل للتنفيذ بين المنصات: Δ دفتر الأوامر
نعود إلى المثال الافتراضي. في المنصة B كانت آخر صفقة عند 1.0120، وأفضل bid 1.0116 وask 1.0124. تحمل bids في B ما يلي: 1,100$ عند 1.0116، و1,300$ عند 1.0110، و2,800$ عند 1.0102، و2,900$ عند 1.0090، و5,000$ عند 1.0070.
بيع 10,000$ في هذه الـ bids يعطي VWAP يساوي 1.0095 بالصيغة نفسها. وهذا (1.0120 − 1.0095) / 1.0120 × 10,000 ≈ 24.7 نقطة أساس تحت منتصف دفتر B.
| كيف يُحسب الفرق | شراء في A ← بيع في B | الفرق |
|---|---|---|
| آخر الصفقات، كما في صف الجدول | 1.0000 ← 1.0120 | 1.20% |
| أفضل أسعار الدفتر | 1.0004 ← 1.0116 | 1.12% |
| بعد تنفيذ 10,000$ | 1.0025 ← 1.0095 | 0.70% |
فرق الصف: (1.0120 − 1.0000) / 1.0000 × 100 = 1.20%. بعد التنفيذ: (1.0095 − 1.0025) / 1.0025 × 100 ≈ 0.70%. يَعِد الصف بـ 120$ على 10,000$، ويبقى بعد الدفاتر نحو 70$: 10,000 × 0.006983 ≈ 69.83.
من الـ 50 نقطة أساس الضائعة ذهبت 8 إلى الفجوة بين آخر صفقة وأفضل الأوامر، والـ 42 الباقية إلى عمق الدفترين.
Δ دفتر الأوامر هو ما تسميه Genesis Arbitrage فرق الصف المعاد حسابه عبر دفاتر الأوامر لحجم معين؛ وفي الموقع هو عمود «Δ حسب الأوامر» في جداول المراجحة، مثلاً سبوت – فيوتشرز. وفي الـ API يأتي من /orderbooks/spreads/{dataset}: كل صف لعملة واحدة في مجموعة البيانات spot-spot أو spot-futures أو futures-futures أو dex-spot أو dex-futures يحصل على كائن order_delta (Δ دفتر الأوامر).
يحمل order_delta السعرين buy_price وsell_price للحجم المختار، وspread_pct بعد التنفيذ، وstatus: ok أو no_book (لا دفتر) أو exhausted (لم يمتلئ الدفتر). قيمة volume هي 0 (أفضل أسعار الدفتر) أو 500 أو 1000 أو 2500 أو 5000 أو 10000، ولا تتجاوز النتيجة أبداً فرق الصف. وتحمل صفوف DEX بدل زوج الأسعار الحقلين side وcex_price: جانب CEX وسعر تنفيذه.
أما أسعار التنفيذ نفسها، لكل الأسواق دفعة واحدة، فتأتي من /orderbooks/exec: زوج [سعر الشراء، سعر البيع] تحت مفتاح مثل Binance|spot|BTC، مع null حيث الدفتر ضعيف السيولة (أسعار التنفيذ).
الإعداد الكامل، مع نقل العملة وفحص الشبكات، مشروح في مراجحة العملات الرقمية بين المنصات.
مثال بلغة Python: فرق الصف مقابل الفرق بعد التنفيذ
يأخذ السكربت تركيبات Spot – Spot بفرق لا يقل عن 0.5%، ويطلب Δ دفتر الأوامر بقيمة 5,000$ لأوسع عشر عملات فرقاً، ويطبع كم نقطة أساس أكلتها الدفاتر. يأتي المفتاح من متغير البيئة GENESIS_API_KEY. عند 429 و503 ينتظر السكربت Retry-After ثانية، وإذا كان الانتظار أطول من دقيقة — أي أن الحصة الشهرية استُنفدت — يتوقف.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
VOLUME = 5000 # دولار لكل ساق
MIN_SPREAD = 0.5 # فرق الصف، %
def get(path, params):
for _ in range(3):
r = requests.get(BASE + path, headers=HEADERS,
params=params, timeout=15)
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # الحصة الشهرية استُنفدت
break
time.sleep(wait)
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("لم يستجب API، حاول لاحقاً")
rows = get("/arbitrage/spot-spot", {"min_spread": MIN_SPREAD})
rows.sort(key=lambda x: x["spread_pct"], reverse=True)
coins = list(dict.fromkeys(x["coin"] for x in rows))[:10]
for coin in coins:
data = get("/orderbooks/spreads/spot-spot",
{"coin": coin, "volume": VOLUME})
for row in data:
od = row["order_delta"]
if row["spread_pct"] < MIN_SPREAD or od["status"] != "ok":
continue # no_book أو exhausted: الحجم لن يُنفَّذ
lost = (row["spread_pct"] - od["spread_pct"]) * 100
print(f'{coin} {row["exchange_buy"]}→{row["exchange_sell"]}'
f' {row["spread_pct"]:.2f}% → {od["spread_pct"]:.2f}%,'
f' الدفاتر أكلت {lost:.0f} نقطة أساس')
time.sleep(0.25) # حتى 4 طلبات في الثانية: Pro يسمح بـ 5
ينفّذ السكربت حتى 11 استدعاءً مع توقف 0.25 ثانية بين العملات. شغّله في حلقة بوتيرة لا تزيد على meta.freshness_sec: 10 ثوانٍ في Pro و5 في Max (حدود Genesis API). لإضافة إشعارات إليه راجع بوت مراجحة العملات الرقمية بلغة Python.
سجل تكلفة التنفيذ
لقطة واحدة لا تخبرك هل الانزلاق الحالي طبيعي للسوق أم أن الدفتر أرق من المعتاد. يعيد /orderbooks/exec-history السجل من Genesis Charts: كم نقطة أساس عن منتصف الدفتر كلّف تنفيذ 500$ و1,000$ و2,500$ و5,000$ و10,000$، بشكل منفصل للشراء والبيع (سجل التنفيذ).
لكل فترة 360 نقطة: 1m تغطي 6 ساعات، و15m 3.75 أيام، و1h 15 يوماً، و1d نحو سنة، والبيانات منذ 6 سبتمبر 2026. يقبل الطلب حتى 8 أسواق في المعامل keys. قيم الشراء موجبة وقيم البيع سالبة؛ وnull يعني لا بيانات أو أن الدفتر لم يمتلئ. لا يقدّم Genesis API لقطات سابقة للدفتر نفسه.
import os
import statistics
import requests
KEY = "Binance|spot|BTC"
r = requests.get(
"https://api.genesisarbitrage.com/v1/orderbooks/exec-history",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"keys": KEY, "interval": "1h"}, # 360 ساعة، 15 يوماً
timeout=15,
)
r.raise_for_status()
data = r.json()["data"]
series = data["series"][KEY]
if series is None:
raise SystemExit("السوق غير موجود: " + KEY)
i = data["volumes_usd"].index(10000) # سلسلة شراء 10,000$
buy = series["buy"][i]
known = [x for x in buy if x is not None]
if not known:
raise SystemExit("لا بيانات للفترة")
print("الوسيط لـ 15 يوماً، نقطة أساس:", statistics.median(known))
print("آخر نقطة، نقطة أساس:", buy[-1])
افتراضياً، إذا كان وسيط 15 يوماً 12 نقطة أساس وآخر نقطة 25، فالتنفيذ الآن يكلّف ضعف المعتاد، ويكون من المنطقي رفع حد الفرق لهذه العملة.
DEX: سلّم الانزلاق وضرائب الرموز وhoneypot
مجمع DEX ليس له دفتر أوامر: سعر المبادلة يأتي من صيغة المجمع، وكلما كبرت الصفقة بالنسبة إلى السيولة ابتعد السعر أكثر. لذلك تُقيَّم ساق DEX بسلّم — الانزلاق عند سلسلة من الأحجام.
يعيد /orderbooks/dex-slippage لكل عقد انزلاق الشراء والبيع عند 100$ و500$ و1,000$ و2,500$ و5,000$ و10,000$ و20,000$ و50,000$ و100,000$، وضرائب الرمز وعلم honeypot، وهي أعمدة جدول DEX نفسها في الموقع (انزلاق DEX). في الاستجابة النموذجية بالوثائق، انزلاق الشراء 0.86% عند 10,000$ و3.12% عند 50,000$ و6.05% عند 100,000$.
هذا يحدد سقف التركيبة: فرق DEX – CEX بنسبة 2% يصمد أمام انزلاق المجمع عند 10,000$ لكنه لا يصمد عند 50,000$، حتى قبل الرسوم. القيمة null في السلّم تعني أن المجمع تنقصه السيولة لذلك الحجم، وغاز الشبكة غير موجود في الاستجابة، فاحسبه بشكل منفصل.
tax_buy_pct وtax_sell_pct هما ضريبة شراء الرمز وبيعه بالنسبة المئوية؛ وnull تعني عدم وجود مصدر ولا يجوز قراءتها كصفر. honeypot: no — لا علامات، وsuspect — المصادر مختلفة، وyes — قد يكون بيع الرمز مستحيلاً.
لفحص رمز يدوياً راجع كيف تفحص رمزاً قبل الشراء؛ ولأسعار DEX وسيولته إلى جانب CEX راجع DEX API.
دفاتر الأوامر في Genesis API: نقاط النهاية والخطط
| المهمة | نقطة النهاية |
|---|---|
| سعر التنفيذ من 500$ إلى 10,000$ في كل سوق | /orderbooks/exec |
| فرق الصف بعد التنفيذ | /orderbooks/spreads/{dataset} |
| 10 مستويات وجدران وعمق وعمر الدفتر | /orderbooks/book |
| دفاتر عملة في كل المنصات | /orderbooks/coin/{coin} |
| سجل تكلفة التنفيذ | /orderbooks/exec-history |
| انزلاق DEX والضرائب وعلم honeypot | /orderbooks/dex-slippage |
الست كلها ضمن خطط API Pro وMax. تكلفة Pro 100$ شهرياً: 5 ملايين استدعاء، و5 طلبات في الثانية، وحداثة 10 ثوانٍ. وMax 200$: 10 ملايين استدعاء، و15 طلباً في الثانية، و5 ثوانٍ؛ وفي Trial وStart تعيد نقاط نهاية دفتر الأوامر 403 plan_restricted.
المعاملات وأمثلة الاستجابات في دليل نقاط نهاية دفتر الأوامر؛ ولنظرة عامة على بيانات الـ API راجع API العملات الرقمية والدرس بيانات API للمراجحة.
أسئلة وأجوبة
لماذا الفرق في الجدول أكبر مما أحصل عليه في الصفقة؟
فرق الصف يأتي من آخر الصفقات، بينما يُنفَّذ أمر السوق مقابل الدفتر، وكلما كبر الحجم ابتعد متوسط سعره عن الأفضل. وتُضاف الرسوم وحركة السعر أثناء النقل. يبيّن Δ دفتر الأوامر كم يبقى من الفرق عند حجمك.
كل كم يتحدث دفتر الأوامر؟
يتغير الدفتر مع كل أمر جديد وإلغاء؛ وتدفق Binance يدفع التغييرات كل 100 أو 1000 مللي ثانية. في Genesis API تتأخر الدفاتر عن المنصة بمقدار 5–20 ثانية (العمر في age_sec)، وتتجدد الاستجابات كل 10 ثوانٍ في Pro وكل 5 ثوانٍ في Max.
هل لدى Genesis API واجهة WebSocket لدفاتر الأوامر؟
لا. Genesis API هو REST فقط: طلب HTTP GET واستجابة JSON. تدفقات الدفاتر في الزمن الحقيقي تأتي من WebSocket الخاص بالمنصات، وهذا ما يحتاجه بوت يضع الأوامر عبر API التداول في المنصة.
هل يوجد API مجاني لدفتر الأوامر؟
للمنصات نقاط نهاية عامة: دفتر Binance في /api/v3/depth يجيب بلا مفتاح، لكنه يغطي منصة واحدة، وتحسب سعر التنفيذ بنفسك. ليس في Genesis API خطة مجانية؛ دفاتر الأوامر مشمولة في Pro بسعر 100$ شهرياً وMax بسعر 200$.