Σελιδοποίηση, Φιλτράρισμα και Ταξινόμηση

Κατακτήστε την αποδοτική ανάκτηση δεδομένων με σελιδοποίηση, φιλτράρισμα και ταξινόμηση. Μάθετε πώς να βελτιστοποιείτε τα ερωτήματα και να μειώνετε τις κλήσεις 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):
    """Λήψη όλων των θέσεων φαλαινών με σελιδοποίηση"""
    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"Βρέθηκαν {len(positions)} θέσεις φαλαινών")

Βέλτιστες Πρακτικές

1. Χρησιμοποιήστε το μέγιστο όριο (100-500): Λιγότερες κλήσεις API για ανάκτηση της ίδιας ποσότητας δεδομένων. Ομαδοποιήστε τα αποτελέσματα αποδοτικά.

2. Φιλτράρισμα από τον διακομιστή: Χρησιμοποιήστε παραμέτρους ερωτημάτων για φιλτράρισμα στην πηγή, όχι στον κώδικα της εφαρμογής σας. Μειώνει τη μεταφορά δεδομένων.

3. Ταξινόμηση στον διακομιστή: Ζητήστε ταξινομημένα αποτελέσματα από το API. Η ταξινόμηση σε μεγάλη κλίμακα είναι αποδοτική στον διακομιστή.

4. Προσωρινή αποθήκευση και σελιδοποίηση: Αποθηκεύστε τα αποτελέσματα τοπικά και σελιδοποιήστε τα προσωρινά αποθηκευμένα δεδομένα για να ελαχιστοποιήσετε τις κλήσεις API.

5. Σταματήστε νωρίς αν είναι δυνατόν: Μην ανακτάτε πάντα όλες τις σελίδες. Σταματήστε όταν έχετε αρκετά δεδομένα για την περίπτωση χρήσης σας.

Μάθετε Περισσότερα

Εξερευνήστε την πλήρη αναφορά API για όλες τις επιλογές φιλτραρίσματος και ταξινόμησης.

Δείτε την Αναφορά REST API