Paginering, filteren en sorteren

Beheers efficiënte dataverwerking met paginering, filteren en sorteren. Leer hoe je queries optimaliseert en API-aanroepen vermindert met behulp van queryparameters.

Paginering

Smart Money API gebruikt cursor-gebaseerde paginering voor efficiënte dataverwerking. Geef paginanummer en limiet op om resultatensets te beheren.

Parameter	Type	Standaard	Max
page	integer	1	N/A
limit	integer	50	500

Voorbeeld van paginering

cURL

# Eerste 100 resultaten ophalen
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

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

Pagineringinformatie in antwoord

JSON

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

Filteren

Filter resultaten op symbool, exchange, richting en andere criteria. Filters worden gecombineerd met AND-logica.

Filter	Waarden	Voorbeeld
symbol	Handelspaar	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Nummer	10.5
min_pnl_percent	Nummer	2.0

Voorbeeld van filteren

cURL

# Filteren op symbool en richting
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filteren op exchange en minimale positiemaat
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Sorteren

Sorteer resultaten op positiemaat, P&L of andere velden. Geef veld en richting op (asc/desc).

cURL

# Sorteer op positiemaat aflopend (grootste eerst)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Sorteer op P&L oplopend
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Volledige voorbeelden

Python: Doorloop alle pagina's

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Haal alle walvisposities op met paginering"""
    all_positions = []
    page = 1

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

        # Controleer of er meer pagina's zijn
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Gebruik
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Gevonden {len(positions)} walvisposities")

Beste praktijken

1. Gebruik maximale limiet (100-500): Minder API-aanroepen om dezelfde hoeveelheid data op te halen. Batch resultaten efficiënt.

2. Filter server-side: Gebruik queryparameters om bij de bron te filteren, niet in je applicatiecode. Vermindert dataoverdracht.

3. Sorteer op de server: Vraag gesorteerde resultaten aan bij de API. Sorteren op schaal is efficiënt op de server.

4. Cache en pagineer: Cache resultaten lokaal en pagineer door gecachte data om API-aanroepen te minimaliseren.

5. Stop vroegtijdig indien mogelijk: Haal niet altijd alle pagina's op. Stop wanneer je voldoende data hebt voor je use case.

Meer leren

Verken de volledige API-referentie voor alle filter- en sorteermogelijkheden.

Bekijk REST API-referentie