Batch-Operationen

Verarbeiten Sie mehrere API-Anfragen in einzelnen Batch-Operationen. Reduzieren Sie API-Aufrufe um bis zu 90 % und verbessern Sie die Leistung bei der Massendatenabfrage und -analyse.

Übersicht

Batch-Operationen ermöglichen es Ihnen, mehrere API-Anfragen in einer einzigen HTTP-Anfrage zu senden. Dies reduziert die Anzahl der API-Aufrufe, verbessert die Latenz und ist ideal für die Massendatenabfrage, die Überwachung mehrerer Symbole oder die Durchführung von Batch-Analysen. Senden Sie bis zu 100 Anfragen pro Batch.

Batch-Anfrageformat

POST an /v1/batch mit einem Array von Anfrageobjekten:

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-Antwortformat

Erhalten Sie alle Antworten in einem einzigen Batch-Antwortobjekt, indiziert nach Anfrage-ID:

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

Code-Beispiele

Python: Batch-Whale-Positionen für mehrere Symbole

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

Vorteile von Batch-Operationen

Reduzierte API-Aufrufe

Senden Sie 100 Anfragen in einem Batch = 1 API-Aufruf statt 100. Massive Kontingentersparnis für Hochvolumen-Integrationen.

Verbesserte Leistung

Einzelne HTTP-Rundreise statt 100. Geringere Latenz und schnellere Datenabfrage für Massenoperationen.

Atomare Transaktionen

Alle Anfragen in einem Batch werden gemeinsam verarbeitet. Keine Teilausfälle über Batch-Operationen hinweg.

Einfachere Fehlerbehandlung

Verarbeiten Sie individuelle Antwortstatus für jede Anfrage, während Sie den Batch als Einheit behandeln.

Anwendungsfälle

Überwachung mehrerer Handelspaare: Holen Sie sich Whale-Positionen für 50 Symbole in einer Batch-Anfrage.

Tägliche Berichterstattung: Sammeln Sie alle relevanten Daten (Funding Rates, OI, Liquidations) in einem einzigen Batch.

Portfolioanalyse: Analysieren Sie Positionen über mehrere Symbole und Börsen hinweg effizient.

Webhook-Verarbeitung: Bündeln Sie mehrere Webhook-Ereignisse in einzelne API-Aufrufe für die Analyse.

Optimieren Sie Ihre Abfragen

Nutzen Sie Batch-Operationen, um die Effizienz zu maximieren und den API-Kontingentverbrauch zu reduzieren.

API-Referenz anzeigen