Lapozás, szűrés és rendezés

Ismerje meg a hatékony adatlekérdezést lapozással, szűréssel és rendezéssel. Tanulja meg, hogyan optimalizálhatja a lekérdezéseket és csökkentheti az API hívásokat lekérdezési paraméterek használatával.

Lapozás

A Smart Money API kurzor alapú lapozást használ a hatékony adatlekérdezés érdekében. Adja meg az oldalszámot és a limitet az eredményhalmaz szabályozásához.

Paraméter	Típus	Alapértelmezett	Maximum
page	integer	1	N/A
limit	integer	50	500

Lapozási példa

cURL

# Első 100 eredmény lekérése
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Második oldal lekérése
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Válasz lapozási információ

JSON

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

Szűrés

Szűrje az eredményeket szimbólum, tőzsde, irány és egyéb kritériumok alapján. A szűrők AND logikával kombinálhatók.

Szűrő	Értékek	Példa
symbol	Kereskedési pár	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Szám	10.5
min_pnl_percent	Szám	2.0

Szűrési példa

cURL

# Szűrés szimbólum és irány szerint
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Szűrés tőzsde és minimális pozíció méret szerint
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Rendezés

Rendezd az eredményeket pozíció méret, P&L vagy más mezők szerint. Add meg a mezőt és az irányt (növekvő/csökkenő).

cURL

# Rendezés pozíció méret szerint csökkenő sorrendben (legnagyobb először)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Rendezés P&L szerint növekvő sorrendben
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Teljes példák

Python: Végigiterálás az összes oldalon

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Összes bálna pozíció lekérése lapozással"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Maximális köteg méret
            "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"])

        # Ellenőrizd, van-e még további oldal
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Használat
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Talált {len(positions)} bálna pozíció")

Ajánlott eljárások

1. Használd a maximális limitet (100-500): Kevesebb API hívás ugyanannyi adat lekéréséhez. Hatékonyan kötegeld az eredményeket.

2. Szűrj szerver oldalon: Használj lekérdezési paramétereket a szűréshez a forrásnál, ne az alkalmazás kódodban. Csökkenti az adatátvitelt.

3. Rendezz a szerveren: Kérj rendezett eredményeket az API-tól. A nagyméretű rendezés hatékonyabb a szerveren.

4. Gyorsítótárazz és lapozz: Gyorsítótárazd az eredményeket helyileg és lapozz a gyorsítótárazott adatokon, hogy minimalizáld az API hívásokat.

5. Állj meg korán, ha lehetséges: Ne mindig kérj le minden oldalt. Állj meg, ha elegendő adatod van a használati esetedhez.

További információk

Fedezd fel a teljes API referenciát az összes szűrési és rendezési lehetőségért.

REST API referencia megtekintése