Guide d'intégration

Confirmez les entrées dans un bot Binance Futures

Ajoutez une étape de confirmation contextuelle à votre bot Binance USDⓈ-M futures : validez la direction avec les flux des baleines et le positionnement des dérivés, puis ajustez la taille de l'ordre avec le multiplicateur suggéré.

À qui cela s'adresse

Développeurs utilisant un bot Binance USDⓈ-M futures perpétuels qui souhaitent une couche de confirmation indépendante avant chaque entrée. Smart Money API est une aide à la décision — votre bot garde le contrôle total de la passation d'ordres et de la gestion des risques.

Prérequis

  • Python 3.9+ avec pip install ccxt requests (CCXT prend en charge Binance USDⓈ-M futures).
  • Clés API Binance futures avec permission de trading (testez d'abord sur testnet).
  • Une clé API Smart Money (le niveau gratuit inclut BTC).

Obtenez votre clé API

Chaque requête s'authentifie avec l'en-tête X-API-Key . Pour obtenir une clé :

  1. 1Créez un compte gratuit, puis ouvrez votre tableau de bord.
  2. 2Copiez la clé API affichée sous Accès API. Le niveau gratuit inclut BTC avec 20 requêtes/jour — suffisant pour tester ce guide de bout en bout.
  3. 3Besoin de plus de symboles ou de limites plus élevées ? Comparez les niveaux sur la page tarifaire.

Gardez la clé secrète — stockez-la dans une variable d'environnement, ne la commettez jamais dans le contrôle de source.

Configuration

  1. 1Conservez votre logique d'entrée existante qui génère un signal long/court candidat.
  2. 2Exportez votre clé : export SMA_API_KEY="sm_your_key_here".
  3. 3Avant chaque entrée, appelez /v1/confirm avec le symbole et la direction.
  4. 4Ouvrez la position futures uniquement sur CONFIRM, en ajustant le notionnel par size_mult.

Exemple fonctionnel

Ce bot confirme un long ou un court avec GET /v1/confirm?symbol=BTC&direction=long et n'ouvre une position Binance USDⓈ-M futures que lorsque l'action est 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)

Réponse attendue

Un appel réussi à /v1/confirm renvoie un JSON comme ceci :

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 varie de -1.0 (forte opposition) à +1.0 (forte confirmation), confidence est HIGH ou MEDIUM, et size_mult est un multiplicateur de taille suggéré entre 0.0 et 1.5. Consultez la référence complète des champs dans la documentation API.

Comment agir sur la réponse

CONFIRMER

Le contexte soutient votre direction. Ouvrez la position avec vos propres règles de risque, en ajustant le notionnel par size_mult.

RÉDUIRE

Les signaux sont mitigés. Envisagez une position plus petite et un levier plus serré, ou attendez une confirmation.

IGNORER

Le contexte de marché ne soutient pas ce trade. Abstenez-vous et revérifiez au prochain signal.

Prêt à construire ?

Obtenez une clé gratuite et effectuez votre premier appel de confirmation en moins d'une minute.

Pas un conseil financier. Le trading de crypto comporte des risques.