Operacje wsadowe

Przetwarzaj wiele żądań API w pojedynczych operacjach wsadowych. Zmniejsz liczbę wywołań API nawet o 90% i popraw wydajność przy pobieraniu i analizie danych zbiorczych.

Przegląd

Operacje wsadowe pozwalają na wysłanie wielu żądań API w jednym żądaniu HTTP. Zmniejsza to liczbę wywołań API, poprawia opóźnienia i jest idealne do pobierania danych zbiorczych, monitorowania wielu symboli lub wykonywania analiz wsadowych. Można wysłać do 100 żądań w jednej partii.

Format żądania wsadowego

Wykonaj POST na /v1/batch z tablicą obiektów żądań:

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 odpowiedzi wsadowej

Otrzymaj wszystkie odpowiedzi w jednym obiekcie odpowiedzi wsadowej, indeksowanym przez ID żądania:

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

Przykłady kodu

Python: Pozycje wielorybów dla wielu symboli w partii

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

Korzyści operacji wsadowych

Zmniejszona liczba wywołań API

Wyślij 100 żądań w jednej partii = 1 wywołanie API zamiast 100. Ogromne oszczędności limitów dla integracji o wysokim wolumenie.

Poprawiona wydajność

Pojedyncze żądanie HTTP zamiast 100. Niższe opóźnienia i szybsze pobieranie danych dla operacji zbiorczych.

Transakcje atomowe

Wszystkie żądania w partii są przetwarzane razem. Brak częściowych błędów w operacjach wsadowych.

Łatwiejsze obsługiwanie błędów

Przetwarzaj indywidualne statusy odpowiedzi dla każdego żądania, jednocześnie traktując partię jako całość.

Przypadki użycia

Monitorowanie wielu par handlowych: Pobierz pozycje wielorybów dla 50 symboli w jednym żądaniu wsadowym.

Codzienne raportowanie: Zbierz wszystkie istotne dane (stawki finansowania, OI, likwidacje) w jednej partii.

Analiza portfela: Analizuj pozycje na wielu symbolach i giełdach efektywnie.

Przetwarzanie webhooków: Grupuj wiele zdarzeń webhooków w pojedyncze wywołania API do analizy.

Optymalizuj swoje zapytania

Używaj operacji wsadowych, aby zmaksymalizować efektywność i zmniejszyć wykorzystanie limitu API.

Zobacz dokumentację API