Guida all'integrazione

Conferma gli ingressi in un bot Binance Futures

Aggiungi un ulteriore controllo basato sul contesto di mercato al tuo bot per futures USDⓈ-M di Binance: conferma la direzione con il flusso delle balene e il posizionamento dei derivati, quindi dimensiona l'ordine in base al moltiplicatore suggerito.

A chi è rivolto

Sviluppatori che gestiscono un bot per futures perpetui USDⓈ-M di Binance e desiderano un livello di conferma indipendente prima di ogni ingresso. Smart Money API è un supporto alle decisioni — il tuo bot mantiene il pieno controllo sul posizionamento degli ordini e sulla gestione del rischio.

Prerequisiti

  • Python 3.9+ con pip install ccxt requests (CCXT copre i futures USDⓈ-M di Binance).
  • Chiavi API Binance futures con permesso di trading (prima testa su testnet).
  • Una chiave API Smart Money (il piano gratuito include BTC).

Ottieni la tua chiave API

Ogni richiesta viene autenticata con l' X-API-Key intestazione. Per ottenere una chiave:

  1. 1Crea un account gratuito, quindi apri il tuo pannello di controllo.
  2. 2Copia la chiave API mostrata sotto Accesso API. Il piano gratuito include BTC con 20 richieste/giorno — sufficienti per testare questa guida dall'inizio alla fine.
  3. 3Hai bisogno di più simboli o limiti più alti? Confronta i piani nella pagina dei prezzi.

Mantieni la chiave segreta — conservala in una variabile d'ambiente, non inserirla mai nel controllo del codice sorgente.

Configurazione

  1. 1Mantieni la tua logica di ingresso esistente che genera un segnale long/short candidato.
  2. 2Esporta la tua chiave: export SMA_API_KEY="sm_your_key_here".
  3. 3Prima di ogni ingresso, chiama /v1/confirm con il simbolo e la direzione.
  4. 4Apri la posizione futures solo su CONFIRM, scalando il valore nozionale per size_mult.

Esempio funzionante

Questo bot conferma un long o short con GET /v1/confirm?symbol=BTC&direction=long e apre una posizione in futures USDⓈ-M di Binance solo quando l'azione è 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)

Risposta attesa

Una chiamata riuscita a /v1/confirm restituisce un JSON come questo:

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 varia da -1.0 (forte contro) a +1.0 (forte conferma), confidence è HIGH o MEDIUM, e size_mult è un moltiplicatore di dimensione suggerito 0.0–1.5. Vedi il riferimento completo dei campi nella documentazione API.

Come agire in base alla risposta

CONFERMA

Il contesto supporta la tua direzione. Apri la posizione con le tue regole di rischio, scalando il valore nozionale per size_mult.

RIDUCI

I segnali sono contrastanti. Considera una posizione più piccola e una leva più stretta, o attendi una conferma.

SALTA

Il contesto di mercato non supporta questo trade. Rimani fuori e ricontrolla al prossimo segnale.

Pronto a costruire?

Ottieni una chiave gratuita e fai la tua prima chiamata di conferma in meno di un minuto.

Non è un consiglio finanziario. Il trading di criptovalute comporta rischi.