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:
- 1Vytvořte si bezplatný účet, poté otevřete svůj dashboard.
- 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.
- 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í
- 1Zachovejte svou stávající logiku vstupu, která vytváří kandidátní signál pro long/short.
- 2Exportujte svůj klíč:
export SMA_API_KEY="sm_your_key_here". - 3Před každým vstupem volejte
/v1/confirmse symbolem a směrem. - 4Otevřete futures pozici pouze na
CONFIRM, škálujte nominální hodnotu podlesize_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.
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:
{
"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.