صفحه‌بندی، فیلتر و مرتب‌سازی

با صفحه‌بندی، فیلتر و مرتب‌سازی، بازیابی داده را بهینه کنید. یاد بگیرید چگونه با استفاده از پارامترهای کوئری، درخواست‌های API را کاهش دهید.

صفحه‌بندی

Smart Money API از صفحه‌بندی مبتنی بر کرسر برای بازیابی کارآمد داده استفاده می‌کند. شماره صفحه و محدودیت را برای کنترل نتایج مشخص کنید.

پارامتر	نوع	پیش‌فرض	حداکثر
page	integer	1	N/A
limit	integer	50	500

مثال صفحه‌بندی

cURL

# دریافت ۱۰۰ نتیجه اول
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# دریافت صفحه دوم
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

اطلاعات صفحه‌بندی پاسخ

JSON

{
  "success": true,
  "data": {...},
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 420,
    "total_pages": 9,
    "has_next": true,
    "has_prev": false
  }
}

فیلتر

نتایج را بر اساس نماد، صرافی، جهت و معیارهای دیگر فیلتر کنید. فیلترها با منطق AND ترکیب می‌شوند.

فیلتر	مقادیر	مثال
symbol	جفت معاملاتی	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	عدد	10.5
min_pnl_percent	عدد	2.0

مثال فیلتر

cURL

# فیلتر بر اساس نماد و جهت
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# فیلتر بر اساس صرافی و حداقل حجم موقعیت
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

مرتب‌سازی

نتایج را بر اساس حجم موقعیت، سود و زیان یا فیلدهای دیگر مرتب کنید. فیلد و جهت (صعودی/نزولی) را مشخص کنید.

cURL

# مرتب‌سازی بر اساس حجم موقعیت نزولی (بزرگ‌ترین اول)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# مرتب‌سازی بر اساس سود و زیان صعودی
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

مثال‌های کامل

Python: پیمایش تمام صفحات

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """دریافت تمام موقعیت‌های وال با صفحه‌بندی"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # حداکثر اندازه دسته
            "sort": "position_size",
            "order": "desc"
        }

        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            "https://api.smartmoneyapi.com/v1/whales/events",
            headers={"Authorization": f"Bearer {api_key}"},
            params=params
        )

        data = response.json()
        all_positions.extend(data["data"]["positions"])

        # بررسی وجود صفحات بیشتر
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# استفاده
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Found {len(positions)} whale positions")

بهترین روش‌ها

1. استفاده از حداکثر محدودیت (۱۰۰-۵۰۰): درخواست‌های API کمتر برای دریافت همان مقدار داده. دسته‌بندی نتایج به صورت کارآمد.

2. فیلتر در سمت سرور: از پارامترهای کوئری برای فیلتر در منبع استفاده کنید، نه در کد برنامه. انتقال داده را کاهش می‌دهد.

3. مرتب‌سازی در سرور: نتایج مرتب‌شده را از API درخواست کنید. مرتب‌سازی در مقیاس بزرگ در سرور کارآمد است.

4. ذخیره و صفحه‌بندی: نتایج را محلی ذخیره کنید و از طریق داده‌های ذخیره‌شده صفحه‌بندی کنید تا درخواست‌های API کاهش یابد.

5. توقف زودهنگام در صورت امکان: همیشه تمام صفحات را دریافت نکنید. وقتی داده کافی برای استفاده دارید، متوقف شوید.

بیشتر بیاموزید

مرجع کامل API را برای تمام گزینه‌های فیلتر و مرتب‌سازی بررسی کنید.

مشاهده مرجع REST API