عملیات دسته‌ای

پردازش چندین درخواست 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" }

نمونه‌های کد

پایتون: موقعیت‌های وال برای چندین نماد به صورت دسته‌ای

پایتون
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 درخواست در یک دسته = 1 تماس API به جای 100. صرفه‌جویی عظیم در سهمیه برای یکپارچه‌سازی‌های پرحجم.

بهبود عملکرد

یک درخواست HTTP رفت و برگشت به جای 100. تاخیر کمتر و بازیابی سریع‌تر داده‌ها برای عملیات حجیم.

تراکنش‌های اتمی

همه درخواست‌ها در یک دسته با هم پردازش می‌شوند. هیچ شکست جزئی در عملیات دسته‌ای وجود ندارد.

مدیریت خطای آسان‌تر

پردازش وضعیت پاسخ‌های فردی برای هر درخواست در حالی که دسته به عنوان یک واحد مدیریت می‌شود.

موارد استفاده

نظارت بر چندین جفت معاملاتی: دریافت موقعیت‌های وال برای 50 نماد در یک درخواست دسته‌ای.

گزارش‌دهی روزانه: جمع‌آوری همه داده‌های مرتبط (نرخ‌های تأمین مالی، OI، لیکوییدیشن‌ها) در یک دسته واحد.

تحلیل پرتفوی: تحلیل موقعیت‌ها در چندین نماد و صرافی‌ها به صورت کارآمد.

پردازش وب‌هوک: دسته‌بندی چندین رویداد وب‌هوک در تماس‌های API واحد برای تحلیل.

بهینه‌سازی پرس‌وجوهای شما

از عملیات دسته‌ای برای حداکثر کارایی و کاهش استفاده از سهمیه API استفاده کنید.

مشاهده مرجع API
شروع رایگان — 100 تماس/روز، بدون کارت

دریافت جریان وال، تأمین مالی، سود باز و داده‌های زنجیره‌ای از 3 صرافی از یک API. سطح رایگان، بدون نیاز به کارت اعتباری، ارتقا در هر زمان.

شروع رایگان →
امتحان کنسول API زنده → (نیاز به حساب کاربری نیست)
دریافت کلید API در 30 ثانیه

آماده ساختید؟ یک کلید API رایگان دریافت کنید (100 تماس/روز، بدون کارت) و شروع به کشیدن داده‌های زنده وال، تأمین مالی و زنجیره‌ای کنید.

دریافت کلید API →