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é :
- 1Créez un compte gratuit, puis ouvrez votre tableau de bord.
- 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.
- 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
- 1Conservez votre logique d'entrée existante qui génère un signal long/court candidat.
- 2Exportez votre clé :
export SMA_API_KEY="sm_your_key_here". - 3Avant chaque entrée, appelez
/v1/confirmavec le symbole et la direction. - 4Ouvrez la position futures uniquement sur
CONFIRM, en ajustant le notionnel parsize_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.
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 :
{
"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.