Panduan Integrasi

Sahkan entri Bybit perpetuals dengan Smart Money API

Baca data pasaran swap Bybit secara langsung dengan CCXT, tanya Smart Money API sama ada aliran ikan paus dan kedudukan derivatif mengesahkan arah anda, kemudian letakkan entri perpetuals — bersaiz dengan pengganda yang dicadangkan.

Untuk siapa ini

Pembangun Python yang menjalankan bot Bybit USDT-perpetuals pada CCXT yang ingin semakan konteks pasaran bebas sebelum setiap entri. Smart Money API adalah sokongan keputusan — ia tidak meletakkan pesanan untuk anda; kod CCXT anda tetap mengawal pelaksanaan dan risiko.

Prasyarat

  • Python 3.9+ dengan pip install ccxt requests.
  • Kunci API Bybit dikonfigurasi untuk CCXT (baca sahaja sudah cukup untuk ujian).
  • Kunci API Smart Money (tier percuma meliputi BTC).

Dapatkan kunci API anda

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

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

Jaga kerahsiaan kunci — simpan dalam pembolehubah persekitaran, jangan sekali-kali mengkomitnya ke kawalan sumber.

Persediaan

  1. 1Pasang pustaka: pip install ccxt requests.
  2. 2Eksport kunci anda: export SMA_API_KEY="sm_your_key_here".
  3. 3Buka swap Bybit dengan CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), biarkan strategi anda memilih arah calon, kemudian panggil /v1/confirm sebagai gerbang konteks akhir.
  4. 4Letakkan entri perpetuals dengan CCXT hanya apabila tindakan adalah CONFIRM, bersaiz dengan size_mult.

Contoh berfungsi

Skrip ini membaca ticker swap Bybit dengan CCXT, memperoleh arah calon, kemudian memanggil GET /v1/confirm?symbol=BTC&direction=long sebelum memutuskan sama ada untuk meletakkan entri.

bybit_confirm.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]            # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"

exchange = ccxt.bybit({"options": {"defaultType": "swap"}})   # Bybit perpetuals

def confirm(symbol: str, direction: str) -> dict:
    """Ask Smart Money API for market-context confirmation."""
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "bybit-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# 1. Read Bybit swap market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT:USDT")
direction = "long" if ticker["percentage"] and ticker["percentage"] > 0 else "short"

# 2. Confirm with Smart Money API before acting
sig = confirm("BTC", direction)
print(sig["action"], sig["confidence"], "size_mult", sig["size_mult"])

# 3. Act on the recommendation (CCXT executes; the API only advises)
if sig["action"] == "CONFIRM":
    base_qty = 0.01
    qty = base_qty * sig["size_mult"]          # scale by suggested multiplier
    # exchange.create_order("BTC/USDT:USDT", "market", direction, qty)
    print(f"Would place {direction} {qty} BTC/USDT:USDT perp")
elif sig["action"] == "REDUCE":
    print("Context is mixed -> trade smaller or wait for a cleaner setup")
else:  # SKIP
    print("Context does not support this trade -> stand aside")

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 HIGH atau MEDIUM, dan size_mult adalah pengganda saiz yang dicadangkan 0.0–1.5. Lihat rujukan medan penuh dalam dokumentasi API.

Bagaimana untuk bertindak berdasarkan respons

SAHKAN

Konteks menyokong arah anda. Teruskan dengan entri dan peraturan risiko anda sendiri, secara pilihan menyesuaikan saiz dengan size_mult.

KURANGKAN

Isyarat bercampur. Pertimbangkan posisi yang lebih kecil, hentian yang lebih ketat, atau menunggu setup yang lebih bersih.

LANGKAH

Konteks pasaran tidak menyokong perdagangan ini. Berdiri di tepi dan semak semula pada calon 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.