Integrationsleitfaden
Smart Money API zusammen mit CCXT nutzen
Lese Live-Marktdaten mit CCXT, frage Smart Money API, ob Wal-Strömung und Derivate-Positionierung deine Richtung bestätigen, und platziere dann die Order auf der Börse deiner Wahl.
Für wen dies geeignet ist
Python-Entwickler, die börsenunabhängige Bots auf CCXT bauen und eine unabhängige Marktkontextprüfung vor jeder Order wünschen. Smart Money API dient der Entscheidungsunterstützung – sie platziert keine Orders für dich; CCXT behält die Kontrolle über die Ausführung.
Voraussetzungen
- Python 3.9+ mit
pip install ccxt requests. - Börsen-API-Schlüsseln, die für CCXT konfiguriert sind (nur Leserechte reichen zum Testen).
- Ein Smart Money API-Schlüssel (Free-Tier umfasst BTC).
API-Schlüssel erhalten
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. Der Free-Tier umfasst BTC mit 20 Anfragen/Tag – genug, um diesen Leitfaden end-to-end zu testen.
- 3Brauchst du mehr Symbole oder höhere Limits? Vergleiche die Tier-Optionen auf der Preiseseite.
Bewahre den Schlüssel geheim – speichere ihn in einer Umgebungsvariable, niemals im Quellcode.
Einrichtung
- 1Installiere die Bibliotheken:
pip install ccxt requests. - 2Exportiere deinen Schlüssel:
export SMA_API_KEY="sm_your_key_here". - 3Lass deine Strategie eine Kandidatenrichtung aus CCXT-Marktdaten bestimmen, dann rufe
/v1/confirmals finalen Kontext-Check auf. - 4Platziere die Order mit CCXT nur, wenn die Aktion
CONFIRMist, mit Größenanpassung durchsize_mult.
Funktionierendes Beispiel
Dieses Skript liest einen Ticker mit CCXT, leitet eine Kandidatenrichtung ab und ruft dann GET /v1/confirm?symbol=BTC&direction=long auf, bevor entschieden wird, ob die Order 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.binance() # any CCXT exchange
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": "ccxt-bot"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/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", "market", direction, qty)
print(f"Would place {direction} {qty} BTC/USDT")
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 liefert JSON wie dieses:
{
"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 (stark dagegen) bis +1.0 (starke Bestätigung), confidence ist HIGH oder MEDIUM, und size_mult ist ein 0.0–1.5 Größenmultiplikator-Vorschlag. Siehe die vollständige Feldreferenz in den API-Dokumenten.
Wie auf die Antwort reagieren
CONFIRM
Kontext unterstützt deine Richtung. Fahre mit deinen eigenen Einstiegs- und Risikoregeln fort, optional mit Größenanpassung durch size_mult.
REDUCE
Signale sind gemischt. Erwäge eine kleinere Position, engere Stops oder warte auf ein klareres Setup.
SKIP
Marktkontext unterstützt diesen Trade nicht. Warte ab und überprüfe den nächsten Kandidaten.
Bereit zu bauen?
Hole dir einen kostenlosen Schlüssel und mache deinen ersten Bestätigungsaufruf in unter einer Minute.
Keine Finanzberatung. Kryptohandel birgt Risiken.