Batch Operations

Bearbeta flera API-förfrågningar i en enda batchoperation. Minska API-anrop med upp till 90 % och förbättra prestandan för masshämtning och analys av data.

Översikt

Batchoperationer låter dig skicka flera API-förfrågningar i en enda HTTP-förfrågan. Detta minskar antalet API-anrop, förbättrar svarstiden och är idealiskt för masshämtning av data, övervakning av flera symboler eller utförande av batchanalys. Skicka upp till 100 förfrågningar per batch.

Format för batchförfrågan

POST till /v1/batch med en array av förfrågningsobjekt:

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 för batchsvar

Få alla svar i ett enda batchsvarsobjekt, indexerat efter förfrågnings-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"
}

Kodexempel

Python: Batchhämta valpositioner för flera symboler

Python

import requests

def batch_fetch_whale_positions(api_key, symbols):
    """Hämta valpositioner för flera symboler i en batch"""

    # Bygg batchförfrågningar
    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"
        })

    # Skicka batchförfrågan
    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()

    # Bearbeta svar
    results = {}
    for symbol, response in zip(symbols, batch_response["responses"].values()):
        if response["status"] == 200:
            results[symbol] = response["data"]["positions"]

    return results

# Användning: Hämta 5 symboler i en batch
symbols = ["BTCUSDT", "ETHUSDT", "SOLUSDT", "XRPUSDT", "ADAUSDT"]
positions = batch_fetch_whale_positions("sk_live_abc123xyz789", symbols)
print(f"Hämtade positioner för {len(positions)} symboler")

Fördelar med batchoperationer

Färre API-anrop

Skicka 100 förfrågningar i en batch = 1 API-anrop istället för 100. Stora besparingar i kvot för integrationer med hög volym.

Förbättrad prestanda

En enda HTTP-förfrågan istället för 100. Lägre svarstid och snabbare datahämtning för bulkoperationer.

Atomära transaktioner

Alla förfrågningar i en batch bearbetas tillsammans. Inga delvisa fel i batchoperationer.

Enklare felhantering

Bearbeta individuella svarsstatusar för varje förfrågan samtidigt som batchen hanteras som en enhet.

Användningsfall

Övervakning av flera handelspar: Hämta valpositioner för 50 symboler i en batchförfrågan.

Daglig rapportering: Samla all relevant data (finansieringsräntor, OI, likvidationer) i en enda batch.

Portföljanalys: Analysera positioner över flera symboler och börser effektivt.

Webhook-bearbetning: Batcha flera webhook-händelser till enstaka API-anrop för analys.

Optimera dina förfrågningar

Använd batchoperationer för att maximera effektiviteten och minska API-kvotanvändningen.

Visa API-referens