Panduan Integrasi

Gunakan Smart Money API bersama CCXT

Baca data pasaran langsung dengan CCXT, tanya Smart Money API sama ada aliran ikan paus dan posisi derivatif mengesahkan arah anda, kemudian buat pesanan di bursa pilihan anda.

Untuk siapa ini

Pembangun Python yang membina bot bebas bursa pada CCXT yang ingin semakan konteks pasaran bebas sebelum setiap pesanan. Smart Money API adalah sokongan keputusan — ia tidak membuat pesanan untuk anda; CCXT tetap mengawal pelaksanaan.

Prasyarat

  • Python 3.9+ dengan pip install ccxt requests.
  • Kunci API bursa dikonfigurasi untuk CCXT (baca sahaja sudah cukup untuk ujian).
  • Kunci Smart Money API (tahap percuma meliputi 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 meliputi BTC pada 100 permintaan/hari — cukup untuk menguji panduan ini dari awal hingga akhir.
  3. 3Perlukan lebih banyak simbol atau had lebih tinggi? Bandingkan tahap di halaman harga.

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

Persediaan

  1. 1Pasang pustaka: pip install ccxt requests.
  2. 2Eksport kunci anda: export SMA_API_KEY="sm_your_key_here".
  3. 3Biarkan strategi anda memutuskan calon arah dari data pasaran CCXT, kemudian panggil /v1/confirm sebagai pintu konteks akhir.
  4. 4Buat pesanan dengan CCXT hanya apabila tindakan adalah CONFIRM, saiz mengikut size_mult.

Contoh berfungsi

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

ccxt_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.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 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 cadangan 0.0–1.5. Lihat rujukan medan penuh dalam dok API.

Cara bertindak berdasarkan respons

SAHKAN

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

KURANGKAN

Isyarat bercampur. Pertimbangkan posisi lebih kecil, hentian lebih ketat, atau menunggu persediaan lebih jelas.

LANGKAH

Konteks pasaran tidak menyokong dagangan ini. Berdiri di tepi dan semak semula pada calon seterusnya.

Sedia untuk membina?

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

Bukan nasihat kewangan. Dagangan kripto melibatkan risiko.