Paginasi, Penapisan, dan Penyusunan

Kuasa pengambilan data yang cekap dengan paginasi, penapisan, dan penyusunan. Pelajari cara mengoptimumkan pertanyaan dan mengurangkan panggilan API menggunakan parameter pertanyaan.

Paginasi

Smart Money API menggunakan paginasi berasaskan kursor untuk pengambilan data yang cekap. Tentukan nombor halaman dan had untuk mengawal set hasil.

Parameter	Jenis	Lalai	Maks
page	integer	1	N/A
limit	integer	50	500

Contoh Paginasi

cURL

# Dapatkan 100 hasil pertama
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Dapatkan halaman kedua
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Maklumat Paginasi Respons

JSON

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

Penapisan

Tapisan hasil berdasarkan simbol, pertukaran, arah, dan kriteria lain. Tapisan digabungkan dengan logik DAN.

Penapis	Nilai	Contoh
symbol	Pasangan dagangan	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Nombor	10.5
min_pnl_percent	Nombor	2.0

Contoh Penapisan

cURL

# Tapis berdasarkan simbol dan arah
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Tapis berdasarkan pertukaran dan saiz posisi minimum
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Penyusunan

Susun hasil mengikut saiz posisi, P&L, atau medan lain. Tentukan medan dan arah (asc/desc).

cURL

# Susun mengikut saiz posisi menurun (terbesar dahulu)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Susun mengikut P&L menaik
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Contoh Lengkap

Python: Leraian Melalui Semua Halaman

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Ambil semua posisi ikan paus dengan paginasi"""
    all_positions = []
    page = 1

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

        # Periksa jika terdapat lebih banyak halaman
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Penggunaan
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Found {len(positions)} whale positions")

Amalan Terbaik

1. Gunakan had maksimum (100-500): Kurang panggilan API untuk mengambil jumlah data yang sama. Kelompokkan hasil dengan cekap.

2. Tapis di pelayan: Gunakan parameter pertanyaan untuk menapis di sumber, bukan dalam kod aplikasi anda. Mengurangkan pemindahan data.

3. Susun di pelayan: Minta hasil yang disusun dari API. Penyusunan pada skala adalah cekap di pelayan.

4. Cache dan paginasi: Cache hasil secara tempatan dan paginasi melalui data yang dicache untuk mengurangkan panggilan API.

5. Berhenti awal jika mungkin: Jangan selalu mengambil semua halaman. Berhenti apabila anda mempunyai data yang mencukupi untuk kes penggunaan anda.

Ketahui Lebih Lanjut

Terokai rujukan API lengkap untuk semua pilihan penapisan dan penyusunan.

Lihat Rujukan API REST