Integratiehandleiding
Bevestig entries in een Binance Futures bot
Voeg een laatste marktcontext-poort toe aan je Binance USDⓈ-M futures bot: bevestig de richting met walvisstroom en derivatenpositionering, en schaal de order met de voorgestelde multiplier.
Voor wie dit bedoeld is
Ontwikkelaars die een Binance USDⓈ-M perpetual futures bot runnen en een onafhankelijke bevestigingslaag willen voor elke entry. Smart Money API is beslissingsondersteuning — je bot behoudt volledige controle over orderplaatsing en risicobeheer.
Vereisten
- Python 3.9+ met
pip install ccxt requests(CCXT ondersteunt Binance USDⓈ-M futures). - Binance futures API-sleutels met handelsrechten (test eerst op testnet).
- Een Smart Money API-sleutel (gratis tier dekt BTC).
Krijg je API-sleutel
Elk verzoek wordt geverifieerd met de X-API-Key header. Om een sleutel te krijgen:
- 1Maak een gratis account aan en open vervolgens je dashboard.
- 2Kopieer de API-sleutel die wordt weergegeven onder API Toegang. De gratis tier dekt BTC met 20 verzoeken/dag — genoeg om deze handleiding van begin tot eind te testen.
- 3Meer symbolen of hogere limieten nodig? Vergelijk tiers op de prijspagina.
Houd de sleutel geheim — bewaar hem in een omgevingsvariabele, commit hem nooit naar broncodebeheer.
Setup
- 1Behoud je bestaande entry-logica die een kandidaat long/short-signaal produceert.
- 2Exporteer je sleutel:
export SMA_API_KEY="sm_your_key_here". - 3Voor elke entry, roep
/v1/confirmaan met het symbool en de richting. - 4Open de futurespositie alleen op
CONFIRM, schaal de nominale waarde metsize_mult.
Werkend voorbeeld
Deze bot bevestigt een long of short met GET /v1/confirm?symbol=BTC&direction=long en opent alleen een Binance USDⓈ-M futurespositie wanneer de actie is 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)
Verwachte reactie
Een succesvolle aanroep van /v1/confirm geeft JSON terug zoals dit:
{
"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 varieert van -1.0 (sterk tegen) tot +1.0 (sterke bevestiging), confidence is HOOG of MIDDEL, en size_mult is een 0.0–1.5 voorgestelde grootte multiplier. Zie het volledige veldreferentie in de API docs.
Hoe te handelen op de reactie
BEVESTIG
Context ondersteunt je richting. Open de positie met je eigen risicoregels, schaal de nominale waarde met size_mult.
VERMINDER
Signalen zijn gemengd. Overweeg een kleinere positie en strakkere leverage, of wacht op bevestiging.
OVERSLAAN
Marktcontext ondersteunt deze trade niet. Blijf aan de zijlijn en controleer opnieuw bij het volgende signaal.
Klaar om te bouwen?
Pak een gratis sleutel en maak je eerste bevestigingsaanroep in minder dan een minuut.
Geen financieel advies. Cryptohandel brengt risico's met zich mee.