Průvodce integrací

Potvrďte vstupy v botovi Binance Futures

Přidejte finální bránu kontextu trhu do svého bota Binance USDⓈ-M futures: potvrďte směr pomocí toku velryb a pozic derivátů, poté velikost objednávky upravte podle navrženého multiplikátoru.

Pro koho je to určeno

Vývojáři provozujícího bota Binance USDⓈ-M perpetual futures, kteří chtějí nezávislou vrstvu potvrzení před každým vstupem. Smart Money API je podpora rozhodování — váš bot si zachovává plnou kontrolu nad umístěním objednávek a řízením rizik.

Předpoklady

  • Python 3.9+ s pip install ccxt requests (CCXT pokrývá Binance USDⓈ-M futures).
  • API klíče Binance futures s oprávněním k obchodování (nejprve otestujte na testnetu).
  • Klíč Smart Money API (bezplatná úroveň pokrývá BTC).

Získejte svůj API klíč

Každý požadavek se ověřuje pomocí X-API-Key hlavičky. Pro získání klíče:

  1. 1Vytvořte si bezplatný účet, poté otevřete svůj dashboard.
  2. 2Zkopírujte API klíč zobrazený pod API Access. Bezplatná úroveň pokrývá BTC na 20 požadavků/den — dost na otestování tohoto průvodce od začátku do konce.
  3. 3Potřebujete více symbolů nebo vyšší limity? Porovnejte úrovně na stránce s cenami.

Uchovávejte klíč v tajnosti — uložte jej do proměnné prostředí, nikdy jej nezapisujte do zdrojového kódu.

Nastavení

  1. 1Zachovejte svou stávající logiku vstupu, která vytváří kandidátní signál pro long/short.
  2. 2Exportujte svůj klíč: export SMA_API_KEY="sm_your_key_here".
  3. 3Před každým vstupem volejte /v1/confirm se symbolem a směrem.
  4. 4Otevřete futures pozici pouze na CONFIRM, škálujte nominální hodnotu podle size_mult.

Pracovní příklad

Tento bot potvrzuje long nebo short pomocí GET /v1/confirm?symbol=BTC&direction=long a otevírá pozici Binance USDⓈ-M futures pouze tehdy, když je akce 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)

Očekávaná odpověď

Úspěšné volání /v1/confirm vrátí JSON jako tento:

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 se pohybuje od -1.0 (silný proti) do +1.0 (silné potvrzení), confidence je HIGH nebo MEDIUM, a size_mult je navržený multiplikátor velikosti 0.0–1.5. Podívejte se na úplný odkaz na pole v API dokumentaci.

Jak reagovat na odpověď

CONFIRM

Kontext podporuje váš směr. Otevřete pozici podle vlastních pravidel rizika, škálujte nominální hodnotu podle size_mult.

REDUCE

Signály jsou smíšené. Zvažte menší pozici a těsnější páku, nebo počkejte na potvrzení.

SKIP

Kontext trhu tuto obchod nepodporuje. Stůjte stranou a znovu zkontrolujte při dalším signálu.

Jste připraveni stavět?

Získejte bezplatný klíč a proveďte první volání potvrzení za méně než minutu.

Nejedná se o finanční poradenství. Obchodování s kryptoměnami zahrnuje riziko.