पेजिनेशन, फ़िल्टरिंग, और सॉर्टिंग

पेजिनेशन, फ़िल्टरिंग, और सॉर्टिंग के साथ कुशल डेटा पुनर्प्राप्ति में महारत हासिल करें। क्वेरी पैरामीटर्स का उपयोग करके क्वेरीज़ को ऑप्टिमाइज़ करने और API कॉल्स को कम करने का तरीका सीखें।

पेजिनेशन

Smart Money API कुशल डेटा पुनर्प्राप्ति के लिए कर्सर-आधारित पेजिनेशन का उपयोग करता है। परिणाम सेट को नियंत्रित करने के लिए पेज नंबर और सीमा निर्दिष्ट करें।

पैरामीटर	प्रकार	डिफ़ॉल्ट	अधिकतम
page	integer	1	N/A
limit	integer	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 तर्क के साथ जोड़ा जाता है।

फ़िल्टर	मान	उदाहरण
symbol	ट्रेडिंग पेयर	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Number	10.5
min_pnl_percent	Number	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 संदर्भ देखें