Batch Operations
בצע מספר בקשות API בפעולות באצווה אחת. צמצם את מספר קריאות ה-API עד ל-90% ושפר ביצועים לאחזור וניתוח נתונים במרוכז.
סקירה כללית
פעולות באצווה מאפשרות לשלוח מספר בקשות API בבקשה HTTP אחת. זה מפחית את מספר קריאות ה-API, משפר את זמן התגובה, ומושלם לאחזור נתונים במרוכז, ניטור מספר סמלים, או ביצוע ניתוח באצווה. ניתן לשלוח עד 100 בקשות באצווה אחת.
פורמט בקשת באצווה
POST ל-/v1/batch עם מערך של אובייקטי בקשה:
{
"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"
}
]
}
פורמט תגובת באצווה
קבל את כל התגובות באובייקט תגובת באצווה אחד, ממוין לפי מזהה בקשה:
{
"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: מיקומי לווייתנים באצווה למספר סמלים
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