Panduan Integrasi
Gunakan Smart Money API bersama CCXT
Baca data pasar langsung dengan CCXT, tanyakan Smart Money API apakah aliran paus dan posisi derivatif mengonfirmasi arah Anda, lalu tempatkan pesanan di bursa pilihan Anda.
Untuk siapa ini
Pengembang Python yang membangun bot yang tidak tergantung pada bursa di CCXT yang ingin pemeriksaan konteks pasar independen sebelum setiap pesanan. Smart Money API adalah dukungan keputusan — tidak menempatkan pesanan untuk Anda; CCXT tetap mengontrol eksekusi.
Prasyarat
- Python 3.9+ dengan
pip install ccxt requests. - Kunci API bursa yang dikonfigurasi untuk CCXT (hanya baca saja sudah cukup untuk menguji).
- 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 batas lebih tinggi? Bandingkan tingkatan di halaman harga.
Jaga kerahasiaan kunci — simpan dalam variabel lingkungan, jangan pernah menyimpannya dalam kontrol sumber.
Persiapan
- 1Instal pustaka:
pip install ccxt requests. - 2Ekspor kunci Anda:
export SMA_API_KEY="sm_your_key_here". - 3Biarkan strategi Anda memutuskan arah kandidat dari data pasar CCXT, lalu panggil
/v1/confirmsebagai gerbang konteks akhir. - 4Tempatkan pesanan dengan CCXT hanya ketika aksinya adalah
CONFIRM, ukuran olehsize_mult.
Contoh yang berfungsi
Skrip ini membaca ticker dengan CCXT, menurunkan arah kandidat, lalu memanggil GET /v1/confirm?symbol=BTC&direction=long sebelum memutuskan apakah akan menempatkan pesanan.
import os
import ccxt
import requests
API_KEY = os.environ["SMA_API_KEY"] # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"
exchange = ccxt.binance() # any CCXT exchange
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": "ccxt-bot"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/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", "market", direction, qty)
print(f"Would place {direction} {qty} BTC/USDT")
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 yang 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 bidang di dokumentasi API.
Cara bertindak berdasarkan respons
KONFIRMASI
Konteks mendukung arah Anda. Lanjutkan dengan aturan masuk dan risiko Anda sendiri, opsional menyesuaikan ukuran dengan size_mult.
KURANGI
Sinyal beragam. Pertimbangkan posisi yang lebih kecil, stop yang lebih ketat, atau menunggu setup yang lebih jelas.
LEWATI
Konteks pasar tidak mendukung perdagangan ini. Berdiri di samping dan periksa ulang pada kandidat berikutnya.
Siap membangun?
Ambil kunci gratis dan buat panggilan konfirmasi pertama Anda dalam waktu kurang dari satu menit.
Bukan saran finansial. Perdagangan kripto melibatkan risiko.