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:

  1. 1Hozz létre egy ingyenes fiókot, majd nyisd meg a irányítópultod.
  2. 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.
  3. 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

  1. 1Tartsd meg a meglévő bejegyzési logikádat, amely egy jelölt hosszú/rövid jelet állít elő.
  2. 2Exportáld a kulcsod: export SMA_API_KEY="sm_your_key_here".
  3. 3Minden bejegyzés előtt hívd meg /v1/confirm a szimbólummal és az iránnyal.
  4. 4Csak akkor nyisd meg a futures pozíciót, ha CONFIRM, méretezd a névleges értéket size_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.

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)

Várt válasz

Egy sikeres hívás a /v1/confirm visszaad egy JSON-t, mint ez:

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