Gabay sa Integrasyon

Kumpirmahin ang mga entry sa isang Binance Futures bot

Magdagdag ng panghuling market-context gate sa iyong Binance USDⓈ-M futures bot: kumpirmahin ang direksyon gamit ang whale flow at derivatives positioning, pagkatapos ay i-size ang order ayon sa suggested multiplier.

Para kanino ito

Mga developer na nagpapatakbo ng Binance USDⓈ-M perpetual futures bot na gustong magkaroon ng independiyenteng confirmation layer bago ang bawat entry. Ang Smart Money API ay decision support — ang iyong bot ay mananatiling may buong kontrol sa order placement at risk management.

Mga Kailangan

  • Python 3.9+ with pip install ccxt requests (Saklaw ng CCXT ang Binance USDⓈ-M futures).
  • Binance futures API keys na may trade permission (subukan muna sa testnet).
  • Isang Smart Money API key (saklaw ng free tier ang BTC).

Kunin ang iyong API key

Ang bawat request ay nagpapatunay gamit ang X-API-Key header. Para makakuha ng key:

  1. 1Gumawa ng libreng account, pagkatapos buksan ang iyong dashboard.
  2. 2Kopyahin ang API key na makikita sa ilalim ng API Access. Saklaw ng free tier ang BTC sa 200 requests/day — sapat para subukan ang gabay na ito mula simula hanggang katapusan.
  3. 3Kailangan ng mas maraming simbolo o mas mataas na limit? Ihambing ang mga tier sa pricing page.

Panatilihing lihim ang key — itago ito sa environment variable, huwag itong i-commit sa source control.

Setup

  1. 1Panatilihin ang iyong existing entry logic na gumagawa ng candidate long/short signal.
  2. 2I-export ang iyong key: export SMA_API_KEY="sm_your_key_here".
  3. 3Bago ang bawat entry, tawagan ang /v1/confirm gamit ang symbol at direksyon.
  4. 4Buksan ang futures position lamang sa CONFIRM, i-scale ang notional ayon sa size_mult.

Working example

Ang bot na ito ay nagkukumpirma ng long o short gamit ang GET /v1/confirm?symbol=BTC&direction=long at nagbubukas lamang ng Binance USDⓈ-M futures position kapag ang aksyon ay 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)

Inaasahang response

Ang matagumpay na tawag sa /v1/confirm ay nagbabalik ng JSON na ganito:

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 ay mula -1.0 (strong contra) hanggang +1.0 (strong confirm), confidence ay HIGH o MEDIUM, at size_mult ay 0.0–1.5 suggested size multiplier. Tingnan ang buong field reference sa API docs.

Paano kumilos sa response

CONFIRM

Sinusuportahan ng konteksto ang iyong direksyon. Buksan ang position gamit ang iyong sariling risk rules, i-scale ang notional ayon sa size_mult.

REDUCE

Magkahalo ang mga signal. Isaalang-alang ang mas maliit na position at mas mahigpit na leverage, o maghintay ng kumpirmasyon.

SKIP

Hindi sinusuportahan ng market context ang trade na ito. Maghintay at mag-recheck sa susunod na signal.

Handa nang magtayo?

Kumuha ng libreng key at gumawa ng iyong unang confirmation call sa ilalim ng isang minuto.

Hindi ito financial advice. May risk ang crypto trading.