Batch Operations

Prosesuhin ang maraming API request sa iisang batch operations. Bawasan ang API calls hanggang 90% at pagbutihin ang performance para sa bulk data retrieval at analysis.

Pangkalahatang-ideya

Ang batch operations ay nagpapahintulot sa iyo na magpadala ng maraming API request sa isang HTTP request lamang. Binabawasan nito ang bilang ng API call, pinapabuti ang latency, at mainam para sa bulk data retrieval, pagmomonitor ng maraming simbolo, o paggawa ng batch analysis. Maaaring magpadala ng hanggang 100 request bawat batch.

Batch Request Format

POST sa /v1/batch kasama ang isang array ng mga request object:

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

Batch Response Format

Tumanggap ng lahat ng tugon sa isang batch response object, na naka-index ayon sa request 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"
}

Mga Halimbawa ng Code

Python: Batch Whale Positions para sa Maraming Simbolo

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

Mga Benepisyo ng Batch Operations

Nabawasang API Calls

Magpadala ng 100 request sa isang batch = 1 API call imbes na 100. Malaking pagtitipid sa quota para sa high-volume integrations.

Pinabuting Performance

Isang round-trip HTTP request imbes na 100. Mas mababang latency at mas mabilis na data retrieval para sa bulk operations.

Atomic Transactions

Lahat ng request sa isang batch ay pinoproseso nang sabay-sabay. Walang partial failures sa batch operations.

Mas Madaling Error Handling

Prosesuhin ang indibidwal na response statuses para sa bawat request habang hinahandle ang batch bilang isang unit.

Mga Use Cases

Pagmomonitor ng maraming trading pairs: Kunin ang whale positions para sa 50 simbolo sa isang batch request.

Araw-araw na pag-uulat: Kolektahin ang lahat ng relevant data (funding rates, OI, liquidations) sa isang batch.

Portfolio analysis: Suriin ang mga posisyon sa maraming simbolo at exchange nang mahusay.

Webhook processing: I-batch ang maraming webhook event sa isang API call para sa analysis.

Optimize Your Queries

Gamitin ang batch operations para mapakinabangan ang efficiency at mabawasan ang API quota usage.

Tingnan ang API Reference