Paginazione, Filtri e Ordinamento

Padroneggia il recupero efficiente dei dati con paginazione, filtri e ordinamento. Scopri come ottimizzare le query e ridurre le chiamate API utilizzando i parametri di query.

Paginazione

Smart Money API utilizza la paginazione basata su cursore per un recupero efficiente dei dati. Specifica il numero di pagina e il limite per controllare i set di risultati.

Parametro	Tipo	Default	Massimo
page	integer	1	N/A
limit	integer	50	500

Esempio di Paginazione

cURL

# Ottieni i primi 100 risultati
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

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

Informazioni di Paginazione nella Risposta

JSON

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

Filtri

Filtra i risultati per simbolo, exchange, direzione e altri criteri. I filtri sono combinati con logica AND.

Filtro	Valori	Esempio
symbol	Coppia di trading	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Numero	10.5
min_pnl_percent	Numero	2.0

Esempio di Filtri

cURL

# Filtra per simbolo e direzione
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtra per exchange e dimensione minima della posizione
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Ordinamento

Ordina i risultati per dimensione della posizione, P&L o altri campi. Specifica il campo e la direzione (asc/desc).

cURL

# Ordina per dimensione della posizione decrescente (dalla più grande)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Ordina per P&L crescente
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Esempi Completi

Python: Scorri Tutte le Pagine

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Recupera tutte le posizioni delle balene con paginazione"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Dimensione massima del batch
            "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"])

        # Controlla se ci sono altre pagine
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Utilizzo
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Trovate {len(positions)} posizioni delle balene")

Best Practices

1. Utilizza il limite massimo (100-500): Meno chiamate API per recuperare la stessa quantità di dati. Raggruppa i risultati in modo efficiente.

2. Filtra lato server: Utilizza i parametri di query per filtrare alla fonte, non nel codice dell'applicazione. Riduce il trasferimento dei dati.

3. Ordina sul server: Richiedi risultati ordinati dall'API. L'ordinamento su larga scala è efficiente sul server.

4. Memorizza nella cache e pagina: Memorizza i risultati localmente e scorri i dati memorizzati per minimizzare le chiamate API.

5. Interrompi presto se possibile: Non recuperare sempre tutte le pagine. Interrompi quando hai abbastanza dati per il tuo caso d'uso.

Scopri di Più

Esplora la reference completa dell'API per tutte le opzioni di filtraggio e ordinamento.