Hướng dẫn tích hợp
Xác nhận điểm vào lệnh trong bot Binance Futures
Thêm một bước kiểm tra bối cảnh thị trường vào bot Binance USDⓈ-M futures: xác nhận hướng giao dịch thông qua dòng tiền cá voi và vị thế phái sinh, sau đó điều chỉnh kích thước lệnh theo hệ số nhân được đề xuất.
Đối tượng sử dụng
Nhà phát triển đang vận hành bot Binance USDⓈ-M perpetual futures muốn có một lớp xác nhận độc lập trước mỗi lần vào lệnh. Smart Money API là công cụ hỗ trợ quyết định - bot của bạn vẫn kiểm soát hoàn toàn việc đặt lệnh và quản lý rủi ro.
Điều kiện tiên quyết
- Python 3.9+ với
pip install ccxt requests(CCXT hỗ trợ Binance USDⓈ-M futures). - API keys Binance futures có quyền giao dịch (kiểm tra trên testnet trước).
- Một Smart Money API key (gói miễn phí hỗ trợ BTC).
Lấy API key của bạn
Mỗi yêu cầu được xác thực bằng X-API-Key header. Để lấy key:
- 1Tạo tài khoản miễn phí, sau đó mở bảng điều khiển.
- 2Sao chép API key hiển thị dưới mục Truy cập API. Gói miễn phí hỗ trợ BTC với 20 yêu cầu/ngày - đủ để kiểm tra toàn bộ hướng dẫn này.
- 3Cần thêm mã hoặc giới hạn cao hơn? So sánh các gói trên trang giá.
Giữ key bí mật - lưu trữ trong biến môi trường, không bao giờ đưa vào hệ thống kiểm soát nguồn.
Thiết lập
- 1Giữ nguyên logic vào lệnh hiện tại tạo ra tín hiệu long/short tiềm năng.
- 2Xuất key của bạn:
export SMA_API_KEY="sm_your_key_here". - 3Trước mỗi lần vào lệnh, gọi
/v1/confirmvới mã và hướng giao dịch. - 4Chỉ mở vị thế futures khi
CONFIRM, điều chỉnh giá trị theosize_mult.
Ví dụ minh họa
Bot này xác nhận long hoặc short với GET /v1/confirm?symbol=BTC&direction=long và chỉ mở vị thế Binance USDⓈ-M futures khi hành động là 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)
Phản hồi mong đợi
Một lệnh gọi thành công tới /v1/confirm trả về JSON như sau:
{
"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 dao động từ -1.0 (phản đối mạnh) đến +1.0 (xác nhận mạnh), confidence là HIGH hoặc MEDIUM, và size_mult là hệ số nhân kích thước đề xuất 0.0–1.5. Xem tài liệu đầy đủ tại tài liệu API.
Cách hành động dựa trên phản hồi
XÁC NHẬN
Bối cảnh hỗ trợ hướng giao dịch của bạn. Mở vị thế với quy tắc rủi ro riêng, điều chỉnh giá trị theo size_mult.
GIẢM
Tín hiệu hỗn hợp. Cân nhắc vị thế nhỏ hơn và đòn bẩy chặt chẽ hơn, hoặc chờ xác nhận.
BỎ QUA
Bối cảnh thị trường không hỗ trợ giao dịch này. Đứng ngoài và kiểm tra lại ở tín hiệu tiếp theo.
Sẵn sàng xây dựng?
Lấy key miễn phí và thực hiện lệnh xác nhận đầu tiên trong chưa đầy một phút.
Không phải lời khuyên tài chính. Giao dịch crypto có rủi ro.