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:

  1. 1Erstelle ein kostenloses Konto, dann öffne dein Dashboard.
  2. 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.
  3. 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

  1. 1Installiere die Bibliotheken: pip install ccxt requests.
  2. 2Exportiere deinen Schlüssel: export SMA_API_KEY="sm_your_key_here".
  3. 3Lass deine Strategie eine Kandidatenrichtung aus CCXT-Marktdaten bestimmen, dann rufe /v1/confirm als finalen Kontext-Check auf.
  4. 4Platziere die Order mit CCXT nur, wenn die Aktion CONFIRMist, mit Größenanpassung durch size_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.

ccxt_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.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:

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 (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.