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Ücretsiz bir hesap oluşturun, ardından gösterge panelinizi açın.
- 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.
- 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
- 1Kütüphaneleri yükleyin:
pip install ccxt requests. - 2Anahtarınızı dışa aktarın:
export SMA_API_KEY="sm_your_key_here". - 3Stratejinizin CCXT piyasa verilerinden bir aday yön belirlemesine izin verin, ardından
/v1/confirmson bir bağlam kapısı olarak çağırın. - 4Sadece işlem olduğunda CCXT ile sipariş verin
CONFIRM, boyutlandıraraksize_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
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:
{
"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.