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:

  1. 1Tạo tài khoản miễn phí, sau đó mở bảng điều khiển.
  2. 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.
  3. 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

  1. 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.
  2. 2Xuất key của bạn: export SMA_API_KEY="sm_your_key_here".
  3. 3Trước mỗi lần vào lệnh, gọi /v1/confirm với mã và hướng giao dịch.
  4. 4Chỉ mở vị thế futures khi CONFIRM, điều chỉnh giá trị theo size_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.

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)

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:

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 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.