Pagination, Filtrage et Tri

Maîtrisez la récupération efficace des données avec la pagination, le filtrage et le tri. Apprenez à optimiser les requêtes et à réduire les appels d'API en utilisant les paramètres de requête.

Pagination

Smart Money API utilise la pagination basée sur un curseur pour une récupération efficace des données. Spécifiez le numéro de page et la limite pour contrôler les ensembles de résultats.

Paramètre	Type	Par défaut	Max
page	entier	1	N/A
limit	entier	50	500

Exemple de Pagination

cURL

# Obtenir les 100 premiers résultats
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Obtenir la deuxième page
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Informations de Pagination de la Réponse

JSON

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

Filtrage

Filtrez les résultats par symbole, échange, direction et autres critères. Les filtres sont combinés avec une logique ET.

Filtre	Valeurs	Exemple
symbol	Paire de trading	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Nombre	10.5
min_pnl_percent	Nombre	2.0

Exemple de Filtrage

cURL

# Filtrer par symbole et direction
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtrer par échange et taille de position minimale
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Tri

Triez les résultats par taille de position, P&L ou autres champs. Spécifiez le champ et la direction (asc/desc).

cURL

# Trier par taille de position décroissante (les plus grandes d'abord)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_size&order=desc"

# Trier par P&L croissant
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percent&order=asc"

Exemples Complets

Python : Parcourir toutes les pages

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Récupérer toutes les positions des baleines avec pagination"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Taille maximale du lot
            "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"])

        # Vérifier s'il y a plus de pages
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Utilisation
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Found {len(positions)} whale positions")

Bonnes pratiques

1. Utilisez la limite maximale (100-500) : Moins d'appels d'API pour récupérer la même quantité de données. Traitez les résultats par lots efficacement.

2. Filtrez côté serveur : Utilisez les paramètres de requête pour filtrer à la source, pas dans votre code d'application. Réduit le transfert de données.

3. Triez sur le serveur : Demandez des résultats triés depuis l'API. Le tri à grande échelle est efficace sur le serveur.

4. Mettez en cache et paginez : Mettez en cache les résultats localement et paginez les données mises en cache pour minimiser les appels d'API.

5. Arrêtez-vous tôt si possible : Ne récupérez pas toujours toutes les pages. Arrêtez-vous lorsque vous avez suffisamment de données pour votre cas d'utilisation.

En savoir plus

Explorez la référence complète de l'API pour toutes les options de filtrage et de tri.

Voir la référence de l'API REST