Integreringsguide
Bekräfta inträden i en Binance Futures bot
Lägg till en slutlig marknadskontext-grind till din Binance USDⓈ-M futures bot: bekräfta riktningen med valflöde och derivatpositionering, och skala sedan ordningen med den föreslagna multiplikatorn.
Vem detta är för
Utvecklare som kör en Binance USDⓈ-M perpetual futures bot och vill ha ett oberoende bekräftelselager före varje inträde. Smart Money API är beslutsstöd — din bot behåller full kontroll över orderplacering och riskhantering.
Förutsättningar
- Python 3.9+ med
pip install ccxt requests(CCXT täcker Binance USDⓈ-M futures). - Binance futures API-nycklar med handelsbehörighet (testa på testnet först).
- En Smart Money API-nyckel (gratisnivån täcker BTC).
Hämta din API-nyckel
Varje begäran autentiseras med X-API-Key header. För att få en nyckel:
- 1Skapa ett gratis konto, öppna sedan din instrumentpanel.
- 2Kopiera API-nyckeln som visas under API-åtkomst. Den gratis nivån täcker BTC med 20 förfrågningar/dag — tillräckligt för att testa denna guide från början till slut.
- 3Behöver du fler symboler eller högre gränser? Jämför nivåer på prissättningssidan.
Håll nyckeln hemlig — lagra den i en miljövariabel, commit den aldrig till källkontroll.
Installation
- 1Behåll din befintliga inträdeslogik som producerar en kandidat för lång/kort-signal.
- 2Exportera din nyckel:
export SMA_API_KEY="sm_your_key_here". - 3Före varje inträde, anropa
/v1/confirmmed symbolen och riktningen. - 4Öppna futurespositionen endast på
CONFIRM, skala notional medsize_mult.
Arbetsexempel
Denna bot bekräftar en lång eller kort med GET /v1/confirm?symbol=BTC&direction=long och öppnar endast en Binance USDⓈ-M futuresposition när åtgärden är 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)
Förväntat svar
Ett lyckat anrop till /v1/confirm returnerar JSON så här:
{
"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 sträcker sig från -1.0 (stark motstånd) till +1.0 (stark bekräftelse), confidence är HIGH eller MEDIUM, och size_mult är en 0.0–1.5 föreslagen storleksmultiplikator. Se hela fältreferensen i API-dokumentationen.
Hur man agerar på svaret
BEKRÄFTA
Kontext stödjer din riktning. Öppna positionen med dina egna riskregler, skala notional med size_mult.
REDUCERA
Signalerna är blandade. Överväg en mindre position och snävare hävstång, eller vänta på bekräftelse.
HOPPA ÖVER
Marknadskontext stödjer inte denna handel. Stå vid sidan och kontrollera igen vid nästa signal.
Redo att bygga?
Skaffa en gratis nyckel och gör ditt första bekräftelseanrop på under en minut.
Inte finansiell rådgivning. Kryptohandel innebär risk.