整合指南
在Binance期貨機器人中確認進場點
為您的Binance USDⓈ-M期貨機器人添加最終市場情境閘門：透過巨鯨資金流向與衍生品持倉確認方向，再根據建議倍數調整訂單規模。
適用對象
正在運行Binance USDⓈ-M永續期貨機器人，且希望每次進場前獲得獨立確認層的開發者。Smart Money API僅提供決策支援——您的機器人仍完全掌握下單與風險控制。
必要條件
- Python 3.9+ 環境
pip install ccxt requests（CCXT支援Binance USDⓈ-M期貨）。 - 具交易權限的Binance期貨API金鑰（請先在測試網試用）。
- 一組Smart Money API金鑰（免費方案涵蓋BTC）。
取得API金鑰
每個請求都需透過 X-API-Key 標頭進行驗證。取得金鑰步驟：
請妥善保管金鑰 —— 將其儲存在環境變數中，切勿提交至版本控制系統。
設定
- 1保留您現有的進場邏輯，該邏輯會產生多頭/空頭候選訊號。
- 2匯出您的金鑰：
export SMA_API_KEY="sm_your_key_here". - 3在每次進場前，呼叫
/v1/confirm並帶入交易對與方向參數。 - 4僅在
CONFIRM時開立期貨部位，並按名目金額比例調整size_mult.
實例演示
此機器人透過以下方式確認做多或做空 GET /v1/confirm?symbol=BTC&direction=long 僅在行動符合條件時開立Binance USDⓈ-M合約倉位 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)
預期回應
成功呼叫 /v1/confirm 將返回如下JSON格式數據：
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（強烈反向）到+1.0（強烈確認）， confidence 為HIGH或MEDIUM等級，且 size_mult 是0.0–1.5的建議倉位倍數。完整字段說明請參閱 API文檔.
如何根據回應操作
確認
市場環境支持您的方向。根據自身風險規則開倉，名義金額按比例調整 size_mult.
減倉
信號混雜。建議縮小倉位並降低槓桿，或等待進一步確認。
跳過
市場環境不支持此交易。請保持觀望並等待下次信號。
準備開始構建？
獲取免費API金鑰，一分鐘內完成首次確認呼叫。
非財務建議。加密貨幣交易存在風險。