العمليات المجمعة

معالجة طلبات متعددة للواجهة البرمجية في عمليات مجمعة واحدة. قلل عدد استدعاءات الواجهة البرمجية بنسبة تصل إلى 90% وحسّن الأداء لاسترجاع وتحليل البيانات بكميات كبيرة.

نظرة عامة

تتيح لك العمليات المجمعة إرسال طلبات متعددة للواجهة البرمجية في طلب HTTP واحد. هذا يقلل من عدد استدعاءات الواجهة البرمجية، ويحسن زمن الاستجابة، وهو مثالي لاسترجاع البيانات بكميات كبيرة، أو مراقبة رموز متعددة، أو إجراء تحليل مجمع. يمكنك إرسال ما يصل إلى 100 طلب في كل عملية مجمعة.

تنسيق الطلب المجمع

أرسل طلب POST إلى /v1/batch مع مصفوفة من كائنات الطلب:

JSON
{ "requests": [ { "id": "req_1", "method": "GET", "path": "/v1/whales/events?symbol=BTCUSDT" }, { "id": "req_2", "method": "GET", "path": "/v1/whales/events?symbol=ETHUSDT" }, { "id": "req_3", "method": "GET", "path": "/v1/funding-rates?symbol=BTCUSDT" } ] }

تنسيق الاستجابة المجمعة

استقبل جميع الردود في كائن استجابة مجمعة واحد، مفهرسًا بواسطة معرف الطلب:

JSON
{ "success": true, "responses": { "req_1": { "status": 200, "data": { "total": 42, "positions": [...] } }, "req_2": { "status": 200, "data": { "total": 28, "positions": [...] } }, "req_3": { "status": 200, "data": {...} } }, "timestamp": "2026-03-21T14:35:22Z" }

أمثلة برمجية

Python: الحصول على مراكز الحيتان لرموز متعددة في عملية مجمعة

Python
import requests def batch_fetch_whale_positions(api_key, symbols): """Fetch whale positions for multiple symbols in one batch""" # Build batch requests requests_list = [] for i, symbol in enumerate(symbols): requests_list.append({ "id": f"req_{i+1}", "method": "GET", "path": f"/v1/whales/events?symbol={symbol}&limit=50" }) # Send batch request response = requests.post( "https://api.smartmoneyapi.com/v1/batch", headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" }, json={"requests": requests_list} ) batch_response = response.json() # Process responses results = {} for symbol, response in zip(symbols, batch_response["responses"].values()): if response["status"] == 200: results[symbol] = response["data"]["positions"] return results # Usage: Fetch 5 symbols in one batch symbols = ["BTCUSDT", "ETHUSDT", "SOLUSDT", "XRPUSDT", "ADAUSDT"] positions = batch_fetch_whale_positions("sk_live_abc123xyz789", symbols) print(f"Fetched positions for {len(positions)} symbols")

فوائد العمليات المجمعة

تقليل استدعاءات الواجهة البرمجية

إرسال 100 طلب في عملية مجمعة واحدة = 1 استدعاء للواجهة البرمجية بدلاً من 100. توفير كبير في الحصة المخصصة للتكاملات عالية الحجم.

تحسين الأداء

طلب HTTP ذو رحلة ذهاب وإياب واحدة بدلاً من 100. زمن استجابة أقل واسترجاع أسرع للبيانات للعمليات المجمعة.

معاملات ذرية

يتم معالجة جميع الطلبات في العملية المجمعة معًا. لا توجد أعطال جزئية عبر العمليات المجمعة.

معالجة الأخطاء بسهولة

معالجة حالات الاستجابة الفردية لكل طلب أثناء التعامل مع العملية المجمعة كوحدة واحدة.

حالات الاستخدام

مراقبة أزواج تداول متعددة: احصل على مراكز الحيتان لـ 50 رمزًا في طلب مجمع واحد.

التقارير اليومية: اجمع جميع البيانات ذات الصلة (أسعار التمويل، الفائدة المفتوحة، عمليات التصفية) في عملية مجمعة واحدة.

تحليل المحفظة: حلل المراكز عبر رموز ومنصات متعددة بكفاءة.

معالجة Webhook: اجمع أحداث Webhook متعددة في استدعاءات واجهة برمجية واحدة للتحليل.

حسن استعلاماتك

استخدم العمليات المجمعة لتعظيم الكفاءة وتقليل استخدام حصة الواجهة البرمجية.

عرض مرجع الواجهة البرمجية
ابدأ مجانًا - 100 استدعاءً/يوم، بدون بطاقة

احصل على تدفق الحيتان الحي، أسعار التمويل، الفائدة المفتوحة وبيانات السلسلة عبر 3 منصات من واجهة برمجية واحدة. طبقة مجانية، بدون بطاقة ائتمان، ترقية في أي وقت.

ابدأ مجانًا →
جرب وحدة التحكم الحية للواجهة البرمجية → (لا حاجة لحساب)
احصل على مفتاح الواجهة البرمجية الخاص بك في 30 ثانية

مستعد للبناء؟ احصل على مفتاح واجهة برمجية مجاني (100 استدعاءً/يوم، بدون بطاقة) وابدأ في سحب بيانات الحيتان الحية، أسعار التمويل وبيانات السلسلة.

احصل على مفتاح الواجهة البرمجية الخاص بك →