Phân trang, Lọc và Sắp xếp

Làm chủ việc truy xuất dữ liệu hiệu quả với phân trang, lọc và sắp xếp. Học cách tối ưu truy vấn và giảm số lần gọi API bằng cách sử dụng các tham số truy vấn.

Phân trang

Smart Money API sử dụng phân trang dựa trên con trỏ để truy xuất dữ liệu hiệu quả. Chỉ định số trang và giới hạn để kiểm soát tập kết quả.

Tham số	Loại	Mặc định	Tối đa
page	integer	1	N/A
limit	integer	50	500

Ví dụ Phân trang

cURL

# Lấy 100 kết quả đầu tiên
curl "https://api.smartmoneyapi.com/v1/whales/events?page=1&limit=100"

# Lấy trang thứ hai
curl "https://api.smartmoneyapi.com/v1/whales/events?page=2&limit=100"

Thông tin Phân trang Phản hồi

JSON

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

Lọc

Lọc kết quả theo symbol, sàn giao dịch, hướng và các tiêu chí khác. Các bộ lọc được kết hợp với logic AND.

Bộ lọc	Giá trị	Ví dụ
symbol	Cặp giao dịch	BTCUSDT, ETHUSDT
exchange	bybit, binance, hyperliquid	bybit
direction	long, short	long
min_position_size	Số	10.5
min_pnl_percent	Số	2.0

Ví dụ Lọc

cURL

# Lọc theo symbol và hướng
curl "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&direction=long"

# Lọc theo sàn giao dịch và kích thước vị thế tối thiểu
curl "https://api.smartmoneyapi.com/v1/whales/events?exchange=bybit&min_position_size=15"

Sắp xếp

Sắp xếp kết quả theo kích thước vị thế, P&L hoặc các trường khác. Chỉ định trường và hướng (asc/desc).

cURL

# Sắp xếp theo kích thước vị thế giảm dần (lớn nhất đầu tiên)
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=position_sizeℴ=desc"

# Sắp xếp theo P&L tăng dần
curl "https://api.smartmoneyapi.com/v1/whales/events?sort=pnl_percentℴ=asc"

Ví dụ Hoàn chỉnh

Python: Lặp qua Tất cả các Trang

Python

import requests

def get_all_whale_positions(api_key, symbol=None):
    """Lấy tất cả vị thế cá voi với phân trang"""
    all_positions = []
    page = 1

    while True:
        params = {
            "page": page,
            "limit": 100,  # Kích thước lô tối đa
            "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"])

        # Kiểm tra xem còn trang nào không
        if not data["pagination"]["has_next"]:
            break

        page += 1

    return all_positions

# Sử dụng
positions = get_all_whale_positions("sk_live_abc123xyz789", symbol="BTCUSDT")
print(f"Tìm thấy {len(positions)} vị thế cá voi")

Thực hành Tốt nhất

1. Sử dụng giới hạn tối đa (100-500): Ít lần gọi API hơn để truy xuất cùng lượng dữ liệu. Xử lý kết quả theo lô hiệu quả.

2. Lọc phía máy chủ: Sử dụng tham số truy vấn để lọc tại nguồn, không phải trong mã ứng dụng của bạn. Giảm lượng dữ liệu truyền tải.

3. Sắp xếp trên máy chủ: Yêu cầu kết quả đã sắp xếp từ API. Sắp xếp ở quy mô lớn hiệu quả trên máy chủ.

4. Lưu trữ và phân trang: Lưu trữ kết quả cục bộ và phân trang qua dữ liệu đã lưu để giảm thiểu lần gọi API.

5. Dừng sớm nếu có thể: Không phải lúc nào cũng lấy tất cả các trang. Dừng khi bạn có đủ dữ liệu cho trường hợp sử dụng của mình.

Tìm hiểu Thêm

Khám phá tài liệu API đầy đủ cho tất cả các tùy chọn lọc và sắp xếp.

Xem Tài liệu Tham khảo REST API