Operasi Batch

Proses banyak permintaan API dalam operasi batch tunggal. Kurangi panggilan API hingga 90% dan tingkatkan performa untuk pengambilan dan analisis data massal.

Ikhtisar

Operasi batch memungkinkan Anda mengirim banyak permintaan API dalam satu permintaan HTTP. Ini mengurangi jumlah panggilan API, meningkatkan latensi, dan ideal untuk pengambilan data massal, memantau banyak simbol, atau melakukan analisis batch. Kirim hingga 100 permintaan per 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 berdasarkan 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 Kode

Python: Posisi Paus Batch untuk Beberapa Simbol

Python

import requests

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

    # Bangun 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"
        })

    # Kirim 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 yang Berkurang

Kirim 100 permintaan dalam satu batch = 1 panggilan API, bukan 100. Penghematan kuota besar untuk integrasi volume tinggi.

Performanya Meningkat

Satu permintaan HTTP round-trip, bukan 100. Latensi lebih rendah dan pengambilan data lebih cepat untuk operasi massal.

Transaksi Atomik

Semua permintaan dalam batch diproses bersama. Tidak ada kegagalan parsial dalam operasi batch.

Penanganan Error yang Lebih Mudah

Proses status respons individual untuk setiap permintaan sambil menangani batch sebagai satu unit.

Kasus Penggunaan

Memantau beberapa pasangan perdagangan: Ambil posisi paus untuk 50 simbol dalam satu permintaan batch.

Laporan harian: Kumpulkan semua data relevan (funding rates, OI, likuidasi) dalam satu batch.

Analisis portofolio: Analisis posisi di beberapa simbol dan bursa dengan efisien.

Pemrosesan webhook: Gabungkan beberapa event webhook ke dalam panggilan API tunggal untuk analisis.

Optimalkan Kueri Anda

Gunakan operasi batch untuk memaksimalkan efisiensi dan mengurangi penggunaan kuota API.

Lihat Referensi API