Integrációs útmutató
Bejegyzések megerősítése egy Binance Futures botban
Adj hozzá egy végső piaci-kontextus ellenőrzést a Binance USDⓈ-M futures botodhoz: erősítsd meg az irányt a whale flow és a derivatív pozíciók alapján, majd méretezd a rendelést a javasolt szorzóval.
Ki számára ajánljuk
Fejlesztők, akik egy Binance USDⓈ-M perpetual futures botot futtatnak, és független megerősítési réteget szeretnének minden bejegyzés előtt. A Smart Money API döntéstámogatás — a botod teljes ellenőrzést tart a rendelésleadás és kockázatkezelés felett.
Előfeltételek
- Python 3.9+
pip install ccxt requests(A CCXT lefedi a Binance USDⓈ-M futures-t). - Binance futures API kulcsok keresési engedéllyel (először teszteld a testneten).
- Egy Smart Money API kulcs (az ingyenes szint lefedi a BTC-t).
Szerezd meg az API kulcsod
Minden kérés hitelesítést igényel a X-API-Key fejlécben. Kulcs lekéréséhez:
- 1Hozz létre egy ingyenes fiókot, majd nyisd meg a irányítópultod.
- 2Másold az API kulcsot, amely az API hozzáférésalatt látható. Az ingyenes szint lefedi a BTC-t 20 kérés/nap — elég ahhoz, hogy végigteszteld ezt az útmutatót.
- 3Több szimbólumra vagy magasabb korlátokra van szükséged? Hasonlítsd össze a szinteket a díjszabás oldalon.
Tartsd titokban a kulcsot — tárold egy környezeti változóban, soha ne commitold a forráskódba.
Beállítás
- 1Tartsd meg a meglévő bejegyzési logikádat, amely egy jelölt hosszú/rövid jelet állít elő.
- 2Exportáld a kulcsod:
export SMA_API_KEY="sm_your_key_here". - 3Minden bejegyzés előtt hívd meg
/v1/confirma szimbólummal és az iránnyal. - 4Csak akkor nyisd meg a futures pozíciót, ha
CONFIRM, méretezd a névleges értéketsize_mult.
Működő példa
Ez a bot megerősíti egy hosszú vagy rövid pozíciót a GET /v1/confirm?symbol=BTC&direction=long segítségével, és csak akkor nyit Binance USDⓈ-M futures pozíciót, ha a művelet 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)
Várt válasz
Egy sikeres hívás a /v1/confirm visszaad egy JSON-t, mint ez:
{
"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 -1.0 (erős ellentétes) és +1.0 (erős megerősítés) között mozog, confidence HIGH vagy MEDIUM, és size_mult egy 0.0–1.5 közötti javasolt méret szorzó. Lásd a teljes mezőreferenciát a API dokumentációban.
Hogyan reagálj a válaszra
CONFIRM
A kontextus támogatja az irányt. Nyisd meg a pozíciót a saját kockázati szabályaiddal, méretezd a névleges értéket size_mult.
REDUCE
A jelek vegyesek. Fontold meg egy kisebb pozíciót és szorosabb leverage-t, vagy várj a megerősítésre.
SKIP
A piaci kontextus nem támogatja ezt a kereskedést. Állj félre és ellenőrizd újra a következő jelnél.
Készen állsz az építésre?
Szerezz egy ingyenes kulcsot, és végezd el az első megerősítő hívást egy percen belül.
Nem pénzügyi tanács. A kriptókereskedelem kockázatokat hordoz.