Batch Operations

Xử lý nhiều yêu cầu API trong các hoạt động batch đơn lẻ. Giảm số lượng cuộc gọi API lên đến 90% và cải thiện hiệu suất cho việc truy xuất và phân tích dữ liệu hàng loạt.

Tổng quan

Batch operations cho phép bạn gửi nhiều yêu cầu API trong một yêu cầu HTTP duy nhất. Điều này giảm số lượng cuộc gọi API, cải thiện độ trễ và lý tưởng cho việc truy xuất dữ liệu hàng loạt, theo dõi nhiều biểu tượng hoặc thực hiện phân tích batch. Gửi tối đa 100 yêu cầu mỗi batch.

Định dạng Yêu cầu Batch

POST đến /v1/batch với một mảng các đối tượng yêu cầu:

JSON

{
  "requests": [
    {
      "id": "req_1",
      "method": "GET",
      "path": "/v1/whales/events?symbol=BTCUSDT"
    },
    {
      "id": "req_2",
      "method": "GET",
      "path": "/v1/whales/events?symbol=ETHUSDT"
    },
    {
      "id": "req_3",
      "method": "GET",
      "path": "/v1/funding-rates?symbol=BTCUSDT"
    }
  ]
}

Định dạng Phản hồi Batch

Nhận tất cả phản hồi trong một đối tượng phản hồi batch duy nhất, được lập chỉ mục theo ID yêu cầu:

JSON

{
  "success": true,
  "responses": {
    "req_1": {
      "status": 200,
      "data": {
        "total": 42,
        "positions": [...]
      }
    },
    "req_2": {
      "status": 200,
      "data": {
        "total": 28,
        "positions": [...]
      }
    },
    "req_3": {
      "status": 200,
      "data": {...}
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ví dụ mã

Python: Batch Whale Positions cho nhiều biểu tượng

Python

import requests

def batch_fetch_whale_positions(api_key, symbols):
    """Fetch whale positions for multiple symbols in one batch"""

    # Build batch requests
    requests_list = []
    for i, symbol in enumerate(symbols):
        requests_list.append({
            "id": f"req_{i+1}",
            "method": "GET",
            "path": f"/v1/whales/events?symbol={symbol}&limit=50"
        })

    # Send batch request
    response = requests.post(
        "https://api.smartmoneyapi.com/v1/batch",
        headers={
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        },
        json={"requests": requests_list}
    )

    batch_response = response.json()

    # Process responses
    results = {}
    for symbol, response in zip(symbols, batch_response["responses"].values()):
        if response["status"] == 200:
            results[symbol] = response["data"]["positions"]

    return results

# Usage: Fetch 5 symbols in one batch
symbols = ["BTCUSDT", "ETHUSDT", "SOLUSDT", "XRPUSDT", "ADAUSDT"]
positions = batch_fetch_whale_positions("sk_live_abc123xyz789", symbols)
print(f"Fetched positions for {len(positions)} symbols")

Lợi ích của Batch Operations

Giảm số lượng cuộc gọi API

Gửi 100 yêu cầu trong một batch = 1 cuộc gọi API thay vì 100. Tiết kiệm hạn ngạch lớn cho các tích hợp khối lượng cao.

Cải thiện hiệu suất

Một yêu cầu HTTP đi và về duy nhất thay vì 100. Độ trễ thấp hơn và truy xuất dữ liệu nhanh hơn cho các hoạt động hàng loạt.

Giao dịch nguyên tử

Tất cả các yêu cầu trong một batch được xử lý cùng nhau. Không có lỗi một phần trong các hoạt động batch.

Xử lý lỗi dễ dàng hơn

Xử lý trạng thái phản hồi riêng lẻ cho từng yêu cầu trong khi xử lý batch như một đơn vị.

Các trường hợp sử dụng

Theo dõi nhiều cặp giao dịch: Truy xuất vị trí cá voi cho 50 biểu tượng trong một yêu cầu batch.

Báo cáo hàng ngày: Thu thập tất cả dữ liệu liên quan (tỷ lệ funding, OI, thanh lý) trong một batch duy nhất.

Phân tích danh mục đầu tư: Phân tích vị trí trên nhiều biểu tượng và sàn giao dịch một cách hiệu quả.

Xử lý webhook: Batch nhiều sự kiện webhook thành các cuộc gọi API đơn lẻ để phân tích.

Tối ưu hóa truy vấn của bạn

Sử dụng batch operations để tối đa hóa hiệu quả và giảm sử dụng hạn ngạch API.

Xem Tài liệu API