Пакетні операції

Обробляйте множинні 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