Batch Operations

Verwerk meerdere API-verzoeken in enkele batchbewerkingen. Verminder API-aanroepen met tot 90% en verbeter de prestaties voor bulkgegevensophaling en -analyse.

Overzicht

Met batchbewerkingen kun je meerdere API-verzoeken in één HTTP-verzoek versturen. Dit vermindert het aantal API-aanroepen, verbetert de latentie en is ideaal voor bulkgegevensophaling, het monitoren van meerdere symbolen of het uitvoeren van batchanalyse. Verstuur tot 100 verzoeken per batch.

Batchverzoekformaat

POST naar /v1/batch met een array van verzoekobjecten:

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

Batchreactieformaat

Ontvang alle reacties in één batchreactieobject, geïndexeerd op verzoek-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"
}

Codevoorbeelden

Python: Batch Whale-posities voor meerdere symbolen

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

Voordelen van Batchbewerkingen

Verminderde API-aanroepen

Verstuur 100 verzoeken in één batch = 1 API-aanroep in plaats van 100. Enorme quotumbesparingen voor hoogvolume-integraties.

Verbeterde prestaties

Eén enkele HTTP-verzoekronde in plaats van 100. Lagere latentie en snellere gegevensophaling voor bulkbewerkingen.

Atomische transacties

Alle verzoeken in een batch worden samen verwerkt. Geen gedeeltelijke fouten bij batchbewerkingen.

Eenvoudiger foutafhandeling

Verwerk individuele reactiestatus voor elk verzoek terwijl de batch als eenheid wordt behandeld.

Gebruiksvoorbeelden

Meerdere handelsparen monitoren: Haal walvisposities op voor 50 symbolen in één batchverzoek.

Dagelijkse rapportage: Verzamel alle relevante gegevens (financieringspercentages, OI, liquidaties) in één batch.

Portefeuilleanalyse: Analyseer posities over meerdere symbolen en beurzen efficiënt.

Webhookverwerking: Verwerk meerdere webhookgebeurtenissen in enkele API-aanroepen voor analyse.

Optimaliseer uw query's

Gebruik batchbewerkingen om de efficiëntie te maximaliseren en API-quotumgebruik te verminderen.

Bekijk API-referentie