Operazioni Batch

Elabora più richieste API in operazioni batch singole. Riduci le chiamate API fino al 90% e migliora le prestazioni per il recupero e l'analisi di dati in blocco.

Panoramica

Le operazioni batch ti permettono di inviare più richieste API in una singola richiesta HTTP. Questo riduce il numero di chiamate API, migliora la latenza ed è ideale per il recupero di dati in blocco, il monitoraggio di più simboli o l'esecuzione di analisi batch. Invia fino a 100 richieste per batch.

Formato della Richiesta Batch

POST a /v1/batch con un array di oggetti richiesta:

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

Formato della Risposta Batch

Ricevi tutte le risposte in un singolo oggetto di risposta batch, indicizzato per ID richiesta:

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

Esempi di Codice

Python: Posizioni delle Balene in Batch per Più Simboli

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

Vantaggi delle Operazioni Batch

Riduzione delle Chiamate API

Invia 100 richieste in un batch = 1 chiamata API invece di 100. Risparmio massiccio di quota per integrazioni ad alto volume.

Prestazioni Migliorate

Singola richiesta HTTP round-trip invece di 100. Latenza ridotta e recupero dati più veloce per operazioni in blocco.

Transazioni Atomiche

Tutte le richieste in un batch vengono elaborate insieme. Nessun fallimento parziale nelle operazioni batch.

Gestione degli Errori Più Semplice

Elabora gli stati delle risposte individuali per ogni richiesta mentre gestisci il batch come un'unità.

Casi d'Uso

Monitoraggio di più coppie di trading: Recupera le posizioni delle balene per 50 simboli in una singola richiesta batch.

Report giornalieri: Raccogli tutti i dati rilevanti (tassi di finanziamento, OI, liquidazioni) in un singolo batch.

Analisi del portafoglio: Analizza le posizioni su più simboli e exchange in modo efficiente.

Elaborazione di webhook: Raggruppa più eventi webhook in singole chiamate API per l'analisi.

Ottimizza le Tue Query

Usa le operazioni batch per massimizzare l'efficienza e ridurre l'uso della quota API.

Consulta il Riferimento API