Paginacja, Filtrowanie i Sortowanie

Opanuj efektywne pobieranie danych dzięki paginacji, filtrowaniu i sortowaniu. Dowiedz się, jak optymalizować zapytania i zmniejszać liczbę wywołań API za pomocą parametrów zapytań.

Paginacja

Smart Money API wykorzystuje paginację opartą na kursorach do efektywnego pobierania danych. Określ numer strony i limit, aby kontrolować zestawy wyników.

Parametr	Typ	Domyślna wartość	Maksymalna wartość
page	integer	1	N/A
limit	integer	50	500

Przykład Paginacji

cURL

# Pobierz pierwsze 100 wyników
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Pobierz drugą stronę
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Informacje o Paginacji w Odpowiedzi

JSON

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

Filtrowanie

Filtruj wyniki według symbolu, giełdy, kierunku i innych kryteriów. Filtry są łączone za pomocą logiki AND.

Filtr	Wartości	Przykład
symbol	Para handlowa	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Liczba	10.5
min_pnl_percent	Liczba	2.0

Przykład Filtrowania

cURL

# Filtruj według symbolu i kierunku
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtruj według giełdy i minimalnej wielkości pozycji
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Sortowanie

Sortuj wyniki według wielkości pozycji, P&L lub innych pól. Określ pole i kierunek (asc/desc).

cURL

# Sortuj według wielkości pozycji malejąco (największe pierwsze)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Sortuj według P&L rosnąco
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Pełne Przykłady

Python: Iteracja przez wszystkie strony

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Pobierz wszystkie pozycje wielorybów z paginacją"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Maksymalna wielkość partii
            "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"])

        # Sprawdź, czy są kolejne strony
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Użycie
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Znaleziono {len(positions)} pozycji wielorybów")

Najlepsze praktyki

1. Używaj maksymalnego limitu (100-500): Mniej wywołań API do pobrania tej samej ilości danych. Efektywne przetwarzanie wyników.

2. Filtruj po stronie serwera: Używaj parametrów zapytań do filtrowania u źródła, a nie w kodzie aplikacji. Zmniejsza transfer danych.

3. Sortuj na serwerze: Żądaj posortowanych wyników z API. Sortowanie na dużą skalę jest efektywne na serwerze.

4. Buforuj i paginuj: Buforuj wyniki lokalnie i paginuj przez buforowane dane, aby zminimalizować wywołania API.

5. Zatrzymaj się wcześniej, jeśli to możliwe: Nie zawsze pobieraj wszystkie strony. Zatrzymaj się, gdy masz wystarczającą ilość danych dla swojego przypadku użycia.

Dowiedz się więcej

Zapoznaj się z pełnym odniesieniem API, aby poznać wszystkie opcje filtrowania i sortowania.

Zobacz dokumentację REST API