Panduan Integrasi

Sahkan kemasukan dalam bot Binance Futures

Tambahkan pintu konteks pasaran terakhir ke bot Binance USDⓈ-M futures anda: sahkan arah dengan aliran ikan paus dan posisi derivatif, kemudian saizkan pesanan dengan pengganda yang dicadangkan.

Untuk siapa ini

Pembangun yang menjalankan bot Binance USDⓈ-M perpetual futures yang ingin lapisan pengesahan bebas sebelum setiap kemasukan. Smart Money API adalah sokongan keputusan — bot anda mengekalkan kawalan penuh ke atas penempatan pesanan dan pengurusan risiko.

Prasyarat

  • Python 3.9+ dengan pip install ccxt requests (CCXT merangkumi Binance USDⓈ-M futures).
  • Kunci API Binance futures dengan kebenaran perdagangan (uji dahulu pada testnet).
  • Kunci API Smart Money API (tahap percuma merangkumi BTC).

Dapatkan kunci API anda

Setiap permintaan disahkan dengan X-API-Key header. Untuk mendapatkan kunci:

  1. 1Buat akaun percuma, kemudian buka papan pemuka.
  2. 2Salin kunci API yang ditunjukkan di bawah Akses API. Tahap percuma merangkumi BTC pada 100 permintaan/hari — cukup untuk menguji panduan ini dari awal hingga akhir.
  3. 3Perlukan lebih banyak simbol atau had yang lebih tinggi? Bandingkan tahap pada halaman harga.

Simpan kunci tersebut dengan rahsia — simpan dalam pembolehubah persekitaran, jangan sekali-kali menyimpannya dalam kawalan sumber.

Persediaan

  1. 1Kekalkan logik kemasukan sedia ada anda yang menghasilkan isyarat panjang/pendek calon.
  2. 2Eksport kunci anda: export SMA_API_KEY="sm_your_key_here".
  3. 3Sebelum setiap kemasukan, panggil /v1/confirm dengan simbol dan arah.
  4. 4Buka posisi futures hanya pada CONFIRM, skala notional oleh size_mult.

Contoh berfungsi

Bot ini mengesahkan panjang atau pendek dengan GET /v1/confirm?symbol=BTC&direction=long dan hanya membuka posisi Binance USDⓈ-M futures apabila tindakan adalah 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)

Respons yang dijangka

Panggilan berjaya ke /v1/confirm mengembalikan JSON seperti ini:

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 berkisar dari -1.0 (kontra kuat) hingga +1.0 (pengesahan kuat), confidence adalah TINGGI atau SEDERHANA, dan size_mult adalah pengganda saiz yang dicadangkan 0.0–1.5. Lihat rujukan medan penuh dalam dokumentasi API.

Cara bertindak berdasarkan respons

SAHKAN

Konteks menyokong arah anda. Buka posisi dengan peraturan risiko anda sendiri, skala notional oleh size_mult.

KURANGKAN

Isyarat bercampur. Pertimbangkan posisi yang lebih kecil dan leverage yang lebih ketat, atau tunggu pengesahan.

LANGKAU

Konteks pasaran tidak menyokong perdagangan ini. Berdiri di tepi dan semak semula pada isyarat seterusnya.

Sedia untuk membina?

Ambil kunci percuma dan buat panggilan pengesahan pertama anda dalam masa kurang dari seminit.

Bukan nasihat kewangan. Perdagangan kripto melibatkan risiko.