Пакетные операции

Обрабатывайте несколько API-запросов в рамках одной пакетной операции. Сократите количество вызовов API до 90% и повысьте производительность при массовом получении и анализе данных.

Обзор

Пакетные операции позволяют отправлять несколько API-запросов в одном HTTP-запросе. Это сокращает количество вызовов API, уменьшает задержки и идеально подходит для массового получения данных, мониторинга нескольких символов или выполнения пакетного анализа. Отправляйте до 100 запросов в одном пакете.

Формат пакетного запроса

Отправьте POST-запрос на /v1/batch с массивом объектов запросов:

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

Формат пакетного ответа

Получите все ответы в одном объекте пакетного ответа, индексированном по ID запроса:

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

Примеры кода

Python: Пакетное получение позиций китов для нескольких символов

Python

import requests

def batch_fetch_whale_positions(api_key, symbols):
    """Получение позиций китов для нескольких символов в одном пакете"""

    # Создание пакетных запросов
    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"
        })

    # Отправка пакетного запроса
    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()

    # Обработка ответов
    results = {}
    for symbol, response in zip(symbols, batch_response["responses"].values()):
        if response["status"] == 200:
            results[symbol] = response["data"]["positions"]

    return results

# Использование: Получение данных для 5 символов в одном пакете
symbols = ["BTCUSDT", "ETHUSDT", "SOLUSDT", "XRPUSDT", "ADAUSDT"]
positions = batch_fetch_whale_positions("sk_live_abc123xyz789", symbols)
print(f"Получены позиции для {len(positions)} символов")

Преимущества пакетных операций

Сокращение количества вызовов API

Отправьте 100 запросов в одном пакете = 1 вызов API вместо 100. Значительная экономия квоты для интеграций с высокой нагрузкой.

Повышенная производительность

Один HTTP-запрос вместо 100. Меньшая задержка и более быстрое получение данных для массовых операций.

Атомарные транзакции

Все запросы в пакете обрабатываются вместе. Нет частичных сбоев при пакетных операциях.

Упрощенная обработка ошибок

Обрабатывайте статусы ответов для каждого запроса, работая с пакетом как с единым целым.

Варианты использования

Мониторинг нескольких торговых пар: Получение позиций китов для 50 символов в одном пакетном запросе.

Ежедневная отчетность: Сбор всех необходимых данных (ставки финансирования, открытый интерес, ликвидации) в одном пакете.

Анализ портфеля: Эффективный анализ позиций по нескольким символам и биржам.

Обработка вебхуков: Объединение нескольких событий вебхуков в один API-вызов для анализа.

Оптимизация запросов

Используйте пакетные операции для максимальной эффективности и сокращения использования квоты API.

См. справочник API