Πλήρης Αναφορά REST API

Κυριεύστε το Smart Money API με την ολοκληρωμένη μας αναφορά REST. Μάθετε όλα τα endpoints, παραμέτρους, μεθόδους πιστοποίησης και πραγματικά μοτίβα ενσωμάτωσης για πληροφορίες παραγώγων κρυπτονομισμάτων και δεδομένα παρακολούθησης φαλαινών.

Επισκόπηση

Το Smart Money API παρέχει RESTful πρόσβαση σε δεδομένα παραγώγων κρυπτονομισμάτων σε πραγματικό χρόνο σε τρεις μεγάλες ανταλλαγές: Bybit, Binance και Hyperliquid. Το API μας συγκεντρώνει θέσεις πορτοφολιών φαλαινών, ποσοστά χρηματοδότησης, μετρήσεις ανοιχτού ενδιαφέροντος, δεδομένα ρευστοποίησης και σήματα αλυσίδας σε μια ενιαία διεπαφή. Είτε δημιουργείτε αλγόριθμους συναλλαγών, συστήματα διαχείρισης κινδύνου ή εργαλεία ανάλυσης αγοράς, το REST API σας δίνει άμεση προγραμματιστική πρόσβαση σε όλη την ευφυΐα Smart Money.

Με πάνω από 229 αυτόματα ανακαλυφθέντα σύμβολα συναλλαγών και 600+ παρακολουθούμενα πορτοφόλια φαλαινών, το API παρέχει ολοκληρωμένες πληροφορίες αγοράς. Οι συνδέσεις WebSocket σε πραγματικό χρόνο παρέχουν ενημερώσεις σε λιγότερο από ένα δευτερόλεπτο, ενώ τα REST endpoints μας χειρίζονται ομαδικά ερωτήματα, ανάκτηση ιστορικών δεδομένων και ανάλυση χαρτοφυλακίου σε κλίμακα.

Όλα τα αιτήματα πρέπει να περιλαμβάνουν έγκυρα διαπιστευτήρια πιστοποίησης. Οι χρήστες δωρεάν tier έχουν 20 αιτήματα την ημέρα περιορισμένα στο BTC. Το Trader tier (400 αιτήματα/ημέρα) και το Pro tier (4,000 αιτήματα/ημέρα) ξεκλειδώνουν όλα τα σύμβολα και τις προηγμένες λειτουργίες.

Πιστοποίηση

Το Smart Money API χρησιμοποιεί πιστοποίηση με κλειδί API. Η κύρια μέθοδος είναι η X-API-Key κεφαλίδα αιτήματος. Μπορείτε να δημιουργήσετε κλειδιά API από τον πίνακα ελέγχου σας. Ένα JWT συνεδρίας μέσω Authorization: Bearer γίνεται δεκτό ως εφεδρικό για συνεδρίες προγράμματος περιήγησης/πίνακα ελέγχου, αλλά οι πελάτες API θα πρέπει να χρησιμοποιούν X-API-Key.

Πιστοποίηση με Κλειδί API (πρωτεύουσα)

Στείλτε το κλειδί API σας στην X-API-Key κεφαλίδα σε κάθε αίτημα. Ποτέ μην τοποθετείτε το κλειδί σας σε μια URL.

HTTP

GET /v1/whales/events HTTP/1.1
Host: api.smartmoneyapi.com
X-API-Key: sm_your_key
Content-Type: application/json

JWT Συνεδρίας (εφεδρικό)

Οι συνεδρίες προγράμματος περιήγησης/πίνακα ελέγχου μπορούν να περάσουν ένα JWT συνεδρίας μέσω Authorization: Bearer (έγκυρο για 24 ώρες). Οι προγραμματιστικοί πελάτες θα πρέπει να προτιμούν X-API-Key.

Python

import requests
import json

# Λήψη διακριτικού JWT
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# Χρήση JWT για επόμενα αιτήματα
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Βασική URL & Endpoints

Όλα τα αιτήματα API πηγαίνουν στην https://api.smartmoneyapi.com. Το API είναι οργανωμένο σε λογικές κατηγορίες πόρων με προθέματα έκδοσης. Η τρέχουσα σταθερή έκδοση είναι η v1.

Βασική URL: https://api.smartmoneyapi.com/api/v1

URL WebSocket: wss://ws.smartmoneyapi.com/stream

Μορφή Απάντησης

Όλες οι απαντήσεις API επιστρέφονται ως αντικείμενα JSON με μια τυπική μορφή φακέλου. Οι επιτυχείς απαντήσεις επιστρέφουν κωδικούς κατάστασης HTTP 200-299 με δεδομένα στο σώμα της απάντησης. Οι απαντήσεις σφάλματος περιλαμβάνουν λεπτομερή μηνύματα σφάλματος και προτάσεις επίλυσης.

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [
      {
        "wallet_address": "0x1234...",
        "symbol": "BTCUSDT",
        "position_size": 15.5,
        "entry_price": 42150.0,
        "current_price": 43200.5,
        "pnl": 16577.75,
        "pnl_percent": 3.91,
        "leverage": 5,
        "funding_rate": 0.00012,
        "last_updated": "2026-03-21T14:30:45Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total_pages": 1
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Endpoint Θέσεων Φαλαινών

Ανακτήστε λεπτομερείς θέσεις από παρακολουθούμενα πορτοφόλια φαλαινών σε όλες τις ανταλλαγές. Αυτό το endpoint δείχνει μόχλευση σε πραγματικό χρόνο, τιμές εισόδου, τιμές ρευστοποίησης και μη πραγματοποιημένο κέρδος/ζημία για θέσεις υψηλής αξίας.

GET /v1/whales/events PRO

Παράμετρος	Τύπος	Περιγραφή
symbol	string	Ζεύγος συναλλαγής (π.χ., BTCUSDT, ETHUSDT) προαιρετικό
exchange	string	Φιλτράρισμα ανά ανταλλαγή: bybit, binance, hyperliquid προαιρετικό
min_position_size	number	Ελάχιστο μέγεθος θέσης σε βασικό asset προαιρετικό
direction	string	Μόνο long ή short θέσεις προαιρετικό
page	integer	Αριθμός σελίδας σελιδοποίησης, προεπιλογή 1 προαιρετικό
limit	integer	Αποτελέσματα ανά σελίδα, μέγιστο 100, προεπιλογή 50 προαιρετικό

Παράδειγμα Αιτήματος:

cURL

curl -X GET "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&min_position_size=10&limit=25" \
  -H "X-API-Key: sm_your_key" \
  -H "Content-Type: application/json"

Endpoint Ποσοστών Χρηματοδότησης

Πρόσβαση σε ποσοστά χρηματοδότησης σε πραγματικό χρόνο και ιστορικά σε Bybit, Binance και Hyperliquid. Τα ποσοστά χρηματοδότησης είναι κρίσιμα για συναλλαγές αρμπιτράζ, στρατηγικές swing και αντιστάθμιση παραγώγων. Το API μας συγκεντρώνει ποσοστά με λεπτομέρεια 15 λεπτών και παρέχει ανάλυση ιστορικών ποσοστών.

GET /v1/funding-rates FREE

Παράμετρος	Τύπος	Περιγραφή
symbol	string	Ζεύγος συναλλαγής (π.χ., BTCUSDT) απαιτείται
exchange	string	Ανταλλαγή: bybit, binance, hyperliquid προαιρετικό
interval	string	1h, 4h, 1d, προεπιλογή 1h προαιρετικό
limit	integer	Ιστορικές περίοδοι προς επιστροφή, μέγιστο 500 προαιρετικό

Παράδειγμα Αιτήματος:

JavaScript

const fetchFundingRates = async () => {
  const response = await fetch(
    "https://api.smartmoneyapi.com/v1/funding-rates?symbol=BTCUSDT&interval=4h&limit=100",
    {
      headers: {
        "X-API-Key": "sm_your_key",
        "Content-Type": "application/json"
      }
    }
  );
  const data = await response.json();
  console.log(data);
};
fetchFundingRates();

Endpoint Ανοιχτού Ενδιαφέροντος

Παρακολουθήστε το συνολικό ανοιχτό ενδιαφέρον από όλους τους εμπόρους με μόχλευση. Η απόκλιση του ανοιχτού ενδιαφέροντος από την κίνηση της τιμής σηματοδοτεί πιθανές ανατροπές και ευκαιρίες συνέχειας τάσης. Παρακολουθήστε τόσο το απόλυτο OI όσο και τους ρυθμούς αλλαγής του OI.

GET /v1/open-interest TRADER

Παράμετρος	Τύπος	Περιγραφή
symbol	string	Ζεύγος συναλλαγών required
exchange	string	bybit, binance, ή hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, default 15m optional

Endpoint Ρευστοποιήσεων

Επιστρέφει δύο συμπληρωματικές προβολές για ένα σύμβολο: προβλεπόμενα επίπεδα μόχλευσης επίπεδα (μια εκτίμηση του πού βρίσκονται οι συστάδες ρευστοποιήσεων) και ένα realized_heatmap — την ΠΡΑΓΜΑΤΙΚΗ ένταση των εκτελεσμένων εξαναγκασμένων ρευστοποιήσεων (τιμή × χρόνος) που συγκεντρώνονται σε πραγματικό χρόνο από δημόσια feeds WebSocket ανταλλαγών: Binance, OKX, Bybit, Bitget, και BitMEX. Το heatmap εμφανίζεται όταν το stream έχει δεδομένα για το σύμβολο.

GET /v1/liquidations TRADER

Παράμετρος	Τύπος	Περιγραφή
symbol	string	Σύμβολο περιουσιακού στοιχείου, default BTC optional

Trader επιστρέφει κίνδυνο καταρράκτη, πλησιέστερες αποστάσεις και πραγματικά σύνολα/ανά πλευρά. Pro επιστρέφει πλήρη προβλεπόμενα επίπεδα συν το πλήρες realized_heatmap (πίνακες, ανά συστάδες τιμών, ανάλογα με τον αριθμό ανταλλαγών).

Ρευστοποιήσεις On-Chain DeFi

Εκτελεσμένες ρευστοποιήσεις από πρωτόκολλα δανεισμού DeFi που καταγράφονται απευθείας από τους δικούς μας πλήρεις κόμβους BSC και Avalanche — ανεξάρτητα από οποιοδήποτε trading bot. Καλύπτει τα Venus/Cream και Moolah στο BSC, και τα AAVE V3/V2, Benqi, BankerJoe, Granary και Vinium στο Avalanche. Απαιτεί πιστοποιημένο κλειδί (Trader+); Το Pro επιπλέον επιστρέφει θέσεις σε κίνδυνο που εξαρτώνται από bot.

GET /v1/liquidations/onchain TRADER

Παράμετρος	Τύπος	Περιγραφή
chain	string	bsc ή avax; παραλείψτε για όλα optional
limit	integer	Μέγιστες σειρές, default 100, max 500 (νέες-πρώτες) optional

Endpoint Επιβεβαίωσης

Το /v1/confirm endpoint επιστρέφει ένα βαθμολογημένο σύνολο πολλαπλών παραγόντων σύγκλιση που συνδυάζει παράγωγα, on-chain (δωρεάν Coin Metrics: MVRV / exchange-flow / active-address), και θέσεις φαλαινών. Το σύνθετο κυμαίνεται από -1.0 έως +1.0 (όχι 0–100) και κάθε απάντηση περιλαμβάνει μια διαφανή παράγοντες ανάλυση (βαθμολογία ανά παράγοντα × βάρος), προσαρμογές, βάρη, και κάλυψη. Είναι υποστήριξη απόφασης, όχι εγγυημένο ποσοστό νίκης. Ένα μη παρακολουθούμενο σύμβολο επιστρέφει ένα ρητό αποτέλεσμα NO_DATA / μη υποστηριζόμενο αντί για ένα κατασκευασμένο LOW.

GET /v1/confirm TRADER

Παράμετροι: symbol (BTC/ETH/SOL) και direction (long/short). confidence είναι ένα από HIGH / MEDIUM / LOW / VETO / NO_DATA; action είναι ένα από CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult είναι ο προτεινόμενος πολλαπλασιαστής μεγέθους θέσης.

Endpoints Δεδομένων On-Chain

Πρόσβαση σε μετρήσεις on-chain Bitcoin και Ethereum, συμπεριλαμβανομένων ροών ανταλλαγών, κινήσεων πορτοφολιών φαλαινών, αναλογίας MVRV, NUPL, συνθηκών δαπανών και πραγματοποιημένης διακύμανσης. Αυτές οι μετρήσεις εντοπίζουν κύκλους συσσώρευσης/διανομής και παρέχουν πρώιμα σήματα για μεγάλες ανατροπές.

GET /v1/on-chain/metrics PRO

Παράμετρος	Τύπος	Περιγραφή
asset	string	bitcoin ή ethereum required
metrics	array	Συγκεκριμένες μετρήσεις: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (ημερήσια), 1w (εβδομαδιαία), default 1d optional

Αναφορά Μοντέλων Δεδομένων

Η κατανόηση της δομής των αποκρίσεων API είναι απαραίτητη για την ενσωμάτωση. Παρακάτω βρίσκονται οι πλήρεις ορισμοί μοντέλων δεδομένων που χρησιμοποιούνται σε όλα τα endpoints.

Αντικείμενο WhalePosition

JSON

{
  "id": "pos_1a2b3c4d5e6f7g8h",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "exchange": "bybit",
  "symbol": "BTCUSDT",
  "position_type": "long",
  "position_size": 15.5,
  "entry_price": 42150.0,
  "current_price": 43200.5,
  "pnl": 16577.75,
  "pnl_percent": 3.91,
  "leverage": 5,
  "margin_balance": 129000.0,
  "used_margin": 126225.0,
  "available_margin": 2775.0,
  "liquidation_price": 34560.0,
  "funding_rate": 0.00012,
  "time_opened": "2026-03-15T08:30:00Z",
  "last_updated": "2026-03-21T14:30:45Z"
}

Αντικείμενο FundingRateRecord

JSON

{
  "timestamp": "2026-03-21T14:00:00Z",
  "symbol": "BTCUSDT",
  "bybit": {
    "funding_rate": 0.00012,
    "next_rate": 0.00015
  },
  "binance": {
    "funding_rate": 0.00010,
    "next_rate": 0.00013
  },
  "hyperliquid": {
    "funding_rate": 0.00014,
    "next_rate": 0.00016
  },
  "aggregated": {
    "mean": 0.000120,
    "median": 0.000120,
    "spread": 0.000060
  }
}

Παραδείγματα Κώδικα

Παρακάτω βρίσκονται παραδείγματα κώδικα έτοιμα για παραγωγή για κοινά μοτίβα ενσωμάτωσης.

Παρακολούθηση Θέσεων Φαλαινών σε Python

Python

import requests
import time
from typing import List, Dict

class SmartMoneyClient:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.smartmoneyapi.com/api/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def get_whale_positions(self, symbol: str = None) -> Dict:
        """Ανάκτηση θέσεων φαλαινών με προαιρετικό φίλτρο συμβόλου"""
        params = {}
        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            f"{self.base_url}/whales/events",
            headers=self.headers,
            params=params
        )
        return response.json()

    def get_funding_rates(self, symbol: str) -> Dict:
        """Ανάκτηση τρέχουσων και ιστορικών τιμών χρηματοδότησης"""
        response = requests.get(
            f"{self.base_url}/funding-rates",
            headers=self.headers,
            params={"symbol": symbol, "limit": 100}
        )
        return response.json()

    def monitor_whale_activity(self, symbol: str, interval_seconds: int = 60):
        """Συνεχής παρακολούθηση θέσεων φαλαινών"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Φάλαινα {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Χρήση
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Συνολικές θέσεις φαλαινών: {whales['data']['total']}")

Βέλτιστες Πρακτικές & Συμβουλές Απόδοσης

Χρησιμοποιήστε σελιδοποίηση: Πάντα χρησιμοποιείτε σελιδοποίηση για μεγάλα σύνολα αποτελεσμάτων. Χρησιμοποιήστε τις παραμέτρους limit και page για να ανακτήσετε δεδομένα σε τμήματα των 50-100 εγγραφών, όχι όλα τα δεδομένα ταυτόχρονα.

Προσωρινή αποθήκευση αποκρίσεων: Οι θέσεις των φαλαινών δεν αλλάζουν κάθε δευτερόλεπτο. Προσωρινά αποθηκεύστε τα αποτελέσματα για 30-60 δευτερόλεπτα για να μειώσετε τις κλήσεις API και να βελτιώσετε την απόδοση.

Φιλτράρετε νωρίς: Χρησιμοποιήστε παραμέτρους ερωτήματος (symbol, exchange, direction) για να φιλτράρετε τα δεδομένα από την πλευρά του διακομιστή, όχι στον κώδικα της εφαρμογής σας.

Χειριστείτε τα όρια ρυθμού: Εφαρμόστε λογική επανάληψης με εκθετική καθυστέρηση. Όταν φτάσετε τα όρια ρυθμού (κατάσταση 429), περιμένετε και επαναλάβετε.

Χρησιμοποιήστε WebSocket για πραγματικό χρόνο: Για τη ροή δεδομένων, προτιμήστε συνδέσεις WebSocket έναντι των τελικών σημείων REST. Θα εξοικονομήσετε εύρος ζώνης και θα έχετε καθυστέρηση κάτω από ένα δευτερόλεπτο.

Επικυρώστε τις χρονικές σημάνσεις: Όλες οι χρονικές σημάνσεις είναι ISO 8601 UTC. Πάντα μετατρέψτε στη ζώνη ώρας σας για εμφάνιση και πάντα αποθηκεύστε σε UTC.

Χειριστείτε τις αποσυνδέσεις: Εφαρμόστε λογική αυτόματης επανασύνδεσης με εκθετική καθυστέρηση για συνδέσεις WebSocket.

Παρακολουθήστε το όριο σας: Ελέγξτε την κεφαλίδα X-Requests-Remaining στις αποκρίσεις. Σχεδιάστε τη χρήση API σας για να παραμείνετε εντός του ορίου της βαθμίδας σας.

Κοινά Μοτίβα Ενσωμάτωσης

Μοτίβο 1: Ειδοποίηση για Συσσώρευση Φαλαινών

Ρυθμίστε ειδοποιήσεις όταν οι θέσεις των φαλαινών αυξάνονται πέρα από ένα όριο, υποδεικνύοντας πιθανές φάσεις ανοδικής τάσης ή συσσώρευσης.

Μοτίβο 2: Ανίχνευση Χρηματοδότησης Arbitrage

Ανιχνεύστε αυτόματα όταν οι διαφορές των τιμών χρηματοδότησης υπερβαίνουν τα κερδοφόρα όρια σε διάφορες ανταλλαγές, ενεργοποιώντας αλγόριθμους arbitrage μεταξύ ανταλλαγών.

Μοτίβο 3: Παρακολούθηση Καταρρακτώδους Ρευστοποίησης

Παρακολουθήστε μεγάλες ρευστοποιήσεις και θέστε τον αλγόριθμο να εκμεταλλευτεί τις καταρρακτώδεις ρευστοποιήσεις και τις κινήσεις τιμών υψηλής επίδρασης.

Μοτίβο 4: Επιβεβαίωση Πολλαπλών Σημάτων

Συνδυάστε τις θέσεις των φαλαινών, τις τιμές χρηματοδότησης, τα μετρικά της αλυσίδας και τους βαθμούς επιβεβαίωσης της τεχνητής νοημοσύνης μας για σήματα εισόδου υψηλής βεβαιότητας.

Έτοιμοι να Ξεκινήσετε;

Αποκτήστε το κλειδί API σας από την κονσόλα και αρχίστε να δημιουργείτε σήμερα. Όλοι οι νέοι λογαριασμοί λαμβάνουν δωρεάν πρόσβαση με 20 αιτήματα την ημέρα (BTC, ETH, SOL). Αναβαθμίστε σε Trader ή Pro για απεριόριστη πρόσβαση σε όλα τα σύμβολα και τις προηγμένες λειτουργίες.

Αποκτήστε Κλειδί API

Ξεκλειδώστε τις Προηγμένες Λειτουργίες

Αποκτήστε πλήρη πρόσβαση στις θέσεις των φαλαινών, τους βαθμούς επιβεβαίωσης, τα δεδομένα της αλυσίδας και περισσότερες από 2000 ημερήσιες κλήσεις API.

Δείτε Τιμές