Operasi Batch

Proses pelbagai permintaan API dalam operasi batch tunggal. Kurangkan panggilan API sehingga 90% dan tingkatkan prestasi untuk pengambilan dan analisis data pukal.

Gambaran Keseluruhan

Operasi batch membolehkan anda menghantar pelbagai permintaan API dalam satu permintaan HTTP. Ini mengurangkan bilangan panggilan API, meningkatkan kelajuan, dan sesuai untuk pengambilan data pukal, memantau pelbagai simbol, atau melakukan analisis batch. Hantar sehingga 100 permintaan setiap batch.

Format Permintaan Batch

POST ke /v1/batch dengan array objek permintaan:

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"
    }
  ]
}

Format Respons Batch

Terima semua respons dalam satu objek respons batch, diindeks oleh ID permintaan:

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"
}

Contoh Kod

Python: Posisi Paus Batch untuk Pelbagai Simbol

Python

import requests

def batch_fetch_whale_positions(api_key, symbols):
    """Ambil posisi paus untuk pelbagai simbol dalam satu batch"""

    # Bina permintaan batch
    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"
        })

    # Hantar permintaan batch
    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()

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

    return results

# Penggunaan: Ambil 5 simbol dalam satu batch
symbols = ["BTCUSDT", "ETHUSDT", "SOLUSDT", "XRPUSDT", "ADAUSDT"]
positions = batch_fetch_whale_positions("sk_live_abc123xyz789", symbols)
print(f"Posisi diambil untuk {len(positions)} simbol")

Manfaat Operasi Batch

Panggilan API Dikurangkan

Hantar 100 permintaan dalam satu batch = 1 panggilan API bukan 100. Penjimatan kuota besar untuk integrasi volum tinggi.

Prestasi Ditingkatkan

Satu permintaan HTTP perjalanan pulang-pergi bukan 100. Kelajuan lebih rendah dan pengambilan data lebih pantas untuk operasi pukal.

Transaksi Atomik

Semua permintaan dalam batch diproses bersama. Tiada kegagalan separa dalam operasi batch.

Pengendalian Ralat Lebih Mudah

Proses status respons individu untuk setiap permintaan sambil mengendalikan batch sebagai satu unit.

Kes Penggunaan

Memantau pelbagai pasangan dagangan: Ambil posisi paus untuk 50 simbol dalam satu permintaan batch.

Laporan harian: Kumpulkan semua data berkaitan (kadar pembiayaan, OI, pelupusan) dalam satu batch.

Analisis portfolio: Analisis posisi merentasi pelbagai simbol dan pertukaran dengan cekap.

Pemprosesan Webhook: Batch pelbagai peristiwa webhook ke dalam panggilan API tunggal untuk analisis.

Optimumkan Pertanyaan Anda

Gunakan operasi batch untuk memaksimumkan kecekapan dan mengurangkan penggunaan kuota API.

Lihat Rujukan API