Paginasi, Penyaringan, dan Pengurutan

Kuasai pengambilan data efisien dengan paginasi, penyaringan, dan pengurutan. Pelajari cara mengoptimalkan kueri dan mengurangi panggilan API menggunakan parameter kueri.

Paginasi

Smart Money API menggunakan paginasi berbasis kursor untuk pengambilan data yang efisien. Tentukan nomor halaman dan batas untuk mengontrol set hasil.

Parameter	Tipe	Default	Maks
page	integer	1	N/A
limit	integer	50	500

Contoh Paginasi

cURL

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

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

Info Paginasi Respons

JSON

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

Penyaringan

Saring hasil berdasarkan simbol, bursa, arah, dan kriteria lainnya. Filter digabungkan dengan logika AND.

Filter	Nilai	Contoh
symbol	Pasangan perdagangan	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Angka	10.5
min_pnl_percent	Angka	2.0

Contoh Penyaringan

cURL

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

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

Pengurutan

Urutkan hasil berdasarkan ukuran posisi, P&L, atau bidang lainnya. Tentukan bidang dan arah (asc/desc).

cURL

# Urutkan berdasarkan ukuran posisi menurun (terbesar pertama)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

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

Contoh Lengkap

Python: Iterasi Melalui Semua Halaman

Python

import requests

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

    while True:
        params = {
            "page": page,
            "limit": 100,  # Ukuran batch maksimal
            "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 apakah ada halaman berikutnya
        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"Ditemukan {len(positions)} posisi paus")

Praktik Terbaik

1. Gunakan batas maksimum (100-500): Lebih sedikit panggilan API untuk mengambil jumlah data yang sama. Hasil batch secara efisien.

2. Filter di sisi server: Gunakan parameter kueri untuk menyaring di sumbernya, bukan di kode aplikasi Anda. Mengurangi transfer data.

3. Urutkan di server: Minta hasil yang diurutkan dari API. Pengurutan dalam skala besar lebih efisien di server.

4. Cache dan paginasi: Simpan hasil secara lokal dan paginasi melalui data yang di-cache untuk meminimalkan panggilan API.

5. Berhenti lebih awal jika memungkinkan: Jangan selalu mengambil semua halaman. Berhenti ketika Anda memiliki cukup data untuk kasus penggunaan Anda.

Pelajari Lebih Lanjut

Jelajahi referensi API lengkap untuk semua opsi penyaringan dan pengurutan.

Lihat Referensi REST API