Panduan Integrasi
Sahkan kemasukan dalam bot Binance Futures
Tambahkan pintu konteks pasaran terakhir ke bot Binance USDⓈ-M futures anda: sahkan arah dengan aliran ikan paus dan posisi derivatif, kemudian saizkan pesanan dengan pengganda yang dicadangkan.
Untuk siapa ini
Pembangun yang menjalankan bot Binance USDⓈ-M perpetual futures yang ingin lapisan pengesahan bebas sebelum setiap kemasukan. Smart Money API adalah sokongan keputusan — bot anda mengekalkan kawalan penuh ke atas penempatan pesanan dan pengurusan risiko.
Prasyarat
- Python 3.9+ dengan
pip install ccxt requests(CCXT merangkumi Binance USDⓈ-M futures). - Kunci API Binance futures dengan kebenaran perdagangan (uji dahulu pada testnet).
- Kunci API Smart Money API (tahap percuma merangkumi BTC).
Dapatkan kunci API anda
Setiap permintaan disahkan dengan X-API-Key header. Untuk mendapatkan kunci:
- 1Buat akaun percuma, kemudian buka papan pemuka.
- 2Salin kunci API yang ditunjukkan di bawah Akses API. Tahap percuma merangkumi BTC pada 100 permintaan/hari — cukup untuk menguji panduan ini dari awal hingga akhir.
- 3Perlukan lebih banyak simbol atau had yang lebih tinggi? Bandingkan tahap pada halaman harga.
Simpan kunci tersebut dengan rahsia — simpan dalam pembolehubah persekitaran, jangan sekali-kali menyimpannya dalam kawalan sumber.
Persediaan
- 1Kekalkan logik kemasukan sedia ada anda yang menghasilkan isyarat panjang/pendek calon.
- 2Eksport kunci anda:
export SMA_API_KEY="sm_your_key_here". - 3Sebelum setiap kemasukan, panggil
/v1/confirmdengan simbol dan arah. - 4Buka posisi futures hanya pada
CONFIRM, skala notional olehsize_mult.
Contoh berfungsi
Bot ini mengesahkan panjang atau pendek dengan GET /v1/confirm?symbol=BTC&direction=long dan hanya membuka posisi Binance USDⓈ-M futures apabila tindakan 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 dijangka
Panggilan berjaya 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 (pengesahan kuat), confidence adalah TINGGI atau SEDERHANA, dan size_mult adalah pengganda saiz yang dicadangkan 0.0–1.5. Lihat rujukan medan penuh dalam dokumentasi API.
Cara bertindak berdasarkan respons
SAHKAN
Konteks menyokong arah anda. Buka posisi dengan peraturan risiko anda sendiri, skala notional oleh size_mult.
KURANGKAN
Isyarat bercampur. Pertimbangkan posisi yang lebih kecil dan leverage yang lebih ketat, atau tunggu pengesahan.
LANGKAU
Konteks pasaran tidak menyokong perdagangan ini. Berdiri di tepi dan semak semula pada isyarat seterusnya.
Sedia untuk membina?
Ambil kunci percuma dan buat panggilan pengesahan pertama anda dalam masa kurang dari seminit.
Bukan nasihat kewangan. Perdagangan kripto melibatkan risiko.