Entegrasyon Rehberi

Smart Money API ile Bybit perpetual işlem girişlerini onaylayın

CCXT ile canlı Bybit swap piyasa verilerini okuyun, Smart Money API'ye balina akışı ve türev pozisyonlarının yönünüzü destekleyip desteklemediğini sorun, ardından önerilen çarpanla boyutlandırılmış perpetual işlem girişini yapın.

Kimler için uygun

Python geliştiricileri, Bybit USDT-perpetuals botunu CCXT üzerinde çalıştıran ve her giriş öncesinde bağımsız bir piyasa bağlam kontrolü isteyenler. Smart Money API karar destek sistemidir — sizin adınıza emir vermez; CCXT kodunuz yürütme ve risk kontrolünü elinde tutar.

Önkoşullar

  • Python 3.9+ ile pip install ccxt requests.
  • CCXT için yapılandırılmış Bybit 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ı için X-API-Key başlığını kullanır. Anahtar almak için:

  1. 1Ücretsiz bir hesap oluşturun, ardından panonuzu açın.
  2. 2altında gösterilen API anahtarını kopyalayın API Erişimi. Ücretsiz paket, 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? Paketleri karşılaştırın: fiyatlandırma sayfası.

Anahtarınızı 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. 3CCXT ile Bybit takaslarını açın (ccxt.bybit({"options":{"defaultType":"swap"}})), stratejinizin bir aday yön seçmesine izin verin, ardından son bir bağlam kapısı olarak /v1/confirm çağırın.
  4. 4CCXT ile perpetual işlemlerine giriş yapın, yalnızca işlem CONFIRM, boyutlandırma size_mult.

Çalışan örnek

Bu betik, Bybit swap ticker'ını CCXT ile okur, bir yön türetir ve ardından çağrı yapar GET /v1/confirm?symbol=BTC&direction=long giriş yapılıp yapılmayacağına karar vermeden önce.

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

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'dır ve size_mult 0.0–1.5 önerilen boyut çarpanıdır. Tam alan referansı için API dokümanlarına bakın.

Yanıt üzerinde 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 ölçeklendirin 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.

Hazır mısınız?

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

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