Paginering, filtrering och sortering

Bemästra effektiv datahämtning med paginering, filtrering och sortering. Lär dig hur du optimerar frågor och minskar API-anrop med hjälp av frågeparametrar.

Paginering

Smart Money API använder cursor-baserad paginering för effektiv datahämtning. Ange sidnummer och gräns för att kontrollera resultatmängder.

Parameter	Typ	Standard	Max
page	heltal	1	N/A
limit	heltal	50	500

Exempel på paginering

cURL

# Hämta första 100 resultaten
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Hämta andra sidan
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Paginering av svar

JSON

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

Filtrering

Filtrera resultat efter symbol, börs, riktning och andra kriterier. Filter kombineras med AND-logik.

Filter	Värden	Exempel
symbol	Handelspar	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Nummer	10.5
min_pnl_percent	Nummer	2.0

Exempel på filtrering

cURL

# Filtrera efter symbol och riktning
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Filtrera efter börs och minsta positionsstorlek
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Sortering

Sortera resultat efter positionsstorlek, P&L eller andra fält. Ange fält och riktning (asc/desc).

cURL

# Sortera efter positionsstorlek fallande (störst först)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Sortera efter P&L stigande
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Kompletta exempel

Python: Iterera genom alla sidor

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Hämta alla valpositioner med paginering"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Maximal batchstorlek
            "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"])

        # Kontrollera om det finns fler sidor
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Användning
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Hittade {len(positions)} valpositioner")

Bästa praxis

1. Använd maximal gräns (100-500): Färre API-anrop för att hämta samma mängd data. Batcha resultat effektivt.

2. Filtrera på serversidan: Använd frågeparametrar för att filtrera vid källan, inte i din applikationskod. Minskar dataöverföring.

3. Sortera på servern: Begär sorterade resultat från API:et. Sortering i stor skala är effektiv på servern.

4. Cacha och paginera: Cacha resultat lokalt och paginera genom cachad data för att minimera API-anrop.

5. Stanna tidigt om möjligt: Hämta inte alltid alla sidor. Stanna när du har tillräckligt med data för ditt användningsfall.

Läs mer

Utforska den kompletta API-referensen för alla filtrerings- och sorteringsalternativ.

Visa REST API-referens