پیجینیشن، فلٹرنگ، اور سورٹنگ

پیجینیشن، فلٹرنگ، اور سورٹنگ کے ساتھ موثر ڈیٹا بازیافت میں مہارت حاصل کریں۔ کوئریز کو بہتر بنانے اور کوئری پیرامیٹرز کا استعمال کرتے ہوئے API کالز کو کم کرنے کا طریقہ سیکھیں۔

پیجینیشن

Smart Money API موثر ڈیٹا بازیافت کے لیے کرسر بیسڈ پیجینیشن کا استعمال کرتی ہے۔ نتائج کے سیٹ کو کنٹرول کرنے کے لیے صفحہ نمبر اور حد مقرر کریں۔

پیرامیٹر	قسم	ڈیفالٹ	زیادہ سے زیادہ
صفحہ	عدد	1	N/A
حد	عدد	50	500

پیجینیشن مثال

cURL

# پہلے 100 نتائج حاصل کریں
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 منطق کے ساتھ ملایا جاتا ہے۔

فلٹر	اقدار	مثال
علامت	ٹریڈنگ جوڑا	BTCUSDT, ETHUSDT
ایکسچینج	bybit, binance, hyperliquid	bybit
سمت	long, short	long
کم سے کم پوزیشن سائز	عدد	10.5
کم سے کم منافع فیصد	عدد	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"

سورٹنگ

نتیجہ کو پوزیشن سائز، P&L، یا دیگر فیلڈز کے مطابق ترتیب دیں۔ فیلڈ اور سمت (asc/desc) مقرر کریں۔

cURL

# پوزیشن سائز کے مطابق نزولی ترتیب (سب سے بڑا پہلے)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# P&L کے مطابق صعودی ترتیب
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):
    """Fetch all whale positions with pagination"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Max batch size
            "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"])

        # Check if there are more pages
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Usage
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Found {len(positions)} whale positions")

بہترین طریقے

1. زیادہ سے زیادہ حد کا استعمال کریں (100-500): ایک ہی مقدار میں ڈیٹا بازیافت کرنے کے لیے کم API کالز۔ نتائج کو موثر طریقے سے بیچ کریں۔

2. سرور سائیڈ فلٹر کریں: اپنی ایپلیکیشن کوڈ میں نہیں بلکہ ماخذ پر فلٹر کرنے کے لیے کوئری پیرامیٹرز کا استعمال کریں۔ ڈیٹا ٹرانسفر کو کم کرتا ہے۔

3. سرور پر ترتیب دیں: API سے ترتیب شدہ نتائج کی درخواست کریں۔ بڑے پیمانے پر ترتیب دینا سرور پر موثر ہے۔

4. کیش اور پیجینیشن کریں: نتائج کو مقامی طور پر کیش کریں اور API کالز کو کم سے کم کرنے کے لیے کیش شدہ ڈیٹا کے ذریعے پیجینیشن کریں۔

5. اگر ممکن ہو تو جلد روک دیں: ہمیشہ تمام صفحات کو حاصل نہ کریں۔ جب آپ کے استعمال کے لیے کافی ڈیٹا مل جائے تو روک دیں۔

مزید سیکھیں

تمام فلٹرنگ اور سورٹنگ کے اختیارات کے لیے مکمل API حوالہ دریافت کریں۔

REST API حوالہ دیکھیں