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:

  1. 1Skapa ett gratis konto, öppna sedan din instrumentpanel.
  2. 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.
  3. 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

  1. 1Behåll din befintliga inträdeslogik som producerar en kandidat för lång/kort-signal.
  2. 2Exportera din nyckel: export SMA_API_KEY="sm_your_key_here".
  3. 3Före varje inträde, anropa /v1/confirm med symbolen och riktningen.
  4. 4Öppna futurespositionen endast på CONFIRM, skala notional med size_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.

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)

Förväntat svar

Ett lyckat anrop till /v1/confirm returnerar JSON så här:

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 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.