Toplu İşlemler

Tek bir toplu işlemde birden çok API isteğini işleyin. API çağrılarını %90'a kadar azaltın ve toplu veri alımı ve analizi için performansı artırın.

Genel Bakış

Toplu işlemler, tek bir HTTP isteği içinde birden çok API isteği göndermenize olanak tanır. Bu, API çağrı sayısını azaltır, gecikmeyi iyileştirir ve toplu veri alımı, birden çok sembolü izleme veya toplu analiz yapma için idealdir. Toplu başına 100 istek gönderebilirsiniz.

Toplu İstek Formatı

/v1/batch adresine bir istek nesneleri dizisi ile POST yapın:

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

Toplu Yanıt Formatı

Tüm yanıtları, istek kimliğine göre indekslenmiş tek bir toplu yanıt nesnesi içinde alın:

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

Kod Örnekleri

Python: Birden Çok Sembol için Toplu Balina Pozisyonları

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

Toplu İşlemlerin Faydaları

Azaltılmış API Çağrıları

100 isteği tek bir toplu işlemde gönderin = 100 yerine 1 API çağrısı. Yüksek hacimli entegrasyonlar için büyük kota tasarrufu.

İyileştirilmiş Performans

100 yerine tek bir gidiş-dönüş HTTP isteği. Toplu işlemler için daha düşük gecikme ve daha hızlı veri alımı.

Atomik İşlemler

Toplu işlemdeki tüm istekler birlikte işlenir. Toplu işlemler arasında kısmi hata olmaz.

Daha Kolay Hata Yönetimi

Toplu işlemi bir birim olarak ele alırken her istek için ayrı yanıt durumlarını işleyin.

Kullanım Senaryoları

Birden çok işlem çiftini izleme: Tek bir toplu istekle 50 sembol için balina pozisyonlarını alın.

Günlük raporlama: Tek bir toplu işlemde tüm ilgili verileri (fonlama oranları, açık pozisyonlar, likidasyonlar) toplayın.

Portföy analizi: Birden çok sembol ve borsa üzerindeki pozisyonları verimli bir şekilde analiz edin.

Webhook işleme: Analiz için birden çok webhook olayını tek API çağrısına toplayın.

Sorgularınızı Optimize Edin

Verimliliği artırmak ve API kota kullanımını azaltmak için toplu işlemleri kullanın.

API Referansını Görüntüleyin