Integrationsleitfaden

Bestätige Bybit Perpetuals-Einstiege mit der Smart Money API

Lese Live-Bybit-Swap-Marktdaten mit CCXT, frage die Smart Money API, ob Walfluss und Derivate-Positionierung deine Richtung bestätigen, und setze dann den Perpetuals-Einstieg – skaliert mit dem vorgeschlagenen Multiplikator.

Für wen dies geeignet ist

Python-Entwickler, die einen Bybit-USDT-Perpetuals-Bot auf CCXT betreiben und eine unabhängige Marktkontextprüfung vor jedem Einstieg wünschen. Smart Money API ist Entscheidungsunterstützung – sie platziert keine Orders für dich; dein CCXT-Code behält die Kontrolle über Ausführung und Risiko.

Voraussetzungen

  • Python 3.9+ mit pip install ccxt requests.
  • Bybit-API-Schlüsseln, die für CCXT konfiguriert sind (nur Leserechte reichen zum Testen).
  • Ein Smart Money API-Schlüssel (die kostenlose Stufe deckt BTC ab).

Hole dir deinen API-Schlüssel

Jede Anfrage authentifiziert sich mit dem X-API-Key Header. So erhältst du einen Schlüssel:

  1. 1Erstelle ein kostenloses Konto, dann öffne dein Dashboard.
  2. 2Kopiere den API-Schlüssel unter API-Zugriff. Die kostenlose Stufe deckt BTC mit 20 Anfragen/Tag ab – genug, um diesen Leitfaden end-to-end zu testen.
  3. 3Brauchst du mehr Symbole oder höhere Limits? Vergleiche die Stufen auf der Preisseite.

Bewahre den Schlüssel geheim – speichere ihn in einer Umgebungsvariable, gib ihn niemals in die Versionskontrolle ein.

Einrichtung

  1. 1Installiere die Bibliotheken: pip install ccxt requests.
  2. 2Exportiere deinen Schlüssel: export SMA_API_KEY="sm_your_key_here".
  3. 3Öffne Bybit Swaps mit CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), lass deine Strategie eine Kandidatenrichtung auswählen, dann rufe /v1/confirm als finalen Kontext-Check auf.
  4. 4Platziere den Perpetuals-Einstieg mit CCXT nur, wenn die Aktion CONFIRMist, skaliert mit size_mult.

Funktionierendes Beispiel

Dieses Skript liest einen Bybit-Swap-Ticker mit CCXT, leitet eine Kandidatenrichtung ab und ruft dann GET /v1/confirm?symbol=BTC&direction=long auf, bevor es entscheidet, ob der Einstieg platziert wird.

bybit_confirm.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]            # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"

exchange = ccxt.bybit({"options": {"defaultType": "swap"}})   # Bybit perpetuals

def confirm(symbol: str, direction: str) -> dict:
    """Ask Smart Money API for market-context confirmation."""
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "bybit-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# 1. Read Bybit swap market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT:USDT")
direction = "long" if ticker["percentage"] and ticker["percentage"] > 0 else "short"

# 2. Confirm with Smart Money API before acting
sig = confirm("BTC", direction)
print(sig["action"], sig["confidence"], "size_mult", sig["size_mult"])

# 3. Act on the recommendation (CCXT executes; the API only advises)
if sig["action"] == "CONFIRM":
    base_qty = 0.01
    qty = base_qty * sig["size_mult"]          # scale by suggested multiplier
    # exchange.create_order("BTC/USDT:USDT", "market", direction, qty)
    print(f"Would place {direction} {qty} BTC/USDT:USDT perp")
elif sig["action"] == "REDUCE":
    print("Context is mixed -> trade smaller or wait for a cleaner setup")
else:  # SKIP
    print("Context does not support this trade -> stand aside")

Erwartete Antwort

Ein erfolgreicher Aufruf von /v1/confirm gibt JSON wie dieses zurück:

200 OK · application/json
{
  "ts": 1710940821,
  "symbol": "BTC",
  "direction": "long",
  "composite": 0.74,
  "confidence": "HIGH",
  "action": "CONFIRM",
  "size_mult": 1.5,
  "deriv_score": 0.81,
  "onchain_score": 0.68,
  "whale_score": 0.73,
  "reasons": [
    "Funding rate positive across all venues",
    "LSR favors longs: 1.42",
    "Whales: 67% long consensus",
    "MVRV above 1.0 — on-chain bullish"
  ]
}

composite reicht von -1.0 (starker Gegenindikator) bis +1.0 (starke Bestätigung), confidence ist HIGH oder MEDIUM, und size_mult ist ein 0.0–1.5 vorgeschlagener Größenmultiplikator. Siehe die vollständige Feldreferenz in den API-Dokumenten.

Wie du auf die Antwort reagierst

CONFIRM

Der Kontext unterstützt deine Richtung. Fahre mit deinen eigenen Einstiegs- und Risikoregeln fort, optional skaliert mit size_mult.

REDUCE

Die Signale sind gemischt. Erwäge eine kleinere Position, engere Stops oder warte auf ein klareres Setup.

SKIP

Der Marktkontext unterstützt diesen Trade nicht. Warte ab und überprüfe den nächsten Kandidaten.

Bereit zum Bauen?

Hole dir einen kostenlosen Schlüssel und mache deinen ersten Bestätigungsaufruf in unter einer Minute.

Keine Finanzberatung. Kryptohandel birgt Risiken.