การแบ่งหน้า การกรอง และการเรียงลำดับ

เรียนรู้การดึงข้อมูลอย่างมีประสิทธิภาพด้วยการแบ่งหน้า การกรอง และการเรียงลำดับ เรียนรู้วิธีเพิ่มประสิทธิภาพการสืบค้นและลดการเรียกใช้ API ด้วยพารามิเตอร์การสืบค้น

การแบ่งหน้า

Smart Money API ใช้การแบ่งหน้าแบบ cursor-based เพื่อดึงข้อมูลอย่างมีประสิทธิภาพ ระบุหมายเลขหน้าและขีดจำกัดเพื่อควบคุมชุดผลลัพธ์

พารามิเตอร์	ประเภท	ค่าเริ่มต้น	สูงสุด
page	integer	1	N/A
limit	integer	50	500

ตัวอย่างการแบ่งหน้า

cURL

# รับผลลัพธ์ 100 รายการแรก
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# รับหน้าที่สอง
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

ข้อมูลการแบ่งหน้าในผลลัพธ์

JSON

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

การกรอง

กรองผลลัพธ์ด้วยสัญลักษณ์ การแลกเปลี่ยน ทิศทาง และเกณฑ์อื่นๆ ตัวกรองจะถูกรวมกันด้วยตรรกะ AND

ตัวกรอง	ค่าที่เป็นไปได้	ตัวอย่าง
symbol	คู่เทรด	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	ตัวเลข	10.5
min_pnl_percent	ตัวเลข	2.0

ตัวอย่างการกรอง

cURL

# กรองด้วยสัญลักษณ์และทิศทาง
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# กรองด้วยการแลกเปลี่ยนและขนาดตำแหน่งขั้นต่ำ
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

การเรียงลำดับ

เรียงลำดับผลลัพธ์ด้วยขนาดตำแหน่ง P&L หรือฟิลด์อื่นๆ ระบุฟิลด์และทิศทาง (asc/desc)

cURL

# เรียงลำดับด้วยขนาดตำแหน่งจากมากไปหาน้อย (ใหญ่สุดก่อน)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# เรียงลำดับด้วย P&L จากน้อยไปหามาก
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

ตัวอย่างแบบสมบูรณ์

Python: วนลูปผ่านทุกหน้า

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """ดึงข้อมูลตำแหน่งวาฬทั้งหมดด้วยการแบ่งหน้า"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # ขนาดแบทช์สูงสุด
            "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"])

        # ตรวจสอบว่ามีหน้าอีกหรือไม่
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# การใช้งาน
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"พบตำแหน่งวาฬ {len(positions)} ตำแหน่ง")

แนวปฏิบัติที่ดีที่สุด

1. ใช้ขีดจำกัดสูงสุด (100-500): เรียกใช้ API น้อยลงเพื่อดึงข้อมูลในปริมาณเดียวกัน จัดการผลลัพธ์เป็นแบทช์อย่างมีประสิทธิภาพ

2. กรองฝั่งเซิร์ฟเวอร์: ใช้พารามิเตอร์การสืบค้นเพื่อกรองที่ต้นทาง ไม่ใช่ในโค้ดแอปพลิเคชันของคุณ ลดการถ่ายโอนข้อมูล

3. เรียงลำดับฝั่งเซิร์ฟเวอร์: ขอผลลัพธ์ที่เรียงลำดับจาก API การเรียงลำดับในระดับใหญ่ทำได้มีประสิทธิภาพบนเซิร์ฟเวอร์

4. แคชและแบ่งหน้า: แคชผลลัพธ์ในเครื่องและแบ่งหน้าผ่านข้อมูลที่แคชไว้เพื่อลดการเรียกใช้ API

5. หยุดก่อนหากเป็นไปได้: ไม่จำเป็นต้องดึงทุกหน้า หยุดเมื่อคุณมีข้อมูลเพียงพอสำหรับกรณีการใช้งานของคุณ

เรียนรู้เพิ่มเติม

ศึกษาคู่มืออ้างอิง API ทั้งหมดสำหรับตัวเลือกการกรองและการเรียงลำดับ

ดูเอกสารอ้างอิง REST API