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:
- 1Buat akun gratis, lalu buka dashboard.
- 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.
- 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
- 1Pertahankan logika entri Anda yang menghasilkan sinyal long/short kandidat.
- 2Ekspor kunci Anda:
export SMA_API_KEY="sm_your_key_here". - 3Sebelum setiap entri, panggil
/v1/confirmdengan simbol dan arah. - 4Buka posisi futures hanya pada
CONFIRM, sesuaikan nominal dengansize_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.
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:
{
"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.