نقاط نهاية دفتر الأوامر في Genesis API: سعر التنفيذ وΔ دفتر الأوامر والدفتر والسجل وDEX
باختصار
- ست نقاط نهاية لدفتر الأوامر في خطتي API Pro وMax تعيد البيانات نفسها التي يعرضها الموقع في عمود «Δ حسب الأوامر» ونافذة «دفتر الأوامر» وفي Genesis Charts.
- سعر التنفيذ هو متوسط سعر صفقة سوقية بقيمة 500 $ أو 1,000 $ أو 2,500 $ أو 5,000 $ أو 10,000 $؛ و
nullيعني أن الدفتر ضعيف السيولة لهذا الحجم. - تتأخر الدفاتر عن المنصة بمقدار 5–20 ثانية: تحقق من
age_secوstale، وانظر إلى الدفتر في منصة التداول قبل أن تنفّذ الصفقة.
API دفتر الأوامر في Genesis API هو ست نقاط نهاية توضح ما يبقى من السبريد عند صفقة بحجم معيّن. تعيد أسعار التنفيذ لحجم محدد، وΔ دفتر الأوامر لصفوف المراجحة، ودفتر الأوامر مع عمقه، وسجل الانزلاق، وانزلاق DEX — وهي البيانات نفسها الموجودة في عمود «Δ حسب الأوامر» وGenesis Charts على الموقع.
ست نقاط نهاية لدفتر الأوامر
| نقطة النهاية | ما تعيده | المطلوب | التوثيق |
|---|---|---|---|
/orderbooks/exec | سعرا الشراء والبيع لحجم معيّن في كل سوق | volume | أسعار التنفيذ |
/orderbooks/spreads/{dataset} | Δ دفتر الأوامر لصفوف عملة واحدة في مجموعة بيانات المراجحة | coin | Δ دفتر الأوامر |
/orderbooks/book | دفتر سوق واحد: 10 مستويات والجدران والعمق والعمر | exchange وmarket وcoin | دفتر أوامر السوق |
/orderbooks/coin/{coin} | دفاتر العملة في كل منصة وسوق | العملة في المسار | دفاتر أوامر العملة |
/orderbooks/exec-history | سجل الانزلاق، حتى 8 أسواق في الطلب | keys وinterval | سجل التنفيذ |
/orderbooks/dex-slippage | الانزلاق والضرائب وعلم honeypot لكل عقد | — | انزلاق DEX |
جميعها ضمن خطط API Pro (100 $ شهرياً) وMax (200 $)؛ وفي Trial وStart تعيد 403 plan_restricted. في /orderbooks/exec وفي معامل keys للسجل يُكتب السوق بالشكل Exchange|market|COIN، مثل Binance|spot|BTC. تعرض أمثلة الاستجابة أدناه الحقل data بعد اختصاره.
للاطلاع على نظرة عامة على بيانات دفتر الأوامر، اقرأ مقال API دفتر الأوامر.
سعر التنفيذ لحجم معيّن
سعر التنفيذ هو متوسط السعر الذي يمرّ به أمر سوقي بحجم معيّن عبر الدفتر: الشراء يأخذ طلبات البيع (asks) والبيع يضرب طلبات الشراء (bids)، فهو VWAP للأوامر التي تستهلكها الصفقة. تعيده /orderbooks/exec لكل سوق عند حجم واحد من الشبكة.
| المعامل | النوع | ما يفعله |
|---|---|---|
volume | رقم | الحجم بالدولار: 500 أو 1000 أو 2500 أو 5000 أو 10000، إلزامي |
exchange | نص | تصفية حسب المنصة؛ وبفواصل لعدة منصات |
market | نص | spot أو futures |
coin | نص | رمز العملة، مثل BTC |
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec?volume=1000" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"volume": 1000,
"markets": {
"Binance|spot|BTC": [96021.5, 96010.2],
"ByBit|futures|BTC": [96030.1, 96018.7],
"Ourbit|spot|SHELL": [0.10418, null],
…
}
}
قيمة كل مفتاح سوق هي [سعر الشراء, سعر البيع]. وnull بدل السعر يعني أن الدفتر ضعيف السيولة لهذا الحجم: في المثال لا تستوعب طلبات الشراء (bids) لعملة SHELL في Ourbit بيعاً بقيمة 1,000 $. من دون مرشحات تحتوي الاستجابة كل الأسواق، لذا مرّر coin عندما تحتاج عملة واحدة.
Δ دفتر الأوامر: السبريد بعد المرور عبر الدفتر
Δ دفتر الأوامر هو سبريد صف المراجحة بعد إعادة حسابه عبر دفاتر الأوامر لحجم معيّن. تأخذ /orderbooks/spreads/{dataset} كل صفوف عملة واحدة في مجموعة البيانات المختارة وتضيف إلى كل صف كائن order_delta، بالصيغ نفسها المستخدمة في العمود على الموقع.
| المعامل | النوع | ما يفعله |
|---|---|---|
{dataset} | نص، في المسار | spot-spot أو spot-futures أو futures-futures أو dex-spot أو dex-futures |
coin | نص | رمز العملة، إلزامي |
volume | رقم | 0 افتراضياً — أفضل أسعار الدفتر؛ أو 500 أو 1000 أو 2500 أو 5000 أو 10000 |
في أزواج CEX يمر الشراء عبر asks في exchange_buy ويمر البيع إلى bids في exchange_sell. يحمل order_delta الحقلين buy_price وsell_price، ولا تتجاوز النتيجة أبداً spread_pct للصف.
في صفوف DEX تحدد إشارة السبريد جانب CEX: عندما يكون spread_pct ≥ 0 يُباع الرمز في bids المنصة CEX، وعندما يكون سالباً يُشترى من asks. يحمل order_delta الحقلين side وcex_price، أي سعر التنفيذ على CEX؛ وإذا انعكست الإشارة بعد المرور عبر الدفتر فإن Δ يساوي 0.
الحقل status: ok — تم الحساب، no_book — لا يوجد دفتر، exhausted — لم يغطِّ الدفتر الحجم.
مثال افتراضي: العملة XYZ، شراء على MEXC بسعر 2.000 وبيع على Gate بسعر 2.016، وسبريد الصف 0.8%. طلب Δ دفتر الأوامر لحجم 5,000 $:
curl -G \
"https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-spot" \
-d coin=XYZ -d volume=5000 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"coin": "XYZ",
"exchange_buy": "MEXC",
"exchange_sell": "Gate",
"market_buy": "spot",
"market_sell": "spot",
"price_buy": 2.0,
"price_sell": 2.016,
"ask_buy": 2.001,
"bid_sell": 2.015,
"spread_pct": 0.8,
"order_delta": {
"volume": 5000,
"buy_price": 2.004,
"sell_price": 2.01,
"spread_pct": 0.2994,
"status": "ok"
}
}
باقي حقول الصف كما في /arbitrage/spot-spot. سبريد الصف: (2.016 − 2.000) / 2.000 × 100 = 0.8%.
عند 5,000 $ يبلغ متوسط الشراء عبر دفتر MEXC 2.004، ويحقق البيع في دفتر Gate سعر 2.010: (2.010 − 2.004) / 2.004 × 100 ≈ 0.2994%. من أصل 0.8% يبقى نحو 0.3% عند هذا الحجم — أي نحو 15 $ قبل الرسوم والتحويل: 5,000 × 0.002994 ≈ 14.97.
مثال Python: السبريد قبل الدفتر وبعده
يطبع السكربت سبريد الصف إلى جانب السبريد بعد الدفتر لعملة BTC في مجموعة Spot – Spot عند 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"]}
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):
# حد الطلبات أو إعادة بناء البيانات
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()["data"]
raise RuntimeError("واجهة API مشغولة، حاول لاحقاً")
rows = get("/orderbooks/spreads/spot-spot",
{"coin": "BTC", "volume": 5000})
for row in rows:
od = row["order_delta"]
if od["status"] == "ok":
after = f'{od["spread_pct"]:.4f}%'
else:
after = od["status"] # no_book أو exhausted
print(f'{row["exchange_buy"]} → {row["exchange_sell"]}: '
f'{row["spread_pct"]}% → {after}')
في الحلقة لا تستطلع أكثر من مرة كل meta.freshness_sec ثانية: 10 ثوانٍ في Pro و5 في Max. الحصة والحدود موضحة في دليل حدود Genesis API.
دفتر أوامر السوق ودفاتر أوامر العملة
تعيد /orderbooks/book دفتر سوق واحد، مثل نافذة «دفتر الأوامر» على الموقع. ثلاثة معاملات إلزامية تحدد السوق: exchange (غير حساس لحالة الأحرف) وmarket (spot أو futures) وcoin. وتعيد /orderbooks/coin/{coin} مصفوفة من الكائنات نفسها لكل منصة وسوق للعملة.
curl -G "https://api.genesisarbitrage.com/v1/orderbooks/book" \
-d exchange=Binance -d market=spot -d coin=BTC \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"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,
"best_bid": 96015.9,
"best_ask": 96016,
"bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
"asks": [[96016, 388120.2], [96016.1, 20410.7], …],
"walls_bid": [[95900, 2410000]],
"walls_ask": [[96500, 1980000]],
"depth_bid_usd": 61234567,
"depth_ask_usd": 58765432
}
| الحقل | المعنى |
|---|---|
best_bid وbest_ask | أفضل سعر شراء وبيع |
bids وasks | أعلى 10 مستويات: [السعر, المبلغ بالدولار] |
walls_bid وwalls_ask | أكبر الجدران: [السعر, المبلغ بالدولار] |
depth_bid_usd وdepth_ask_usd | عمق الجانب ضمن ±50% من أفضل سعر، بالدولار |
book_ts وage_sec وstale | وقت الدفتر وعمره بالثواني؛ وstale — أقدم من 30 ثانية |
source وdepth_limited | مصدر الدفتر (ws أو rest) وعلم العمق المحدود |
عمق السوق في depth_bid_usd وdepth_ask_usd هو عدد الدولارات من الأوامر على جانب واحد من الدفتر: في المثال نحو 58.8 مليون $ من asks لعملة BTC على Binance ضمن +50% من أفضل ask.
عندما يكون depth_limited: true تنشر المنصة دفتراً جزئياً، وقد لا يُملأ حجم كبير. وإذا لم يوجد دفتر لهذه المنصة والسوق والعملة فتحصل على 404.
سجل التنفيذ
/orderbooks/exec-history هي سجل الانزلاق من Genesis Charts: كم كلّف التنفيذ عند كل حجم في الشبكة، بنقاط الأساس من منتصف الدفتر (1 bp = 0.01%). يقبل الطلب الواحد حتى 8 أسواق في keys مفصولة بفواصل؛ وinterval إلزامي.
interval | خطوة النقطة | تغطي 360 نقطة |
|---|---|---|
1m | دقيقة واحدة | 6 ساعات |
15m | 15 دقيقة | 3.75 أيام |
1h | ساعة واحدة | 15 يوماً |
1d | يوم واحد | نحو سنة |
تُجمع البيانات منذ 6 سبتمبر 2026، لذلك لا تمتلئ السلسلة اليومية إلا من هذا التاريخ.
curl -G "https://api.genesisarbitrage.com/v1/orderbooks/exec-history" \
--data-urlencode "keys=Binance|spot|BTC,ByBit|futures|BTC" \
-d interval=1h \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"interval": "1h",
"step_sec": 3600,
"points": 360,
"volumes_usd": [500, 1000, 2500, 5000, 10000],
"last_bucket_ts": 1794672000,
"series": {
"Binance|spot|BTC": {
"buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …],
[3, 4, 6, …], [5, 7, 9, …]],
"sell": [[-1, -1, -2, …], …]
},
"ByBit|futures|BTC": { … }
}
}
يحتوي buy وsell كل منهما على خمس سلاسل، واحدة لكل حجم في volumes_usd، وفي كل سلسلة 360 قيمة من الأقدم إلى الأحدث. تعود النقطة الأخيرة إلى last_bucket_ts، والنقطة i إلى last_bucket_ts − (points − 1 − i) × step_sec. قيم الشراء موجبة وقيم البيع سالبة: متوسط سعر الصفقة أعلى من منتصف الدفتر وأدنى منه.
السلسلة [5, 7, 9, …] هي شراء بقيمة 10,000 $: تكلّف نقاطها الأولى 5–9 bp، أي 0.05–0.09% فوق المنتصف. وnull في السلسلة يعني عدم وجود بيانات أو أن الدفتر لم يمتلئ؛ وnull بدل كائن السوق يعني مفتاحاً غير معروف.
انزلاق DEX
تصف /orderbooks/dex-slippage ساق DEX في الصفقة: انزلاق الشراء والبيع من 100 $ إلى 100,000 $، وضرائب الرمز وعلم honeypot لكل عقد — مثل أعمدة جدول DEX على الموقع. المرشحات: contract (بفواصل لعدة عقود) وnetwork.
curl -G "https://api.genesisarbitrage.com/v1/orderbooks/dex-slippage" \
-d contract=0x6982508145454ce325ddbe47a25d4ec3d2311933 \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
{
"sizes_usd": [100, 500, 1000, 2500, 5000, 10000, 20000, 50000,
100000],
"contracts": [
{
"contract": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
"network": "ETH",
"tax_buy_pct": 0,
"tax_sell_pct": 0,
"honeypot": "no",
"slippage_buy_pct": [0.31, 0.33, 0.36, 0.44, 0.58, 0.86,
1.41, 3.12, 6.05],
"slippage_sell_pct": [0.31, 0.34, 0.37, 0.46, 0.61, 0.9,
1.5, 3.3, 6.4],
"updated_at": 1794671040
}
]
}
تتبع مصفوفات الانزلاق شبكة sizes_usd: في المثال ينزلق شراء بقيمة 5,000 $ بنسبة 0.58% وشراء بقيمة 100,000 $ بنسبة 6.05%. وnull في المصفوفة يعني أن المجمّع لا يملك سيولة كافية لهذا الحجم.
tax_buy_pct وtax_sell_pct هما ضريبة الشراء وضريبة البيع للرمز، بالنسبة المئوية؛ وnull يعني عدم وجود مصدر، لا 0%. honeypot: no؛ suspect — المصادر مختلفة؛ yes — قد يكون البيع مستحيلاً.
كيف تتحقق من صفقة بالدفاتر
خذ صف مراجحة
ابحث عن فرصة في
/arbitrage/spot-spotأو مجموعة بيانات أخرى — راجع نقاط نهاية المراجحة. دوّن العملة والمنصتين وspread_pct.أعد حساب السبريد عبر الدفاتر
اطلب
/orderbooks/spreads/spot-spotبهذه العملة وحجم صفقتك وقارنspread_pctمعorder_delta.spread_pct.تحقق من الحداثة والعمق
استدعِ
/orderbooks/bookللساقين: يخبركage_secوstaleوdepth_limitedهل تثق بالأرقام، وتُظهر الجدران أين قد يتوقف السعر.قارن بالسجل
يوضح
/orderbooks/exec-historyهل هذا الانزلاق طبيعي للسوق:1mتغطي 6 ساعات و1hتغطي 15 يوماً.تحقق من الضرائب في ساق DEX
في صفقات DEX – Spot وDEX – Futures اطلب
/orderbooks/dex-slippageلعقد الصف: الانزلاق والضرائب وhoneypot.
أسئلة وأجوبة
بماذا يختلف Δ دفتر الأوامر عن السبريد العادي؟
يستخدم spread_pct للصف آخر أسعار المنصات؛ أما Δ دفتر الأوامر فيستخدم متوسط أسعار الصفقات السوقية بالحجم المحدد. والفرق بينهما هو ما يأخذه الدفتر.
لماذا أحصل على null بدل السعر؟
في /orderbooks/exec تكون أوامر الدفتر أقل من اللازم لهذا الحجم؛ وفي Δ دفتر الأوامر تظهر الحالة نفسها كحالة exhausted. وفي سجل التنفيذ يعني null عدم وجود بيانات للنقطة، وفي انزلاق DEX يعني أن المجمّع يفتقر إلى السيولة.
هل يمكن حساب التنفيذ لأكثر من 10,000 $؟
شبكة /orderbooks/exec وΔ دفتر الأوامر ثابتة من 500 $ إلى 10,000 $. للأحجام الأكبر انظر إلى العمق والجدران في /orderbooks/book؛ وفي ساق DEX تصل /orderbooks/dex-slippage إلى 100,000 $.