Komplette REST-API-Referenz

Meistern Sie die Smart Money API mit unserer umfassenden REST-Referenz. Erfahren Sie alles über Endpunkte, Parameter, Authentifizierungsmethoden und praktische Integrationsmuster für Krypto-Derivate-Intelligenz und Wal-Tracking-Daten.

Übersicht

Die Smart Money API bietet RESTful-Zugriff auf Echtzeit-Daten zu Kryptowährungs-Derivaten über drei große Börsen: Bybit, Binance und Hyperliquid. Unsere API aggregiert Wal-Wallet-Positionen, Finanzierungssätze, Open-Interest-Kennzahlen, Liquidierungsdaten und On-Chain-Signale in einer einheitlichen Schnittstelle. Egal, ob Sie Handelsalgorithmen, Risikomanagementsysteme oder Marktanalysetools entwickeln – die REST-API bietet Ihnen direkten programmatischen Zugriff auf alle Smart Money-Intelligenz.

Mit über 229 automatisch erkannten Handelssymbolen und mehr als 600 überwachten Wal-Wallets liefert die API umfassende Marktintelligenz. Echtzeit-WebSocket-Verbindungen liefern Updates im Subsekundenbereich, während unsere REST-Endpunkte Stapelabfragen, historische Datenabfragen und Portfolioanalysen in großem Maßstab ermöglichen.

Alle Anfragen müssen gültige Authentifizierungsdaten enthalten. Nutzer der kostenlosen Stufe haben 20 Anfragen pro Tag, beschränkt auf BTC. Die Trader-Stufe (400 Anfragen/Tag) und die Pro-Stufe (4.000 Anfragen/Tag) entsperren alle Symbole und erweiterte Funktionen.

Authentifizierung

Die Smart Money API nutzt die API-Schlüssel-Authentifizierung. Die primäre Methode ist der X-API-Key Anfrage-Header. Sie können API-Schlüssel aus Ihrem Dashboard generieren. Ein Sitzungs-JWT über Authorization: Bearer wird als Fallback für Browser/Dashboard-Sitzungen akzeptiert, aber API-Clients sollten X-API-Key.

API-Schlüssel-Authentifizierung (primär)

Senden Sie Ihren API-Schlüssel im X-API-Key Header bei jeder Anfrage. Legen Sie Ihren Schlüssel niemals in eine URL.

HTTP

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

Sitzungs-JWT (Fallback)

Browser/Dashboard-Sitzungen können ein Sitzungs-JWT über Authorization: Bearer (gültig für 24 Stunden) übergeben. Programmatische Clients sollten X-API-Key.

Python

import requests
import json

# JWT-Token abrufen
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# JWT für nachfolgende Anfragen verwenden
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Basis-URL & Endpunkte

Alle API-Anfragen gehen an https://api.smartmoneyapi.com. Die API ist in logische Ressourcenkategorien mit Versionspräfixen organisiert. Die aktuelle stabile Version ist v1.

Basis-URL: https://api.smartmoneyapi.com/api/v1

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

Antwortformat

Alle API-Antworten werden als JSON-Objekte mit einem standardisierten Umschlagformat zurückgegeben. Erfolgreiche Antworten liefern HTTP-200-299-Statuscodes mit Daten im Antwortkörper. Fehlerantworten enthalten detaillierte Fehlermeldungen und Lösungsvorschläge.

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

Wal-Positionen-Endpunkt

Ruft detaillierte Positionen von überwachten Wal-Wallets über alle Börsen hinweg ab. Dieser Endpunkt zeigt Echtzeit-Leverage, Einstiegspreise, Liquidierungspreise und unrealisierte Gewinne/Verluste für hochvolumige Positionen.

GET /v1/whales/events PRO

Parameter	Typ	Beschreibung
symbol	string	Handelspaar (z.B. BTCUSDT, ETHUSDT) optional
exchange	string	Nach Börse filtern: bybit, binance, hyperliquid optional
min_position_size	number	Mindestpositionsgröße im Basiswert optional
direction	string	Nur Long- oder Short-Positionen optional
page	integer	Seitennummer für Paginierung, Standard 1 optional
limit	integer	Ergebnisse pro Seite, max. 100, Standard 50 optional

Beispielanfrage:

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"

Finanzierungssätze-Endpunkt

Ermöglicht den Zugriff auf Echtzeit- und historische Finanzierungssätze über Bybit, Binance und Hyperliquid. Finanzierungssätze sind entscheidend für Arbitrage-Handel, Swing-Strategien und Derivative-Absicherung. Unsere API aggregiert Sätze mit 15-Minuten-Granularität und bietet historische Satzanalysen.

GET /v1/funding-rates FREE

Parameter	Typ	Beschreibung
symbol	string	Handelspaar (z.B. BTCUSDT) erforderlich
exchange	string	Börse: bybit, binance, hyperliquid optional
interval	string	1h, 4h, 1d, Standard 1h optional
limit	integer	Historische Perioden zur Rückgabe, max. 500 optional

Beispielanfrage:

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();

Open Interest Endpoint

Überwachen Sie das aggregierte Open Interest aller Leverage-Trader. Eine Divergenz des Open Interest von der Preisbewegung signalisiert potenzielle Umkehrungen und Trendfortsetzungsmöglichkeiten. Verfolgen Sie sowohl das absolute OI als auch die OI-Änderungsraten.

GET /v1/open-interest TRADER

Parameter	Typ	Beschreibung
symbol	string	Handelspaar erforderlich
exchange	string	bybit, binance oder hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, Standard 15m optional

Liquidations Endpoint

Gibt zwei komplementäre Ansichten für ein Symbol zurück: leverage-projizierte Levels (eine Schätzung, wo Liquidationscluster liegen) und eine realized_heatmap — die REAL ausgeführte Zwangsliquidationsintensität (Preis × Zeit), live aus öffentlichen Exchange-WebSocket-Feeds aggregiert: Binance, OKX, Bybit, Bitget und BitMEX. Die Heatmap ist vorhanden, wenn der Stream Daten für das Symbol hat.

GET /v1/liquidations TRADER

Parameter	Typ	Beschreibung
symbol	string	Asset-Symbol, Standard BTC optional

Trader gibt Kaskadenrisiko, nächste Distanzen und realisierte Summen/Seite zurück. Pro gibt vollständige projizierte Levels plus die vollständige realized_heatmap (Matrizen, pro-Preis-Cluster, pro-Exchange-Zählungen) zurück.

On-Chain DeFi Liquidations

Ausgeführte DeFi-Leihprotokoll-Liquidationen, direkt von unseren eigenen lokalen BSC- und Avalanche-Full-Nodes erfasst – unabhängig von jedem Trading-Bot. Deckt Venus/Cream und Moolah auf BSC sowie AAVE V3/V2, Benqi, BankerJoe, Granary und Vinium auf Avalanche ab. Erfordert einen authentifizierten Schlüssel (Trader+); Pro gibt zusätzlich botabhängige Risikopositionen zurück.

GET /v1/liquidations/onchain TRADER

Parameter	Typ	Beschreibung
chain	string	bsc oder avax; weglassen für alle optional
limit	integer	Maximale Zeilen, Standard 100, Maximum 500 (neueste zuerst) optional

Confirmation Endpoint

Der /v1/confirm Endpoint gibt einen regelbasierten, multifaktoriellen Confluence Score zurück, der Derivate, On-Chain (kostenlose Coin Metrics: MVRV / Exchange-Flow / aktive Adressen) und Wal-Positionierung kombiniert. Der Composite reicht von -1.0 bis +1.0 (nicht 0–100) und jede Antwort enthält eine transparente Factors Aufschlüsselung (pro-Leg-Score × Gewichtung), Adjustments, Gewichtungen, und Coverage. Es handelt sich um Entscheidungsunterstützung, nicht um eine garantierte Gewinnrate. Ein nicht verfolgtes Symbol gibt ein explizites NO_DATA / nicht unterstütztes Ergebnis zurück, anstatt ein fabriziertes LOW.

GET /v1/confirm TRADER

Parameter: symbol (BTC/ETH/SOL) und direction (long/short). confidence ist einer von HIGH / MEDIUM / LOW / VETO / NO_DATA; action ist einer von CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult ist der vorgeschlagene Positionsgrößenmultiplikator.

On-Chain Data Endpoints

Greifen Sie auf Bitcoin- und Ethereum-On-Chain-Metriken zu, einschließlich Exchange-Flows, Wal-Wallet-Bewegungen, MVRV-Verhältnis, NUPL, Ausgabebedingungen und realisierter Volatilität. Diese Metriken identifizieren Akkumulations-/Distributionszyklen und liefern frühe Signale für große Umkehrungen.

GET /v1/on-chain/metrics PRO

Parameter	Typ	Beschreibung
asset	string	bitcoin oder ethereum erforderlich
metrics	array	Spezifische Metriken: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (täglich), 1w (wöchentlich), Standard 1d optional

Data Models Reference

Das Verständnis der Struktur von API-Antworten ist für die Integration unerlässlich. Unten finden Sie die vollständigen Datenmodelldefinitionen, die in allen Endpoints verwendet werden.

WhalePosition Object

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 Object

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

Code-Beispiele

Hier finden Sie produktionsreife Code-Beispiele für gängige Integrationsmuster.

Überwachung von Wal-Positionen in 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:
        """Abrufen von Wal-Positionen mit optionalem Symbolfilter"""
        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:
        """Aktuelle und historische Funding Rates abrufen"""
        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):
        """Kontinuierliche Überwachung von Wal-Positionen"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Wal {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Verwendung
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Gesamte Wal-Positionen: {whales['data']['total']}")

Beste Praktiken & Leistungstipps

Paginierung verwenden: Verwenden Sie bei großen Ergebnismengen immer Paginierung. Nutzen Sie limit- und page-Parameter, um Daten in Blöcken von 50-100 Datensätzen abzurufen, nicht alle auf einmal.

Antworten zwischenspeichern: Wal-Positionen ändern sich nicht jede Sekunde. Speichern Sie Ergebnisse für 30-60 Sekunden zwischen, um API-Aufrufe zu reduzieren und die Leistung zu verbessern.

Früh filtern: Verwenden Sie Abfrageparameter (symbol, exchange, direction), um Daten serverseitig zu filtern, nicht in Ihrem Anwendungscode.

Rate Limits handhaben: Implementieren Sie eine exponentielle Backoff-Wiederholungslogik. Wenn Sie Rate Limits (Status 429) erreichen, warten Sie und versuchen Sie es erneut.

WebSocket für Echtzeitdaten nutzen: Für Streaming-Daten bevorzugen Sie WebSocket-Verbindungen gegenüber REST-Polling. Sie sparen Bandbreite und erhalten Latenzen unter einer Sekunde.

Zeitstempel validieren: Alle Zeitstempel sind ISO 8601 UTC. Konvertieren Sie sie immer zur Anzeige in Ihre lokale Zeitzone und speichern Sie sie in UTC.

Trennungen handhaben: Implementieren Sie eine automatische Wiederherstellungslogik mit exponentiellem Backoff für WebSocket-Verbindungen.

Ihr Kontingent überwachen: Prüfen Sie den X-Requests-Remaining-Header in Antworten. Planen Sie Ihre API-Nutzung, um innerhalb Ihres Limits zu bleiben.

Gängige Integrationsmuster

Muster 1: Warnung bei Wal-Akkumulation

Richten Sie Warnungen ein, wenn Wal-Positionen einen Schwellenwert überschreiten, was auf potenzielle Haussephasen oder Akkumulation hindeuten kann.

Muster 2: Erkennung von Funding-Rate-Arbitrage

Erkennen Sie automatisch, wenn Funding-Rate-Spreads profitable Schwellenwerte über Börsen hinweg überschreiten, um Arbitrage-Algorithmen zu ermöglichen.

Muster 3: Überwachung von Liquidationskaskaden

Verfolgen Sie große Liquidierungen und positionieren Sie den Algorithmus, um von kaskadierenden Liquidierungen und hochwirksamen Preisbewegungen zu profitieren.

Muster 4: Multi-Signal-Bestätigung

Kombinieren Sie Wal-Positionen, Funding Rates, On-Chain-Metriken und unsere KI-Bestätigungsscores für hochüberzeugte Einstiegssignale.

Bereit zu starten?

Holen Sie sich Ihren API-Schlüssel aus der Konsole und beginnen Sie noch heute mit dem Entwickeln. Alle neuen Konten erhalten kostenlosen Zugang mit 20 Anfragen pro Tag (BTC, ETH, SOL). Upgraden Sie auf Trader oder Pro für unbegrenzten Zugang zu allen Symbolen und erweiterten Funktionen.

API-Schlüssel erhalten

Pro-Funktionen freischalten

Erhalten Sie vollen Zugriff auf Wal-Positionen, Bestätigungsscores, On-Chain-Daten und 2000+ tägliche API-Anfragen.

Preise anzeigen