Entegrasyon Kılavuzu

Binance Futures bot'ta girişleri onaylayın

Binance USDⓈ-M futures bot'unuza son bir piyasa bağlamı kapısı ekleyin: yönü balina akışı ve türev pozisyonlaması ile onaylayın, ardından siparişi önerilen çarpanla boyutlandırın.

Kimler için

Binance USDⓈ-M perpetual futures bot'u çalıştıran ve her girişten önce bağımsız bir onay katmanı isteyen geliştiriciler. Smart Money API karar destek sistemidir — bot'unuz sipariş yerleştirme ve risk yönetimi üzerinde tam kontrole sahiptir.

Ön koşullar

  • Python 3.9+ ile pip install ccxt requests (CCXT, Binance USDⓈ-M futures'ı kapsar).
  • Binance futures API anahtarları ile ticaret izni (önce testnette test edin).
  • Bir Smart Money API anahtarı (ücretsiz katman BTC'yi kapsar).

API anahtarınızı alın

Her istek şu şekilde kimlik doğrular: X-API-Key başlık. Bir anahtar almak için:

  1. 1Ücretsiz bir hesap oluşturun, ardından gösterge paneli.
  2. 2Aşağıda gösterilen API anahtarını kopyalayın API Erişimi. Ücretsiz paket, BTC için günde 20 istek hakkı sunar — bu kılavuzu baştan sona test etmek için yeterlidir.
  3. 3Daha fazla sembol veya daha yüksek limitler mi gerekiyor? Paketleri karşılaştırın: fiyatlandırma sayfası.

Anahtarınızı gizli tutun — bir ortam değişkeninde saklayın, asla kaynak kontrolüne eklemeyin.

Kurulum

  1. 1Uzun/kısa aday sinyali üreten mevcut giriş mantığınızı koruyun.
  2. 2Anahtarınızı dışa aktarın: export SMA_API_KEY="sm_your_key_here".
  3. 3Her girişten önce, sembol ve yön ile birlikte çağırın /v1/confirm .
  4. 4Futures pozisyonunu yalnızca şu durumda açın: CONFIRM, nominal değeri ölçeklendirerek size_mult.

Çalışan örnek

Bu bot, bir uzun veya kısa pozisyonu onaylar ve GET /v1/confirm?symbol=BTC&direction=long yalnızca işlem 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)

Beklenen yanıt

Başarılı bir çağrı /v1/confirm şu şekilde bir JSON döndürür:

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 (güçlü karşıt) ile +1.0 (güçlü onay) arasında değişir, confidence YÜKSEK veya ORTA seviyededir, ve size_mult 0.0–1.5 arasında önerilen bir boyut çarpanıdır. Tüm alan referansları için API dokümanlarına.

Yanıta nasıl tepki verilir

ONAYLA

Bağlam, yönünüzü destekliyor. Pozisyonu kendi risk kurallarınızla açın, nominal değeri size_mult.

AZALT

Sinyaller karışık. Daha küçük bir pozisyon ve daha sıkı kaldıraç düşünün veya onay bekleyin.

ATLA

Piyasa bağlamı bu işlemi desteklemiyor. Kenara çekilin ve bir sonraki sinyali bekleyin.

Hazır mısınız?

Ücretsiz bir anahtar alın ve ilk onay çağrınızı bir dakikadan kısa sürede yapın.

Finansal tavsiye değildir. Kripto ticareti risk içerir.