Sayfalama, Filtreleme ve Sıralama

Sayfalama, filtreleme ve sıralama ile verimli veri almayı öğrenin. Sorgu parametrelerini kullanarak sorguları optimize etmeyi ve API çağrılarını azaltmayı keşfedin.

Sayfalama

Smart Money API, verimli veri alma için imleç tabanlı sayfalamayı kullanır. Sonuç kümelerini kontrol etmek için sayfa numarası ve limit belirtin.

Parametre	Tip	Varsayılan	Maksimum
page	integer	1	N/A
limit	integer	50	500

Sayfalama Örneği

cURL

# İlk 100 sonucu al
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# İkinci sayfayı al
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Yanıt Sayfalama Bilgisi

JSON

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

Filtreleme

Sonuçları sembol, borsa, yön ve diğer kriterlere göre filtreleyin. Filtreler AND mantığı ile birleştirilir.

Filtre	Değerler	Örnek
symbol	İşlem çifti	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Sayı	10.5
min_pnl_percent	Sayı	2.0

Filtreleme Örneği

cURL

# Sembol ve yöne göre filtrele
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Borsa ve minimum pozisyon büyüklüğüne göre filtrele
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Sıralama

Sonuçları pozisyon büyüklüğü, P&L veya diğer alanlara göre sıralayın. Alan ve yönü (asc/desc) belirtin.

cURL

# Pozisyon büyüklüğüne göre azalan sırala (en büyük ilk)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# P&L'a göre artan sırala
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Tam Örnekler

Python: Tüm Sayfaları Dolaş

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Tüm balina pozisyonlarını sayfalama ile getir"""
    all_positions = []
    page = 1

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

        # Daha fazla sayfa olup olmadığını kontrol et
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Kullanım
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"{len(positions)} adet balina pozisyonu bulundu")

En İyi Uygulamalar

1. Maksimum limiti kullanın (100-500): Aynı miktarda veriyi almak için daha az API çağrısı. Sonuçları verimli şekilde toplu halde alın.

2. Sunucu tarafında filtreleyin: Uygulama kodunuzda değil, kaynakta filtrelemek için sorgu parametrelerini kullanın. Veri transferini azaltır.

3. Sunucuda sıralayın: Sıralanmış sonuçları API'den isteyin. Büyük ölçekte sıralama sunucuda daha verimlidir.

4. Önbelleğe alın ve sayfalayın: Sonuçları yerel olarak önbelleğe alın ve API çağrılarını en aza indirmek için önbelleklenmiş veriler üzerinde sayfalayın.

5. Mümkünse erken durun: Her zaman tüm sayfaları getirmeyin. Kullanım durumunuz için yeterli veriye sahip olduğunuzda durun.

Daha Fazla Bilgi

Tüm filtreleme ve sıralama seçenekleri için tam API referansını keşfedin.

REST API Referansını Görüntüle