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:
- 1Erstelle ein kostenloses Konto, dann öffne dein Dashboard.
- 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.
- 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
- 1Installiere die Bibliotheken:
pip install ccxt requests. - 2Exportiere deinen Schlüssel:
export SMA_API_KEY="sm_your_key_here". - 3Öffne Bybit Swaps mit CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), lass deine Strategie eine Kandidatenrichtung auswählen, dann rufe/v1/confirmals finalen Kontext-Check auf. - 4Platziere den Perpetuals-Einstieg mit CCXT nur, wenn die Aktion
CONFIRMist, skaliert mitsize_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.
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:
{
"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.