Batch Operations

בצע מספר בקשות API בפעולות באצווה אחת. צמצם את מספר קריאות ה-API עד ל-90% ושפר ביצועים לאחזור וניתוח נתונים במרוכז.

סקירה כללית

פעולות באצווה מאפשרות לשלוח מספר בקשות API בבקשה HTTP אחת. זה מפחית את מספר קריאות ה-API, משפר את זמן התגובה, ומושלם לאחזור נתונים במרוכז, ניטור מספר סמלים, או ביצוע ניתוח באצווה. ניתן לשלוח עד 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")

יתרונות של פעולות באצווה

פחות קריאות API

שלח 100 בקשות באצווה אחת = קריאת API אחת במקום 100. חיסכון משמעותי במכסה לאינטגרציות בהיקף גדול.

ביצועים משופרים

בקשה HTTP אחת במקום 100. זמן תגובה נמוך יותר ואחזור נתונים מהיר יותר לפעולות מרוכזות.

עסקאות אטומיות

כל הבקשות באצווה מעובדות יחד. אין כשלים חלקיים בפעולות באצווה.

טיפול בשגיאות קל יותר

עיבוד סטטוסי תגובה פרטניים לכל בקשה תוך טיפול בבאצווה כיחידה אחת.

שימושים

ניטור מספר זוגות מסחר: אחזור מיקומי לווייתנים עבור 50 סמלים בבקשת באצווה אחת.

דיווח יומי: איסוף כל הנתונים הרלוונטיים (שעורי מימון, OI, נזילות) בבאצווה אחת.

ניתוח תיק: ניתוח מיקומים במספר סמלים ובורסות ביעילות.

עיבוד Webhook: אריזת מספר אירועי Webhook לקריאות API בודדות לניתוח.

שפר את השאילתות שלך

השתמש בפעולות באצווה כדי למקסם יעילות ולהפחית שימוש במכסת API.

צפה במדריך API
התחל בחינם — 100 קריאות/יום, ללא כרטיס

קבל נתוני זרימת לווייתנים, מימון, open interest ונתוני on-chain מ-3 בורסות מ-API אחד. חבילה חינמית, ללא כרטיס אשראי, שדרוג בכל עת.

התחל בחינם →
נסה את מסוף ה-API החי → (לא נדרש חשבון)
קבל את מפתח ה-API שלך תוך 30 שניות

מוכן לבנות? קבל מפתח API חינמי (100 קריאות/יום, ללא כרטיס) והתחל למשוך נתוני לווייתנים, מימון ו-on-chain חיים.

קבל את מפתח ה-API שלך →