集成指南
在 Binance Futures 机器人中确认入场
为您的 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 密钥
设置
- 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.
缩减
信号混杂。建议减小仓位并收紧杠杆，或等待进一步确认。
跳过
市场环境不支持此交易。保持观望并在下次信号时重新检查。
准备构建？
获取免费密钥，一分钟内完成首次确认调用。
非财务建议。加密货币交易存在风险。