Panduan Integrasi

Konfirmasi entri dalam bot Binance Futures

Tambahkan gerbang konteks pasar akhir ke bot Binance USDⓈ-M futures Anda: konfirmasi arah dengan aliran whale dan posisi derivatif, lalu sesuaikan ukuran pesanan dengan pengali yang disarankan.

Untuk siapa ini

Pengembang yang menjalankan bot Binance USDⓈ-M perpetual futures yang ingin lapisan konfirmasi independen sebelum setiap entri. Smart Money API adalah pendukung keputusan — bot Anda tetap memegang kendali penuh atas penempatan pesanan dan manajemen risiko.

Prasyarat

  • Python 3.9+ dengan pip install ccxt requests (CCXT mencakup Binance USDⓈ-M futures).
  • Kunci API Binance futures dengan izin perdagangan (uji di testnet terlebih dahulu).
  • Kunci API Smart Money API (tingkat gratis mencakup BTC).

Dapatkan kunci API Anda

Setiap permintaan diautentikasi dengan X-API-Key header. Untuk mendapatkan kunci:

  1. 1Buat akun gratis, lalu buka dashboard.
  2. 2Salin kunci API yang ditampilkan di bawah Akses API. Tingkat gratis mencakup BTC dengan 100 permintaan/hari — cukup untuk menguji panduan ini dari awal hingga akhir.
  3. 3Butuh lebih banyak simbol atau limit lebih tinggi? Bandingkan tingkatan di harga.

Jaga kerahasiaan kunci — simpan dalam variabel lingkungan, jangan pernah simpan dalam kontrol sumber.

Persiapan

  1. 1Pertahankan logika entri Anda yang menghasilkan sinyal long/short kandidat.
  2. 2Ekspor kunci Anda: export SMA_API_KEY="sm_your_key_here".
  3. 3Sebelum setiap entri, panggil /v1/confirm dengan simbol dan arah.
  4. 4Buka posisi futures hanya pada CONFIRM, sesuaikan nominal dengan size_mult.

Contoh kerja

Bot ini mengonfirmasi long atau short dengan GET /v1/confirm?symbol=BTC&direction=long dan hanya membuka posisi Binance USDⓈ-M futures ketika aksinya adalah 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)

Respons yang diharapkan

Panggilan berhasil ke /v1/confirm mengembalikan JSON seperti ini:

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 berkisar dari -1.0 (kontra kuat) hingga +1.0 (konfirmasi kuat), confidence adalah TINGGI atau SEDANG, dan size_mult adalah pengali ukuran yang disarankan 0.0–1.5. Lihat referensi lengkap bidang di dokumentasi API.

Cara menanggapi respons

KONFIRMASI

Konteks mendukung arah Anda. Buka posisi dengan aturan risiko Anda sendiri, sesuaikan nominal dengan size_mult.

KURANGI

Sinyal bercampur. Pertimbangkan posisi lebih kecil dan leverage yang ketat, atau tunggu konfirmasi.

LEWATI

Konteks pasar tidak mendukung perdagangan ini. Berdiri di samping dan periksa kembali pada sinyal berikutnya.

Siap membangun?

Ambil kunci gratis dan buat panggilan konfirmasi pertama Anda dalam waktu kurang dari satu menit.

Bukan saran finansial. Perdagangan kripto melibatkan risiko.