Ghid de integrare

Confirmă intrările într-un bot Binance Futures

Adaugă o verificare finală de context de piață la botul tău Binance USDⓈ-M futures: confirmă direcția cu fluxul balenelor și poziționarea derivatelor, apoi ajustează mărimea ordinului după multiplicatorul sugerat.

Pentru cine este destinat

Dezvoltatorii care rulează un bot Binance USDⓈ-M perpetual futures și doresc un strat independent de confirmare înainte de fiecare intrare. Smart Money API este suport pentru decizii — botul tău păstrează controlul total asupra plasării ordinelor și gestionării riscului.

Cerințe preliminare

  • Python 3.9+ cu pip install ccxt requests (CCXT acoperă Binance USDⓈ-M futures).
  • Chei API Binance futures cu permisiune de tranzacționare (testează mai întâi pe testnet).
  • O cheie API Smart Money API (nivelul gratuit acoperă BTC).

Obține cheia ta API

Fiecare cerere se autentifică cu antetul X-API-Key . Pentru a obține o cheie:

  1. 1Creează un cont gratuit, apoi deschide panoul de control.
  2. 2Copiază cheia API afișată sub Acces API. Nivelul gratuit acoperă BTC cu 20 de cereri/zi — suficient pentru a testa acest ghid de la cap la coadă.
  3. 3Ai nevoie de mai multe simboluri sau limite mai mari? Compară nivelurile pe pagina de prețuri.

Păstrează cheia secretă — stochează-o într-o variabilă de mediu, nu o comite niciodată în controlul surselor.

Configurare

  1. 1Păstrează logica existentă de intrare care produce un semnal de cumpărare/vânzare candidat.
  2. 2Exportă cheia ta: export SMA_API_KEY="sm_your_key_here".
  3. 3Înainte de fiecare intrare, apelează /v1/confirm cu simbolul și direcția.
  4. 4Deschide poziția futures doar pe CONFIRM, scalând valoarea nominală după size_mult.

Exemplu funcțional

Acest bot confirmă o poziție long sau short cu GET /v1/confirm?symbol=BTC&direction=long și deschide o poziție Binance USDⓈ-M futures doar când acțiunea este 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)

Răspuns așteptat

Un apel reușit la /v1/confirm returnează JSON astfel:

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 variază de la -1.0 (puternic contra) la +1.0 (puternic confirmare), confidence este HIGH sau MEDIUM, și size_mult este un multiplicator de mărime sugerat 0.0–1.5. Vezi referința completă a câmpurilor în documentația API.

Cum să acționezi în funcție de răspuns

CONFIRMĂ

Contextul susține direcția ta. Deschide poziția cu propriile reguli de risc, scalând valoarea nominală după size_mult.

REDU

Semnalul este mixt. Ia în considerare o poziție mai mică și o levier mai strâns, sau așteaptă confirmarea.

OMITE

Contextul pieței nu susține această tranzacție. Stai deoparte și verifică din nou la următorul semnal.

Gata de construit?

Ia o cheie gratuită și fă prima ta cerere de confirmare în mai puțin de un minut.

Nu este sfat financiar. Tranzacționarea cu criptomonede implică riscuri.