পেজিনেশন, ফিল্টারিং এবং সর্টিং

পেজিনেশন, ফিল্টারিং এবং সর্টিং ব্যবহার করে দক্ষ ডেটা রিট্রিভাল শিখুন। কিভাবে কোয়েরি অপ্টিমাইজ করতে হয় এবং কোয়েরি প্যারামিটার ব্যবহার করে 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	সংখ্যা	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"

সর্টিং

পজিশন সাইজ, 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 রেফারেন্স এক্সপ্লোর করুন।