Stránkování, filtrování a řazení

Osvojte si efektivní načítání dat pomocí stránkování, filtrování a řazení. Naučte se optimalizovat dotazy a snížit počet volání API pomocí parametrů dotazu.

Stránkování

Smart Money API používá kurzorové stránkování pro efektivní načítání dat. Zadejte číslo stránky a limit pro kontrolu výsledných sad.

Parametr	Typ	Výchozí	Max
page	integer	1	N/A
limit	integer	50	500

Příklad stránkování

cURL

# Získání prvních 100 výsledků
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Získání druhé stránky
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Informace o stránkování v odpovědi

JSON

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

Filtrování

Filtrujte výsledky podle symbolu, burzy, směru a dalších kritérií. Filtry jsou kombinovány pomocí logiky AND.

Filtr	Hodnoty	Příklad
symbol	Obchodní pár	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Číslo	10.5
min_pnl_percent	Číslo	2.0

Příklad filtrování

cURL

# Filtrování podle symbolu a směru
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtrování podle burzy a minimální velikosti pozice
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Řazení

Seřaďte výsledky podle velikosti pozice, P&L nebo jiných polí. Zadejte pole a směr (asc/desc).

cURL

# Řazení podle velikosti pozice sestupně (největší první)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Řazení podle P&L vzestupně
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Kompletní příklady

Python: Procházení všech stránek

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Načte všechny pozice velryb s stránkováním"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Maximální velikost dávky
            "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"])

        # Kontrola, zda existují další stránky
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Použití
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Nalezeno {len(positions)} pozic velryb")

Doporučené postupy

1. Použijte maximální limit (100-500): Méně volání API pro načtení stejného množství dat. Efektivní dávkování výsledků.

2. Filtrujte na straně serveru: Použijte parametry dotazu pro filtrování na zdroji, nikoli v kódu vaší aplikace. Snižuje přenos dat.

3. Řaďte na serveru: Požadujte seřazené výsledky z API. Řazení ve velkém měřítku je na serveru efektivní.

4. Ukládejte do mezipaměti a stránkujte: Ukládejte výsledky lokálně a stránkujte přes uložená data, abyste minimalizovali volání API.

5. Pokud je to možné, zastavte se dříve: Nepokoušejte se vždy načíst všechny stránky. Zastavte se, když máte dostatek dat pro vaše potřeby.

Zjistěte více

Prozkoumejte kompletní referenci API pro všechny možnosti filtrování a řazení.

Zobrazit referenci REST API