Ομαδικές Λειτουργίες

Επεξεργαστείτε πολλαπλά αιτήματα 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"
    }
  ]
}

Μορφή Ομαδικής Απάντησης

Λάβετε όλες τις απαντήσεις σε ένα μόνο αντικείμενο ομαδικής απάντησης, ευρετηριασμένο με το αναγνωριστικό αιτήματος:

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

Οφέλη των Ομαδικών Λειτουργιών

Μειωμένες Κλήσεις API

Στείλτε 100 αιτήματα σε μια ομάδα = 1 κλήση API αντί για 100. Μεγάλη εξοικονόμηση ποσοστού για ενσωματώσεις υψηλού όγκου.

Βελτιωμένη Απόδοση

Ενιαίο αίτημα HTTP αντί για 100. Μικρότερη καθυστέρηση και ταχύτερη ανάκτηση δεδομένων για μαζικές λειτουργίες.

Ατομικές Συναλλαγές

Όλα τα αιτήματα σε μια ομάδα επεξεργάζονται μαζί. Χωρίς μερικές αποτυχίες σε ομαδικές λειτουργίες.

Ευκολότερη Διαχείριση Σφαλμάτων

Επεξεργαστείτε μεμονωμένες καταστάσεις απάντησης για κάθε αίτημα ενώ διαχειρίζεστε την ομάδα ως μια ενότητα.

Περιπτώσεις Χρήσης

Παρακολούθηση πολλαπλών ζευγών συναλλαγών: Ανακτήστε θέσεις φαλαινών για 50 σύμβολα σε ένα ομαδικό αίτημα.

Ημερήσια αναφορά: Συλλέξτε όλα τα σχετικά δεδομένα (ποσοστά χρηματοδότησης, OI, εκκαθαρίσεις) σε μια ομάδα.

Ανάλυση χαρτοφυλακίου: Αναλύστε θέσεις σε πολλαπλά σύμβολα και ανταλλακτήρια αποτελεσματικά.

Επεξεργασία Webhook: Ομαδοποιήστε πολλαπλά συμβάντα webhook σε μεμονωμένες κλήσεις API για ανάλυση.

Βελτιστοποιήστε τα Ερωτήματά σας

Χρησιμοποιήστε ομαδικές λειτουργίες για να μεγιστοποιήσετε την αποδοτικότητα και να μειώσετε τη χρήση ποσοστού API.

Δείτε την Αναφορά API