Opérations par lots

Traitez plusieurs requêtes API en une seule opération par lot. Réduisez les appels API jusqu'à 90 % et améliorez les performances pour la récupération et l'analyse de données en masse.

Aperçu

Les opérations par lots vous permettent d'envoyer plusieurs requêtes API en une seule requête HTTP. Cela réduit le nombre d'appels API, améliore la latence et est idéal pour la récupération de données en masse, la surveillance de plusieurs symboles ou l'exécution d'analyses par lots. Envoyez jusqu'à 100 requêtes par lot.

Format de requête par lot

POST vers /v1/batch avec un tableau d'objets de requête :

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 de réponse par lot

Recevez toutes les réponses dans un seul objet de réponse par lot, indexé par ID de requête :

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

Exemples de code

Python : Positions des baleines par lot pour plusieurs symboles

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

Avantages des opérations par lots

Réduction des appels API

Envoyez 100 requêtes en un seul lot = 1 appel API au lieu de 100. Économies massives de quota pour les intégrations à haut volume.

Amélioration des performances

Une seule requête HTTP aller-retour au lieu de 100. Latence réduite et récupération de données plus rapide pour les opérations en masse.

Transactions atomiques

Toutes les requêtes d'un lot sont traitées ensemble. Aucun échec partiel dans les opérations par lots.

Gestion des erreurs simplifiée

Traitez les statuts de réponse individuels pour chaque requête tout en gérant le lot comme une unité.

Cas d'utilisation

Surveillance de plusieurs paires de trading : Récupérez les positions des baleines pour 50 symboles en une seule requête par lot.

Rapports quotidiens : Collectez toutes les données pertinentes (taux de financement, OI, liquidations) en un seul lot.

Analyse de portefeuille : Analysez les positions sur plusieurs symboles et échanges de manière efficace.

Traitement des webhooks : Regroupez plusieurs événements de webhook en un seul appel API pour l'analyse.

Optimisez vos requêtes

Utilisez les opérations par lots pour maximiser l'efficacité et réduire l'utilisation du quota API.

Consultez la référence API