Przewodnik integracji

Potwierdź wejścia na Bybit perpetuals z Smart Money API

Odczytuj na żywo dane rynkowe swapów Bybit za pomocą CCXT, zapytaj Smart Money API, czy przepływ wielorybów i pozycjonowanie instrumentów pochodnych potwierdzają Twój kierunek, a następnie wykonaj wejście na perpetuals — skalowane sugerowanym mnożnikiem.

Dla kogo jest to przeznaczone

Deweloperzy Pythona uruchamiający bota na Bybit USDT-perpetuals na CCXT którzy chcą niezależnego sprawdzenia kontekstu rynkowego przed każdym wejściem. Smart Money API to wsparcie decyzyjne — nie składa za Ciebie zleceń; Twój kod CCXT pozostaje odpowiedzialny za wykonanie i ryzyko.

Wymagania wstępne

  • Python 3.9+ z pip install ccxt requests.
  • Klucze API Bybit skonfigurowane dla CCXT (tylko do odczytu wystarczy do testów).
  • Klucz API Smart Money API (darmowy poziom obejmuje BTC).

Uzyskaj swój klucz API

Każde żądanie uwierzytelnia się za pomocą X-API-Key nagłówka. Aby uzyskać klucz:

  1. 1Utwórz darmowe konto, a następnie otwórz swój panel sterowania.
  2. 2Skopiuj klucz API widoczny pod Dostęp API. Darmowy poziom obejmuje BTC z limitem 20 żądań/dzień — wystarczy, aby przetestować ten przewodnik od początku do końca.
  3. 3Potrzebujesz więcej symboli lub wyższych limitów? Porównaj poziomy na stronie cenowej.

Zachowaj klucz w tajemnicy — przechowuj go w zmiennej środowiskowej, nigdy nie umieszczaj go w kontroli źródła.

Konfiguracja

  1. 1Zainstaluj biblioteki: pip install ccxt requests.
  2. 2Eksportuj swój klucz: export SMA_API_KEY="sm_your_key_here".
  3. 3Otwórz swapy Bybit za pomocą CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), pozwól swojej strategii wybrać kandydata na kierunek, a następnie wywołaj /v1/confirm jako ostatnią bramę kontekstu.
  4. 4Wykonaj wejście na perpetuals za pomocą CCXT tylko wtedy, gdy akcja jest CONFIRM, skalowane przez size_mult.

Przykład działania

Ten skrypt odczytuje ticker swapów Bybit za pomocą CCXT, wyprowadza kandydata na kierunek, a następnie wywołuje GET /v1/confirm?symbol=BTC&direction=long przed podjęciem decyzji, czy wykonać wejście.

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

Oczekiwana odpowiedź

Udane wywołanie /v1/confirm zwraca JSON w następujący sposób:

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 zakres od -1.0 (silne przeciw) do +1.0 (silne potwierdzenie), confidence jest HIGH lub MEDIUM, a size_mult to sugerowany mnożnik wielkości 0.0–1.5. Zobacz pełne odniesienie do pola w dokumentacji API.

Jak działać na podstawie odpowiedzi

POTWIERDŹ

Kontekst wspiera Twój kierunek. Kontynuuj zgodnie z własnymi zasadami wejścia i ryzyka, opcjonalnie skalując wielkość przez size_mult.

ZMNIEJSZ

Sygnały są mieszane. Rozważ mniejszą pozycję, węższe stop-lossy lub czekanie na czystsze ustawienie.

POMIŃ

Kontekst rynkowy nie wspiera tej transakcji. Odstąp i sprawdź ponownie przy następnym kandydacie.

Gotowy do budowania?

Zdobądź darmowy klucz i wykonaj pierwsze potwierdzenie w mniej niż minutę.

To nie jest porada finansowa. Handel kryptowalutami wiąże się z ryzykiem.