Panduan Integrasi

Konfirmasi entri perpetuals Bybit dengan Smart Money API

Baca data pasar swap Bybit secara live dengan CCXT, tanyakan Smart Money API apakah aliran whale dan posisi derivatif mengonfirmasi arah Anda, lalu lakukan entri perpetuals — dengan ukuran berdasarkan pengali yang disarankan.

Untuk siapa ini

Pengembang Python yang menjalankan bot perpetuals USDT Bybit pada CCXT yang ingin pemeriksaan konteks pasar independen sebelum setiap entri. Smart Money API adalah pendukung keputusan — tidak mengeksekusi order untuk Anda; kode CCXT Anda tetap mengontrol eksekusi dan risiko.

Prasyarat

  • Python 3.9+ dengan pip install ccxt requests.
  • Kunci API Bybit yang dikonfigurasi untuk CCXT (hanya baca cukup untuk testing).
  • Kunci API Smart Money API (tingkat gratis mencakup BTC).

Dapatkan kunci API Anda

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

  1. 1Buat akun gratis, lalu buka dashboard.
  2. 2Salin kunci API yang ditampilkan di bawah Akses API. Tingkat gratis mencakup BTC dengan 100 permintaan/hari — cukup untuk menguji panduan ini dari awal hingga akhir.
  3. 3Butuh lebih banyak simbol atau limit lebih tinggi? Bandingkan tingkatan di harga.

Jaga kerahasiaan kunci — simpan dalam variabel lingkungan, jangan pernah commit ke source control.

Persiapan

  1. 1Instal library: pip install ccxt requests.
  2. 2Ekspor 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 kandidat, lalu panggil /v1/confirm sebagai gerbang konteks akhir.
  4. 4Lakukan entri perpetuals dengan CCXT hanya ketika aksinya adalah CONFIRM, ukuran berdasarkan size_mult.

Contoh kerja

Skrip ini membaca ticker swap Bybit dengan CCXT, menentukan arah kandidat, lalu memanggil GET /v1/confirm?symbol=BTC&direction=long sebelum memutuskan apakah akan melakukan 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 diharapkan

Panggilan berhasil 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 (konfirmasi kuat), confidence adalah TINGGI atau SEDANG, dan size_mult adalah pengali ukuran yang disarankan 0.0–1.5. Lihat referensi lengkap field di dokumentasi API.

Cara bertindak berdasarkan respons

KONFIRMASI

Konteks mendukung arah Anda. Lanjutkan dengan aturan entri dan risiko Anda, opsional menyesuaikan ukuran dengan size_mult.

KURANGI

Sinyal bercampur. Pertimbangkan posisi lebih kecil, stop lebih ketat, atau menunggu setup yang lebih jelas.

LEWATI

Konteks pasar tidak mendukung trade ini. Berhenti sejenak dan periksa kembali kandidat berikutnya.

Siap membangun?

Ambil kunci gratis dan lakukan panggilan konfirmasi pertama dalam kurang dari satu menit.

Bukan nasihat finansial. Trading kripto melibatkan risiko.