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:
- 1Buat akun gratis, lalu buka dashboard.
- 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.
- 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
- 1Instal library:
pip install ccxt requests. - 2Ekspor kunci Anda:
export SMA_API_KEY="sm_your_key_here". - 3Buka swap Bybit dengan CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), biarkan strategi Anda memilih arah kandidat, lalu panggil/v1/confirmsebagai gerbang konteks akhir. - 4Lakukan entri perpetuals dengan CCXT hanya ketika aksinya adalah
CONFIRM, ukuran berdasarkansize_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.
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:
{
"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.