Integrationsleitfaden

Bestätigen Sie Einstiege in einem Binance Futures Bot

Fügen Sie Ihrem Binance USDⓈ-M Futures Bot eine letzte Marktkontext-Prüfung hinzu: Bestätigen Sie die Richtung mit Walfluss und Derivatepositionierung, und skalieren Sie die Order mit dem vorgeschlagenen Multiplikator.

Für wen dies geeignet ist

Entwickler, die einen Binance USDⓈ-M Perpetual Futures Bot betreiben und eine unabhängige Bestätigungsschicht vor jedem Einstieg wünschen. Smart Money API bietet Entscheidungshilfe – Ihr Bot behält die volle Kontrolle über die Orderplatzierung und das Risikomanagement.

Voraussetzungen

  • Python 3.9+ mit pip install ccxt requests (CCXT deckt Binance USDⓈ-M Futures ab).
  • Binance Futures API-Schlüssel mit Handelsberechtigung (zuerst auf Testnet testen).
  • Ein Smart Money API-Schlüssel (die kostenlose Stufe deckt BTC ab).

Holen Sie sich Ihren API-Schlüssel

Jede Anfrage authentifiziert sich mit dem X-API-Key Header. Um einen Schlüssel zu erhalten:

  1. 1Erstellen Sie ein kostenloses Konto und öffnen Sie Ihr Dashboard.
  2. 2Kopieren Sie den API-Schlüssel unter API-Zugriff. Die kostenlose Stufe deckt BTC mit 20 Anfragen/Tag ab – genug, um diesen Leitfaden von Anfang bis Ende zu testen.
  3. 3Benötigen Sie mehr Symbole oder höhere Limits? Vergleichen Sie die Stufen auf der Preisseite.

Halten Sie den Schlüssel geheim – speichern Sie ihn in einer Umgebungsvariable und geben Sie ihn niemals in die Quellcodeverwaltung ein.

Einrichtung

  1. 1Behalten Sie Ihre bestehende Einstiegslogik bei, die ein Long/Short-Signal erzeugt.
  2. 2Exportieren Sie Ihren Schlüssel: export SMA_API_KEY="sm_your_key_here".
  3. 3Vor jedem Einstieg rufen Sie /v1/confirm mit dem Symbol und der Richtung auf.
  4. 4Öffnen Sie die Futures-Position nur bei CONFIRM, skalieren Sie den Nennwert um size_mult.

Arbeitsbeispiel

Dieser Bot bestätigt einen Long oder Short mit GET /v1/confirm?symbol=BTC&direction=long und öffnet nur eine Binance USDⓈ-M Futures-Position, wenn die Aktion CONFIRM.

binance_futures_bot.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]
SMA_BASE = "https://api.smartmoneyapi.com"

binance = ccxt.binance({
    "apiKey": os.environ["BINANCE_KEY"],
    "secret": os.environ["BINANCE_SECRET"],
    "options": {"defaultType": "future"},   # USDⓈ-M futures
})

def confirm(symbol: str, direction: str) -> dict:
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "binance-fut"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

def maybe_enter(symbol: str, direction: str, base_qty: float):
    sig = confirm(symbol, direction)
    print(sig["symbol"], direction, "->", sig["action"], sig["confidence"])

    if sig["action"] != "CONFIRM":
        print("Not confirmed -> no entry")   # REDUCE or SKIP
        return

    qty = round(base_qty * sig["size_mult"], 3)   # size by multiplier
    side = "buy" if direction == "long" else "sell"
    # binance.create_order("BTC/USDT", "market", side, qty)
    print(f"Would open {direction} {qty} BTC/USDT (futures)")

if __name__ == "__main__":
    # your strategy decided it wants a long here
    maybe_enter("BTC", "long", base_qty=0.02)

Erwartete Antwort

Ein erfolgreicher Aufruf von /v1/confirm gibt JSON wie folgt 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 (stark dagegen) bis +1.0 (starke Bestätigung), confidence ist HIGH oder MEDIUM, und size_mult ist ein vorgeschlagener Größenmultiplikator von 0.0–1.5. Siehe die vollständige Feldreferenz in den API-Dokumenten.

Wie Sie auf die Antwort reagieren sollten

BESTÄTIGEN

Der Kontext unterstützt Ihre Richtung. Öffnen Sie die Position mit Ihren eigenen Risikoregeln und skalieren Sie den Nennwert um size_mult.

REDUZIEREN

Die Signale sind gemischt. Erwägen Sie eine kleinere Position und engere Hebelwirkung oder warten Sie auf eine Bestätigung.

ÜBERSPRINGEN

Der Marktkontext unterstützt diesen Trade nicht. Halten Sie sich zurück und überprüfen Sie beim nächsten Signal erneut.

Bereit zu bauen?

Holen Sie sich einen kostenlosen Schlüssel und machen Sie Ihren ersten Bestätigungsaufruf in weniger als einer Minute.

Keine Finanzberatung. Der Kryptohandel birgt Risiken.