Operațiuni Batch

Procesați mai multe cereri API într-o singură operațiune batch. Reduceți numărul de apeluri API cu până la 90% și îmbunătățiți performanța pentru preluarea și analiza datelor în masă.

Prezentare generală

Operațiunile batch vă permit să trimiteți mai multe cereri API într-un singur apel HTTP. Acest lucru reduce numărul de apeluri API, îmbunătățește latența și este ideal pentru preluarea datelor în masă, monitorizarea mai multor simboluri sau efectuarea de analize batch. Trimiteți până la 100 de cereri per batch.

Formatul Cererii Batch

POST către /v1/batch cu un array de obiecte de cerere:

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

Formatul Răspunsului Batch

Primiți toate răspunsurile într-un singur obiect de răspuns batch, indexat după ID-ul cererii:

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

Exemple de Cod

Python: Poziții de Whale pentru Mai Multe Simboluri

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

Beneficiile Operațiunilor Batch

Apeluri API Reduse

Trimiteți 100 de cereri într-un singur batch = 1 apel API în loc de 100. Economii masive de cotă pentru integrațiile cu volum mare.

Performanță Îmbunătățită

Un singur apel HTTP dus-întors în loc de 100. Latență mai mică și preluare mai rapidă a datelor pentru operațiuni în masă.

Tranzacții Atomice

Toate cererile dintr-un batch sunt procesate împreună. Nu există eșecuri parțiale în operațiunile batch.

Gestionare Mai Ușoară a Erorilor

Procesați stările individuale ale răspunsurilor pentru fiecare cerere în timp ce gestionați batch-ul ca o unitate.

Cazuri de Utilizare

Monitorizarea mai multor perechi de tranzacționare: Preluați poziții de whale pentru 50 de simboluri într-o singură cerere batch.

Rapoarte zilnice: Colectați toate datele relevante (rate de finanțare, OI, lichidări) într-un singur batch.

Analiza portofoliului: Analizați pozițiile pe mai multe simboluri și exchange-uri în mod eficient.

Procesarea webhook-urilor: Îmbinați mai multe evenimente webhook în apeluri API unice pentru analiză.

Optimizați-vă Interogările

Utilizați operațiuni batch pentru a maximiza eficiența și a reduce utilizarea cotei API.

Vizualizați Referința API