Entegrasyon Kılavuzu

Smart Money API'yi CCXT ile birlikte kullanın

CCXT ile canlı piyasa verilerini okuyun, Smart Money API'ye balina akışı ve türev pozisyonlarının yönünüzü onaylayıp onaylamadığını sorun, ardından tercih ettiğiniz borsada emri verin.

Bu kimler için?

Python geliştiricileri, borsa bağımsız botlar oluşturan CCXT her emir öncesinde bağımsız bir piyasa bağlamı kontrolü isteyenler. Smart Money API karar destek sistemidir — sizin yerinize emir vermez; CCXT yürütme kontrolünü elinde tutar.

Ön Koşullar

  • Python 3.9+ ile pip install ccxt requests.
  • CCXT için yapılandırılmış borsa API anahtarları (test için salt okunur yeterlidir).
  • Bir Smart Money API anahtarı (ücretsiz katman BTC'yi kapsar).

API anahtarınızı alın

Her istek, kimlik doğrulaması yapmak için X-API-Key başlığını kullanır. Anahtar almak için:

  1. 1Ücretsiz bir hesap oluşturun, ardından gösterge panelinizi açın.
  2. 2altında gösterilen API anahtarını kopyalayın API Erişimi. Ücretsiz katman, BTC için günde 20 istek hakkı sunar — bu kılavuzu baştan sona test etmek için yeterlidir.
  3. 3Daha fazla sembol veya daha yüksek limitler mi gerekiyor? Katmanları karşılaştırın fiyatlandırma sayfasında.

Anahtarı gizli tutun — bir ortam değişkeninde saklayın, asla kaynak kontrolüne eklemeyin.

Kurulum

  1. 1Kütüphaneleri yükleyin: pip install ccxt requests.
  2. 2Anahtarınızı dışa aktarın: export SMA_API_KEY="sm_your_key_here".
  3. 3Stratejinizin CCXT piyasa verilerinden bir aday yön belirlemesine izin verin, ardından /v1/confirm son bir bağlam kapısı olarak çağırın.
  4. 4Sadece işlem olduğunda CCXT ile sipariş verin CONFIRM, boyutlandırarak size_mult.

Çalışan örnek

Bu betik CCXT ile bir sembol okur, bir yön adayı belirler ve ardından GET /v1/confirm?symbol=BTC&direction=long siparişi yerleştirip yerleştirmeyeceğine karar vermeden önce

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")

Beklenen yanıt

Başarılı bir çağrı /v1/confirm şu şekilde bir JSON döndürür:

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 -1.0 (güçlü karşıt) ile +1.0 (güçlü onay) arasında değişir, confidence YÜKSEK veya ORTA seviyededir ve size_mult 0.0–1.5 aralığında önerilen bir boyut çarpanıdır. Tüm alan referansı için API dokümanlarına.

Yanıtla nasıl hareket edilir

ONAY

Bağlam yönünüzü destekliyor. Kendi giriş ve risk kurallarınızla devam edin, isteğe bağlı olarak boyutu size_mult.

AZALT

Sinyaller karışık. Daha küçük bir pozisyon, daha sıkı stoplar veya daha temiz bir kurulum beklemeyi düşünün.

ATLA

Piyasa bağlamı bu işlemi desteklemiyor. Kenara çekilin ve bir sonraki adayı tekrar kontrol edin.

Oluşturmaya hazır mısınız?

Ücretsiz bir anahtar alın ve bir dakikadan kısa sürede ilk onay çağrınızı yapın.

Finansal tavsiye değildir. Kripto ticareti risk içerir.