คู่มือการบูรณาการ

ยืนยันการเข้าซื้อขายในบอท Binance Futures

เพิ่มขั้นตอนการตรวจสอบบริบทตลาดสุดท้ายให้กับบอท Binance USDⓈ-M futures ของคุณ: ยืนยันทิศทางด้วยการไหลของเงินจากผู้เล่นใหญ่และตำแหน่งอนุพันธ์ จากนั้นปรับขนาดคำสั่งซื้อด้วยตัวคูณที่แนะนำ

สำหรับใคร

นักพัฒนาที่ใช้งานบอท Binance USDⓈ-M perpetual futures และต้องการชั้นการยืนยันอิสระก่อนการเข้าซื้อขายแต่ละครั้ง Smart Money API เป็นเครื่องมือสนับสนุนการตัดสินใจ — บอทของคุณยังคงควบคุมการวางคำสั่งและการจัดการความเสี่ยงทั้งหมด

ข้อกำหนดเบื้องต้น

  • Python 3.9+ พร้อม pip install ccxt requests (CCXT ครอบคลุม Binance USDⓈ-M futures)
  • คีย์ API Binance futures ที่มีสิทธิ์ในการซื้อขาย (ทดสอบบน testnet ก่อน)
  • คีย์ API Smart Money API (ระดับฟรีครอบคลุม BTC)

รับคีย์ API ของคุณ

ทุกคำขอจะได้รับการตรวจสอบสิทธิ์ด้วย X-API-Key ส่วนหัว เพื่อรับคีย์:

  1. 1สร้างบัญชีฟรี จากนั้นเปิด แดชบอร์ด.
  2. 2คัดลอกคีย์ API ที่แสดงอยู่ใต้ การเข้าถึง APIระดับฟรีครอบคลุม BTC ที่ 20 คำขอ/วัน — เพียงพอสำหรับการทดสอบคู่มือนี้ตั้งแต่ต้นจนจบ
  3. 3ต้องการสัญลักษณ์เพิ่มเติมหรือขีดจำกัดที่สูงขึ้นหรือไม่? เปรียบเทียบระดับต่างๆ บน หน้าตราคา.

เก็บคีย์ไว้เป็นความลับ — บันทึกไว้ในตัวแปรสภาพแวดล้อม อย่าเก็บไว้ในระบบควบคุมเวอร์ชัน

การตั้งค่า

  1. 1รักษาโลจิกการเข้าซื้อขายที่มีอยู่ซึ่งสร้างสัญญาณซื้อ/ขายเบื้องต้น
  2. 2ส่งออกคีย์ของคุณ: export SMA_API_KEY="sm_your_key_here".
  3. 3ก่อนการเข้าซื้อขายแต่ละครั้ง ให้เรียก /v1/confirm ด้วยสัญลักษณ์และทิศทาง
  4. 4เปิดตำแหน่ง futures เฉพาะเมื่อ CONFIRMปรับขนาดมูลค่าตาม size_mult.

ตัวอย่างการทำงาน

บอทนี้ยืนยันการซื้อหรือขายด้วย GET /v1/confirm?symbol=BTC&direction=long และจะเปิดตำแหน่ง Binance USDⓈ-M futures เฉพาะเมื่อการกระทำคือ 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.

ลด

สัญญาณผสมกัน พิจารณาตำแหน่งที่เล็กลงและเลเวอเรจที่แน่นขึ้น หรือรอการยืนยัน

ข้าม

บริบทตลาดไม่สนับสนุนการซื้อขายนี้ ถอยออกและตรวจสอบใหม่ในสัญญาณถัดไป

พร้อมที่จะสร้างหรือยัง?

รับคีย์ฟรีและทำการเรียกยืนยันครั้งแรกในไม่ถึงหนึ่งนาที

ไม่ใช่คำแนะนำทางการเงิน การซื้อขายคริปโตมีความเสี่ยง