Batch Operace

Zpracujte více API požadavků v jedné batch operaci. Snižte počet API volání až o 90 % a zlepšete výkon pro hromadné získávání a analýzu dat.

Přehled

Batch operace vám umožní odeslat více API požadavků v jednom HTTP požadavku. Tím se sníží počet API volání, zlepší se latence a je ideální pro hromadné získávání dat, sledování více symbolů nebo provádění batch analýz. Odešlete až 100 požadavků na batch.

Formát Batch Požadavku

POST na /v1/batch s polem objektů požadavků:

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

Formát Batch Odpovědi

Obdržíte všechny odpovědi v jednom batch objektu odpovědí, indexovaném podle ID požadavku:

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

Příklady kódu

Python: Batch Whale Positions pro více symbolů

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

Výhody Batch Operací

Snížený počet API volání

Odešlete 100 požadavků v jednom batch = 1 API volání místo 100. Výrazné úspory kvót pro integrace s vysokým objemem.

Zlepšený výkon

Jedno HTTP volání místo 100. Nižší latence a rychlejší získávání dat pro hromadné operace.

Atomické transakce

Všechny požadavky v batch jsou zpracovány společně. Žádné částečné selhání napříč batch operacemi.

Snadnější zpracování chyb

Zpracujte jednotlivé stavy odpovědí pro každý požadavek při zacházení s batch jako s jednotkou.

Případy použití

Sledování více obchodních párů: Získejte pozice velryb pro 50 symbolů v jednom batch požadavku.

Denní reporting: Shromážděte všechna relevantní data (funding rates, OI, liquidace) v jednom batch.

Analýza portfolia: Efektivně analyzujte pozice napříč více symboly a burzami.

Zpracování webhooků: Sdružte více webhook událostí do jednoho API volání pro analýzu.

Optimalizujte své dotazy

Použijte batch operace pro maximalizaci efektivity a snížení využití API kvót.

Zobrazit API Reference