API العملات الرقمية: أنواع واجهات بيانات السوق وكيف تختار واحدة للتداول
باختصار
- يمنح API العملات الرقمية كودك بيانات السوق: الأسعار ودفاتر الأوامر ومعدلات التمويل ومعاملات السلسلة وأسعار أسواق التنبؤ. API البورصة يغطي منصة واحدة ويستقبل الأوامر بمفتاح، أما API بيانات السوق فيدمج منصات كثيرة في صيغة واحدة.
- اختر الـ API وفق تسعة معايير: تغطية المنصات والسلاسل، وحداثة البيانات، وتوحيد الحقول، وحالة الإيداع والسحب، وعمق دفتر الأوامر، وحدود المعدل، والسعر، والتوثيق، وشروط استخدام البيانات.
- Genesis API هو REST API للقراءة فقط: CEX وDEX وأونتشين وأسواق التنبؤ وسيربيت المراهنات في صيغة JSON واحدة، بخطط من 20$ شهرياً. لا ينفّذ أوامر.
API العملات الرقمية هو واجهة برمجية يقرأ بها الكود بيانات سوق العملات الرقمية أو يرسل الأوامر إلى البورصة: الأسعار ودفاتر الأوامر ومعدلات التمويل ومعاملات البلوكتشين وأسعار أسواق التنبؤ. تختلف أنواع API في النطاق: API البورصة يعرف منصة واحدة ويستقبل الأوامر بمفتاح، وAPI بيانات السوق يدمج منصات كثيرة في صيغة واحدة، وAPI أونتشين يقرأ البلوكتشين.
أنواع API العملات الرقمية
| نوع API | ماذا يعطي | متى تحتاجه |
|---|---|---|
| API البورصة | أسعار منصة واحدة ودفاتر أوامرها وصفقاتها؛ والأوامر بمفتاح | التداول على تلك البورصة، وتدفق صفقات زوج |
| API بيانات السوق | منصات كثيرة في صيغة واحدة، وسبريدات جاهزة | مقارنة البورصات والماسحات والتنبيهات |
| API أونتشين | المعاملات والتحويلات والأرصدة وأحداث العقود | الحيتان وتدفقات البورصات وفك القفل |
| API DEX | أسعار المجمّعات والسيولة والمبادلات والانزلاق | الرموز غير المدرجة على CEX، وصفقات DEX – CEX |
| بيانات المشتقات | التمويل والفائدة المفتوحة وأسعار العقود الآجلة | أربيتراج التمويل وانحياز المراكز |
| API أسواق التنبؤ والاحتمالات | أسعار YES وNO ودفاتر الأوامر واحتمالات شركات المراهنات | أربيتراج أسواق التنبؤ وسيربيت المراهنات |
API البورصات
API بورصة العملات الرقمية هو واجهة منصة واحدة، وله جزءان. الجزء العام يقدّم بيانات السوق بلا مفتاح: في Binance تحمل هذه نقاط النهاية نوع الأمان NONE، والطلب GET /api/v3/ticker/price يعيد سعر زوج. أما الجزء الخاص — الأوامر والأرصدة وسجل الصفقات — فيحتاج مفتاح API وتوقيع الطلب؛ وفي Binance هي الأنواع TRADE وUSER_DATA (وثائق Binance).
يغطي هذا API بورصة واحدة: لمقارنة سعر عملة على 20 بورصة تحتاج 20 اتصالاً بصيغ وحدود مختلفة.
API بيانات السوق
يجمع API بيانات السوق البيانات من بورصات كثيرة ويوحّدها ويعيدها في طلب واحد. الاستجابة تحتوي أصلاً على ما يتطلبه دمج المنصات: سبريدات بين البورصات، ومعدلات تمويل موحّدة على فترة واحدة، والفائدة المفتوحة حسب البورصة.
API أونتشين
يقرأ API أونتشين البلوكتشين: المعاملات وتحويلات الرموز وأرصدة العناوين وأحداث العقود الذكية. الطبقة السفلى هي عقدة الشبكة: كل عميل Ethereum يتحدث JSON-RPC، حيث يعيد eth_getBalance الرصيد بوحدة wei كرقم سداسي عشري، ويعيد eth_getLogs أحداث العقود المطابقة لمرشّح.
العقدة لا تعرف أي العناوين تخص بورصة أو فريقاً أو حوتاً؛ هذه الوسوم تضيفها الفهارس وخدمات تحليلات أونتشين. أي البيانات يحتاجها المتداول — في API بيانات أونتشين.
API لـ DEX
يقدّم API لـ DEX أسعار المجمّعات والسيولة على البورصات اللامركزية والمبادلات والانزلاق. كلما كبر المبادلة قياساً بسيولة المجمّع حرّكت السعر أكثر، لذا يحتاج نمط DEX – CEX إلى الانزلاق لحجمك، وتحتاج الرموز الجديدة إلى ضريبة الرمز وفحص هانيبوت. التفاصيل في API لـ DEX.
بيانات المشتقات: التمويل والفائدة المفتوحة
تتطلب العقود الدائمة معدل التمويل والفائدة المفتوحة (حجم المراكز المفتوحة) وسعر العقد الآجل إلى جانب السبوت. تسوّي البورصات التمويل كل 8 أو 4 أو ساعة واحدة، لذا تُقارن المعدلات بعد توحيدها على فترة واحدة. التفاصيل في API معدل التمويل وAPI الفائدة المفتوحة.
API أسواق التنبؤ والاحتمالات
تقدّم منصات التنبؤ أسعار عقود YES وNO ودفاتر الأوامر. في Polymarket لا تحتاج بيانات السوق العامة إلى بيانات اعتماد، بينما يتطلب الأمر مصادقة وتوقيع محفظة (وثائق Polymarket).
الصيغ هنا تختلف أيضاً: دفتر أوامر Kalshi يحتوي العروض الشرائية فقط، وسعر YES البيعي يساوي 1$ ناقص أفضل عرض شراء لـ NO، فعرض شراء NO بسعر 0.56$ يعني سعر بيع YES بـ 0.44$ (وثائق Kalshi). تُقارن احتمالات شركات المراهنات بأسعار YES وNO عبر الاحتمال الضمني — راجع Polymarket API وKalshi API وAPI احتمالات الرياضة.
REST وWebSocket
يجيب REST API عن الطلب بلقطة مرشّحة وفق طلبك، وتحصل على التحديثات بـالاستعلام الدوري وفق جدول.
يُبقي WebSocket الاتصال مفتوحاً، ويدفع الخادم كل صفقة وكل تغيير في دفتر الأوامر. في المقابل عليك معالجة التدفق دون فجوات، وإعادة الاتصال بعد الانقطاع، وإعادة بناء الدفتر من لقطة مع تحديثات، كما يشترط Kalshi المصادقة للاتصال حتى بالقنوات العامة. الاستجابة في أجزاء من الثانية تتطلب WebSocket؛ أما الماسحات والتنبيهات على 20+ بورصة فتعمل عبر REST.
Genesis API هو REST فقط، بلا WebSocket وبلا ويب هوكس: كل طلب هو GET، والاستجابات مضغوطة بـ gzip بصيغة JSON، وتتحدّث البيانات كل meta.freshness_sec ثانية. إعادة طلب المجموعة الكاملة بلا فلاتر مع ETag السابق في If-None-Match تعيد 304 بلا جسم إن لم يتغير شيء، ولا تستهلك هذه الاستجابة من الحصة. أنماط الاستعلام الدوري في أفضل ممارسات الاستعلام الدوري للـ API.
كيف تختار API للعملات الرقمية: قائمة المعايير
المعايير الستة الأولى تظهر في استجابة API حية؛ والباقي في الوثائق والأسعار.
| المعيار | ما الذي تتحقق منه |
|---|---|
| تغطية المنصات والسلاسل | بورصاتك، والسبوت والعقود الآجلة، وDEX والسلاسل |
| الحداثة والتأخير | وقت بناء اللقطة في الاستجابة، وخطوة التحديث، وعمر دفتر الأوامر |
| توحيد الحقول | رموز وحدات ونسب مئوية ووقت متسقة |
| حالة الإيداع والسحب | علامات الإيداع والسحب لكل بورصة وشبكة |
| عمق دفتر الأوامر | سعر التنفيذ لحجمك |
| حدود المعدل والحصص | الطلبات في الثانية، والاستدعاءات في الفترة، وما يُحسب استدعاءً |
| السعر | خطة أم دفع لكل استدعاء، وماذا يحدث عند تجاوز الحد |
| الوثائق وOpenAPI | أمثلة للطلب والاستجابة، ومواصفة |
| شروط استخدام البيانات | هل يمكنك بناء منتجك الخاص على البيانات |
التغطية والحداثة
تحقق من التغطية على قائمتك أنت: إذا كان بوتك يعمل مع MEXC وGate فلن يناسبك API يفتقد إحداهما. حداثة البيانات هي عدد الثواني منذ بناء اللقطة؛ والتأخير هو المسار كله من الصفقة في البورصة إلى كودك. على لقطة عمرها دقيقة يرى البوت سبريدات اختفت أصلاً.
توحيد الحقول
الزوج BTC/USDT نفسه يُكتب بصيغ مختلفة في APIs البورصات: BTCUSDT في Binance، وBTC-USDT في OKX (والعقد الدائم BTC-USDT-SWAP)، وBTC_USDT في Gate. يعيد Binance الأسعار نصوصاً ("price": "4.00000200" في مثال وثائقه) والوقت بالميلي ثانية. على كودك أن يعالج كل فرق من هذه الفروق.
يوحّد API بيانات السوق الحقول في شكل واحد، كما في هذا العنصر من /funding/rates من وثائق Genesis API:
{
"coin": "TON",
"exchanges": [
{
"exchange": "MEXC",
"funding_pct": 0.02,
"funding_8h_pct": 0.04,
"next_payout": "00:00",
"interval": "4h",
"price": 2.184,
"trade_url": "https://futures.mexc.com/exchange/TON_USDT"
}
]
}
تسوّي MEXC التمويل لهذه العملة كل 4 ساعات، ويُوحَّد المعدل 0.02% للفترة إلى 8 ساعات في funding_8h_pct: 0.02 × 8 / 4 = 0.04% (راجع معدلات التمويل).
حالة الإيداع والسحب
الصفقة بين بورصتين على السبوت قابلة للتنفيذ فقط إذا أمكن سحب العملة من بورصة الشراء وإيداعها في بورصة البيع. في Binance تأتي حالات الشبكات من GET /sapi/v1/capital/config/getall، وهي نقطة USER_DATA موقّعة تحتاج مفتاح API لحسابك (وثائق Binance). في Genesis API تصل الحالات في كل صف Spot – Spot بالحقلين withdraw_enabled_buy وdeposit_enabled_sell (وثائق Spot — Spot).
عمق دفتر الأوامر
سبريد أفضل سعر يُظهر الفجوة في أعلى الدفتر، بينما تعبر صفقة بـ 5,000$ عدة مستويات من عمق السوق. في مثال وثائق Genesis API لـ /orderbooks/spreads/spot-futures يبلغ سبريد BTC 0.031% عند أفضل الأسعار و0.0202% بعد عبور الدفاتر لـ 5,000$. تعيد نقطة أسعار التنفيذ أسعار التنفيذ لمبالغ 500–10,000$؛ المزيد في API دفتر أوامر العملات الرقمية.
الحدود والسعر والتوثيق
تُحسب الحدود بطرق مختلفة. في Binance لكل نقطة نهاية وزن، والطلبات على رموز كثيرة أثقل، ويُحظر عنوان IP الذي يواصل الإرسال بعد 429 من دقيقتين إلى 3 أيام (حدود Binance). في API للبيانات تحقق من حصة الاستدعاءات وحد المعدل في الثانية وما يُحسب استدعاءً: في Genesis API لا تستهلك الحصة إلا استجابة 200.
التسعير إما خطة بحصة أو دفع لكل استدعاء؛ اعرف ما يحدث عند تجاوز الحد — خطأ 429 أم رسوم إضافية. مواصفة OpenAPI وصف مقروء آلياً للـ API لتوليد عميل وربط وكلاء الذكاء الاصطناعي، وتخبرك شروط الاستخدام هل يمكنك بناء منتج على البيانات وما الذي لا يجوز إعادة بيعه.
فحص بطلب واحد
يسحب هذا السكربت مجموعة Spot – Spot الكاملة (متاحة في كل خطط Genesis API) ويستخدم استجابة واحدة للتحقق من التغطية وعمر اللقطة ونسبة الصفقات القابلة للتحويل:
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
r = requests.get(BASE + "/arbitrage/spot-spot",
headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]
# التغطية: أي البورصات تظهر في الفرص
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))
# الحداثة: عمر اللقطة وخطوة تحديث الخطة
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")
# التحويل: السحب مفتوح من جهة الشراء، والإيداع من جهة البيع
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")
إعادة المحاولة عند 429 و503 تأتي من الدالة get_json في استجابات Genesis API وأخطاؤه. ثم تحقق من أسعار وحالات 3–5 فرص في البورصات عبر trade_url_buy وtrade_url_sell.
كود خاص بك أم API جاهز
لبورصة أو اثنتين مع التداول، يكون كودك الخاص فوق APIs البورصات هو الخيار الطبيعي. أما 20 بورصة بسبوت وعقود آجلة فتعني حتى 40 موصّلاً لبيانات السوق: في Binance السبوت وعقود USDⓈ-M الآجلة APIs منفصلة، api.binance.com وfapi.binance.com. يحمل كل موصّل لقطات REST وتدفق WebSocket مع إعادة اتصال، وحدوده وصيغة رموزه، ويضاف إلى ذلك الدمج: تُطابق العملات بالعقد والشبكة، لأن الرمز نفسه قد يكون رموزاً مختلفة في بورصات مختلفة.
| المهمة | كودك على APIs البورصات | Genesis API |
|---|---|---|
| إرسال الأوامر | الطريقة الوحيدة: API التداول في البورصة | لا، للقراءة فقط |
| كل صفقة لزوج واحد | WebSocket البورصة | لا، لقطات كل 60–5 ثوانٍ |
| سبريدات على 20+ بورصة | حتى 40 موصّلاً مع الدمج | طلب واحد |
| حالة الإيداع والسحب | نقطة نهاية لكل بورصة، وبمفتاح في Binance | حقول في صف الفرصة |
| DEX وأونتشين وأسواق التنبؤ | عقد وفهارس وAPIs المنصات | صيغة JSON نفسها |
يمكن الجمع بين الأسلوبين: يجد API البيانات الفرص، وتُفتح الصفقة في البورصة يدوياً أو عبر API التداول فيها بمفتاح دون صلاحية السحب (راجع كيف تؤمّن حساب بورصة العملات الرقمية). بوت مع تنبيهات Telegram يُبنى في بوت أربيتراج العملات الرقمية بـ Python.
أين يناسب Genesis API
Genesis API هو REST API لبيانات Genesis Arbitrage: CEX وDEX وأونتشين وأسواق التنبؤ وسيربيت المراهنات في صيغة JSON واحدة، والمفتاح في ترويسة X-API-Key. يقدّم البيانات نفسها التي ينشرها الموقع عبر 35+ نقطة نهاية (37 عملية في المواصفة) ويقرأ البيانات فقط.
| البيانات | مثال على نقطة النهاية | خطط API |
|---|---|---|
| سبريدات CEX | /arbitrage/spot-spot | الكل |
| DEX وعبر السلاسل | /arbitrage/dex-spot | Pro وMax |
| دفاتر الأوامر | /orderbooks/exec | Pro وMax |
| التمويل وOI | /funding/rates | الكل |
| أونتشين | /onchain/{section} | Start وPro وMax |
| أسواق التنبؤ وسيربيت المراهنات | /predictions/arbitrage | Start: exact وdutch؛ Pro وMax: llm وsport |
التغطية: 20+ بورصة CEX (Binance وOKX وBybit وBitget وMEXC وGate وBingX وKraken وWhiteBit وCoinbase وCoinW وedgeX وHTX وHyperliquid وغيرها)، والتمويل لأكثر من 1000 عملة موحّد على 8 ساعات، والفائدة المفتوحة على 13+ بورصة عقود آجلة. أسواق التنبؤ هي Polymarket وKalshi وLimitless وPredict.fun وOpinion؛ ويبني وضع sport سيربيت المراهنات عبر 13 منصة، قبل المباراة فقط.
| الخطة | الاستدعاءات شهرياً | الطلبات في الثانية | الحداثة |
|---|---|---|---|
| Trial، 20$/شهر | 500K | 1 | 60 ث |
| Start، 50$ | 2M | 2 | 30 ث |
| Pro، 100$ | 5M | 5 | 10 ث |
| Max، 200$ | 10M | 15 | 5 ث |
خطط API منفصلة عن اشتراك الموقع؛ تدفع بالعملات الرقمية، مع خصم 10% لـ 3 أشهر و20% لـ 6. عند تجاوز الحدود يعيد الخادم 429 ولا يخصم شيئاً، وتعيد نقطة نهاية خارج خطتك 403 plan_restricted. قارن الخطط في أسعار Genesis API؛ والقواعد في الخطط والحدود.
لكل قسم في الوثائق رابطه الخاص مع المعاملات والحقول ومثال curl ونموذج جرّب الطلب. وللبرامج ووكلاء الذكاء الاصطناعي توجد مواصفة OpenAPI 3.1 والمرجع llms-full.txt؛ والإعداد في Genesis API لوكلاء الذكاء الاصطناعي. يمكنك بناء خدماتك وبوتاتك ولوحاتك على Genesis API؛ ولا يجوز إعادة بيع البيانات الخام كما هي.
الطلب الأول — خطة ومفتاح في ملفك الشخصي وGET مع X-API-Key — مشروح في البداية السريعة، والأساسيات في الدرس ما هو API العملات الرقمية وماذا يمكن أتمتته. وبلا كود، البيانات نفسها في جداول الموقع وفي تنبيهات Telegram.
أسئلة وأجوبة
هل يوجد API مجاني للعملات الرقمية؟
نعم: APIs البورصات العامة تقدّم الأسعار ودفاتر الأوامر والصفقات مجاناً وبلا مفتاح (في Binance نقاط NONE)، لكن كل منها يغطي بورصة واحدة. لا توجد في Genesis API خطة مجانية: تكلّف Trial 20$ شهرياً مقابل 500K استدعاء.
هل أحتاج SDK لاستخدام API العملات الرقمية؟
لـ REST API يكفي عميل HTTP: curl أو requests في Python أو fetch في JavaScript. ليس لـ Genesis API SDK رسمي، وكل طلب هو GET بترويسة واحدة؛ ويمكنك توليد عميل مكتوب الأنواع من مواصفة OpenAPI 3.1.
هل يمكنني التداول عبر API بيانات السوق؟
لا إذا كان API للقراءة فقط مثل Genesis API: يجد الفرص ولا ينفّذ أوامر. تمر الأوامر عبر البورصة، يدوياً أو عبر API التداول فيها بمفتاح وتوقيع (في Binance نقاط TRADE)، وهذا خارج Genesis API وعلى مسؤوليتك.
كيف أحصل على سعر عملة رقمية من API؟
تعيد نقطة البورصة العامة سعر زوج على تلك البورصة: في Binance هي GET /api/v3/ticker/price، ويأتي السعر نصاً. أما أسعار العملة على كل البورصات مع حالة الإيداع والسحب فتأتي من /coins/search?query=BTC في Genesis API (راجع البحث عن عملة).