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:
- 1Creează un cont gratuit, apoi deschide panoul de control.
- 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ă.
- 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
- 1Păstrează logica existentă de intrare care produce un semnal de cumpărare/vânzare candidat.
- 2Exportă cheia ta:
export SMA_API_KEY="sm_your_key_here". - 3Înainte de fiecare intrare, apelează
/v1/confirmcu simbolul și direcția. - 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.
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:
{
"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.