Pagination, Filtering, at Pag-uuri

Masterin ang mahusay na pagkuha ng data gamit ang pag-pagination, pag-filter, at pag-uuri. Alamin kung paano i-optimize ang mga query at bawasan ang mga API call gamit ang mga query parameter.

Pagination

Gumagamit ang Smart Money API ng cursor-based na pag-pagination para sa mahusay na pagkuha ng data. Tukuyin ang page number at limit para makontrol ang mga resulta.

Parameter	Uri	Default	Max
page	integer	1	N/A
limit	integer	50	500

Halimbawa ng Pag-pagination

cURL

# Kunin ang unang 100 resulta
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Kunin ang pangalawang pahina
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Impormasyon sa Pag-pagination ng Tugon

JSON

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

Pag-filter

I-filter ang mga resulta ayon sa simbolo, exchange, direksyon, at iba pang pamantayan. Pinagsasama ang mga filter gamit ang AND logic.

Filter	Mga Halaga	Halimbawa
symbol	Trading pair	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Numero	10.5
min_pnl_percent	Numero	2.0

Halimbawa ng Pag-filter

cURL

# I-filter ayon sa simbolo at direksyon
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# I-filter ayon sa exchange at minimum na laki ng posisyon
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Pag-uuri

I-uri ang mga resulta ayon sa laki ng posisyon, P&L, o iba pang mga field. Tukuyin ang field at direksyon (asc/desc).

cURL

# I-uri ayon sa laki ng posisyon pababa (pinakamalaki muna)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# I-uri ayon sa P&L pataas
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Mga Kumpletong Halimbawa

Python: Mag-iterate sa Lahat ng Mga Pahina

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Fetch all whale positions with pagination"""
    all_positions = []
    page = 1

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

        # Check if there are more pages
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

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

Mga Pinakamahusay na Pamamaraan

1. Gamitin ang maximum na limit (100-500): Mas kaunting mga API call para makuha ang parehong dami ng data. Mahusay na i-batch ang mga resulta.

2. I-filter sa server-side: Gamitin ang mga query parameter para mag-filter sa pinagmulan, hindi sa iyong application code. Binabawasan ang data transfer.

3. Mag-uri sa server: Humiling ng mga na-uri na resulta mula sa API. Mahusay ang pag-uuri sa malaking sukat sa server.

4. I-cache at mag-paginate: I-cache ang mga resulta sa lokal at mag-paginate sa pamamagitan ng cached data para mabawasan ang mga API call.

5. Huminto nang maaga kung maaari: Huwag laging kunin ang lahat ng pahina. Huminto kapag may sapat na data para sa iyong use case.

Matuto Pa

Tuklasin ang kumpletong API reference para sa lahat ng mga opsyon sa pag-filter at pag-uuri.

Tingnan ang REST API Reference