Operações em Lote

Processe múltiplas solicitações de API em operações em lote únicas. Reduza chamadas de API em até 90% e melhore o desempenho para recuperação e análise de dados em massa.

Visão Geral

Operações em lote permitem enviar múltiplas solicitações de API em uma única requisição HTTP. Isso reduz a contagem de chamadas de API, melhora a latência e é ideal para recuperação de dados em massa, monitoramento de múltiplos símbolos ou realização de análises em lote. Envie até 100 solicitações por lote.

Formato de Solicitação em Lote

POST para /v1/batch com um array de objetos de solicitação:

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 Resposta em Lote

Receba todas as respostas em um único objeto de resposta em lote, indexado por ID de solicitação:

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

Exemplos de Código

Python: Posições de Baleias em Lote para Múltiplos Símbolos

Python

import requests

def batch_fetch_whale_positions(api_key, symbols):
    """Busca posições de baleias para múltiplos símbolos em um lote"""

    # Constrói solicitações em lote
    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"
        })

    # Envia solicitação em lote
    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()

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

    return results

# Uso: Busca 5 símbolos em um lote
symbols = ["BTCUSDT", "ETHUSDT", "SOLUSDT", "XRPUSDT", "ADAUSDT"]
positions = batch_fetch_whale_positions("sk_live_abc123xyz789", symbols)
print(f"Posições buscadas para {len(positions)} símbolos")

Benefícios das Operações em Lote

Chamadas de API Reduzidas

Envie 100 solicitações em um lote = 1 chamada de API em vez de 100. Economia massiva de cota para integrações de alto volume.

Desempenho Aprimorado

Única requisição HTTP de ida e volta em vez de 100. Menor latência e recuperação de dados mais rápida para operações em massa.

Transações Atômicas

Todas as solicitações em um lote são processadas juntas. Sem falhas parciais em operações em lote.

Tratamento de Erros Facilitado

Processe status de resposta individuais para cada solicitação enquanto trata o lote como uma unidade.

Casos de Uso

Monitoramento de múltiplos pares de negociação: Busque posições de baleias para 50 símbolos em uma única solicitação em lote.

Relatórios diários: Colete todos os dados relevantes (taxas de financiamento, OI, liquidações) em um único lote.

Análise de portfólio: Analise posições em múltiplos símbolos e exchanges com eficiência.

Processamento de webhooks: Agrupe múltiplos eventos de webhook em chamadas de API únicas para análise.

Otimize Suas Consultas

Use operações em lote para maximizar a eficiência e reduzir o uso de cota da API.

Ver Referência da API