Paginare, Filtrare și Sortare

Stăpânește preluarea eficientă a datelor cu paginare, filtrare și sortare. Învață cum să optimizezi interogările și să reduci apelurile API folosind parametrii de interogare.

Paginare

Smart Money API utilizează paginarea bazată pe cursor pentru preluarea eficientă a datelor. Specifică numărul paginii și limita pentru a controla seturile de rezultate.

Parametru	Tip	Implicit	Maxim
page	întreg	1	N/A
limit	întreg	50	500

Exemplu de Paginare

cURL

# Obține primele 100 de rezultate
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Obține a doua pagină
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Informații de Paginare din Răspuns

JSON

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

Filtrare

Filtrează rezultatele după simbol, schimb, direcție și alte criterii. Filtrele sunt combinate cu logica AND.

Filtru	Valori	Exemplu
symbol	Pereche de tranzacționare	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Număr	10.5
min_pnl_percent	Număr	2.0

Exemplu de Filtrare

cURL

# Filtrează după simbol și direcție
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtrează după schimb și dimensiune minimă a poziției
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Sortare

Sortează rezultatele după dimensiunea poziției, P&L sau alte câmpuri. Specifică câmpul și direcția (asc/desc).

cURL

# Sortează după dimensiunea poziției descrescător (cele mai mari primele)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Sortează după P&L crescător
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Exemple Complete

Python: Iterează Prin Toate Paginile

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

Cele Mai Bune Practici

1. Folosește limita maximă (100-500): Mai puține apeluri API pentru a prelua aceeași cantitate de date. Grupează rezultatele eficient.

2. Filtrează pe server: Folosește parametrii de interogare pentru a filtra la sursă, nu în codul aplicației tale. Reduce transferul de date.

3. Sortează pe server: Cere rezultate sortate de la API. Sortarea la scară este eficientă pe server.

4. Cache și paginare: Cachează rezultatele local și paginează prin datele cache pentru a minimiza apelurile API.

5. Oprește-te devreme dacă este posibil: Nu prelua întotdeauna toate paginile. Oprește-te când ai suficiente date pentru cazul tău de utilizare.

Află Mai Multe

Explorează referința completă a API pentru toate opțiunile de filtrare și sortare.

Vezi Referința API REST