Pagination, Filtering und Sorting

Meistern Sie die effiziente Datenabfrage mit Pagination, Filtering und Sorting. Erfahren Sie, wie Sie Abfragen optimieren und API-Aufrufe mithilfe von Abfrageparametern reduzieren können.

Pagination

Smart Money API verwendet cursor-basierte Pagination für eine effiziente Datenabfrage. Geben Sie Seitenzahl und Limit an, um die Ergebnismenge zu steuern.

Parameter	Typ	Standard	Max
page	integer	1	N/A
limit	integer	50	500

Pagination Beispiel

cURL

# Get first 100 results
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Get second page
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Response Pagination Info

JSON

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

Filtering

Filtern Sie Ergebnisse nach Symbol, Börse, Richtung und anderen Kriterien. Filter werden mit AND-Logik kombiniert.

Filter	Werte	Beispiel
symbol	Trading-Paar	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Zahl	10.5
min_pnl_percent	Zahl	2.0

Filtering Beispiel

cURL

# Filter by symbol and direction
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filter by exchange and minimum position size
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Sorting

Sortieren Sie Ergebnisse nach Positionsgröße, P&L oder anderen Feldern. Geben Sie Feld und Richtung (asc/desc) an.

cURL

# Sort by position size descending (largest first)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Sort by P&L ascending
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Komplette Beispiele

Python: Durch alle Seiten iterieren

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")

Best Practices

1. Verwenden Sie das maximale Limit (100-500): Weniger API-Aufrufe, um die gleiche Datenmenge abzurufen. Ergebnisse effizient bündeln.

2. Filtern Sie serverseitig: Verwenden Sie Abfrageparameter, um direkt an der Quelle zu filtern, nicht in Ihrem Anwendungscode. Reduziert den Datentransfer.

3. Sortieren Sie auf dem Server: Fordern Sie sortierte Ergebnisse von der API an. Sortieren in großem Maßstab ist auf dem Server effizient.

4. Cachen und paginieren: Ergebnisse lokal zwischenspeichern und durch die zwischengespeicherten Daten paginieren, um API-Aufrufe zu minimieren.

5. Früher stoppen, wenn möglich: Holen Sie nicht immer alle Seiten ab. Stoppen Sie, wenn Sie genug Daten für Ihren Anwendungsfall haben.

Mehr erfahren

Erkunden Sie die vollständige API-Referenz für alle Filter- und Sortieroptionen.

REST API-Referenz anzeigen