Operaciones por Lotes

Procesa múltiples solicitudes de API en operaciones por lotes. Reduce las llamadas a la API hasta en un 90% y mejora el rendimiento para la recuperación y análisis de datos masivos.

Resumen

Las operaciones por lotes te permiten enviar múltiples solicitudes de API en una sola solicitud HTTP. Esto reduce el número de llamadas a la API, mejora la latencia y es ideal para la recuperación de datos masivos, el monitoreo de múltiples símbolos o el análisis por lotes. Envía hasta 100 solicitudes por lote.

Formato de Solicitud por Lotes

POST a /v1/batch con un array de objetos de solicitud:

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 de Respuesta por Lotes

Recibe todas las respuestas en un solo objeto de respuesta por lotes, indexado por ID de solicitud:

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

Ejemplos de Código

Python: Posiciones de Ballenas por Lotes para Múltiples Símbolos

Python

import requests

def batch_fetch_whale_positions(api_key, symbols):
    """Obtiene posiciones de ballenas para múltiples símbolos en un lote"""

    # Construye las solicitudes por lotes
    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"
        })

    # Envía la solicitud por lotes
    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()

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

    return results

# Uso: Obtiene 5 símbolos en un lote
symbols = ["BTCUSDT", "ETHUSDT", "SOLUSDT", "XRPUSDT", "ADAUSDT"]
positions = batch_fetch_whale_positions("sk_live_abc123xyz789", symbols)
print(f"Posiciones obtenidas para {len(positions)} símbolos")

Beneficios de las Operaciones por Lotes

Llamadas a la API Reducidas

Envía 100 solicitudes en un lote = 1 llamada a la API en lugar de 100. Ahorro masivo de cuota para integraciones de alto volumen.

Rendimiento Mejorado

Una sola solicitud HTTP de ida y vuelta en lugar de 100. Menor latencia y recuperación de datos más rápida para operaciones masivas.

Transacciones Atómicas

Todas las solicitudes en un lote se procesan juntas. Sin fallos parciales en las operaciones por lotes.

Manejo de Errores más Fácil

Procesa estados de respuesta individuales para cada solicitud mientras manejas el lote como una unidad.

Casos de Uso

Monitoreo de múltiples pares de trading: Obtén posiciones de ballenas para 50 símbolos en una sola solicitud por lotes.

Informes diarios: Recopila todos los datos relevantes (tasas de financiación, OI, liquidaciones) en un solo lote.

Análisis de portafolio: Analiza posiciones en múltiples símbolos y exchanges de manera eficiente.

Procesamiento de webhooks: Agrupa múltiples eventos de webhook en llamadas únicas a la API para su análisis.

Optimiza Tus Consultas

Usa operaciones por lotes para maximizar la eficiencia y reducir el uso de cuota de la API.

Ver Referencia de la API