Batch műveletek

Több API kérés feldolgozása egyetlen batch műveletben. Csökkentse az API hívások számát akár 90%-kal, és javítsa a teljesítményt tömeges adatlekérdezés és elemzés esetén.

Áttekintés

A batch műveletek lehetővé teszik, hogy több API kérést egyetlen HTTP kérésben küldjön. Ez csökkenti az API hívások számát, javítja a késleltetést, és ideális tömeges adatlekérdezéshez, több szimbólum monitorozásához vagy batch elemzés végrehajtásához. Akár 100 kérést küldhet egy batch-ben.

Batch kérés formátuma

POST kérés a /v1/batch végpontra egy kérés objektumokból álló tömbbel:

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

Batch válasz formátuma

Minden választ egyetlen batch válasz objektumban kap meg, kérés azonosító szerint indexelve:

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

Kód példák

Python: Batch Whale pozíciók több szimbólumra

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

Batch műveletek előnyei

Csökkentett API hívások

100 kérés küldése egy batch-ben = 1 API hívás 100 helyett. Nagy kvóta megtakarítás nagy volumenű integrációk esetén.

Javított teljesítmény

Egyetlen körkörös HTTP kérés 100 helyett. Alacsonyabb késleltetés és gyorsabb adatlekérdezés tömeges műveletek esetén.

Atomi tranzakciók

Egy batch-ben lévő összes kérés együtt kerül feldolgozásra. Nincs részleges hibák a batch műveletek során.

Egyszerűbb hibakezelés

Egyéni válasz állapotok feldolgozása minden kéréshez, miközben a batch egységként kezelhető.

Használati esetek

Több kereskedési pár monitorozása: Whale pozíciók lekérése 50 szimbólumra egy batch kérésben.

Napi jelentéskészítés: Az összes releváns adat gyűjtése (finanszírozási ráta, nyitott pozíciók, likvidációk) egyetlen batch-ben.

Portfólió elemzés: Pozíciók elemzése több szimbólum és tőzsde között hatékonyan.

Webhook feldolgozás: Több webhook esemény batch-be csoportosítása egyetlen API hívással elemzés céljából.

Optimalizálja lekérdezéseit

Használja a batch műveleteket a hatékonyság maximalizálására és az API kvóta használat csökkentésére.

API referencia megtekintése