Integrációs útmutató

Erősítse meg a Bybit perpetuum bejegyzéseit a Smart Money API-val

Olvassa élőben a Bybit swap piaci adatokat CCXT-vel, kérdezze meg a Smart Money API-t, hogy a bálnák áramlása és a derivatív pozicionálás megerősíti-e az irányt, majd helyezze el a perpetuum bejegyzést — a javasolt szorzóval méretezve.

Kinek szól

Python fejlesztők, akik Bybit USDT-perpetuum botot futtatnak CCXT akik független piaci kontextus ellenőrzést szeretnének minden bejegyzés előtt. A Smart Money API döntéstámogatás — nem helyez el rendeléseket; a CCXT kódod marad az végrehajtás és kockázat irányítása.

Előfeltételek

  • Python 3.9+ pip install ccxt requests.
  • Bybit API kulcsok konfigurálva CCXT-hez (csak olvasás is elég teszteléshez).
  • Egy Smart Money API kulcs (ingyenes szinten BTC-t fedez).

API kulcs lekérése

Minden kérés hitelesítést igényel a X-API-Key fejléc segítségével. Kulcs lekéréséhez:

  1. 1Hozzon létre egy ingyenes fiókot, majd nyissa meg a vezérlőpultot.
  2. 2Másolja ki az API kulcsot a API hozzáférésalatt. Az ingyenes szinten BTC-t fedez 20 kérés/nap — elég ahhoz, hogy végigtesztelje ezt az útmutatót.
  3. 3Több szimbólumra vagy magasabb limitre van szüksége? Hasonlítsa össze a szinteket a díjszabás oldalon.

Tartsa titokban a kulcsot — tárolja környezeti változóban, soha ne tegye forráskódba.

Beállítás

  1. 1Telepítse a könyvtárakat: pip install ccxt requests.
  2. 2Exportálja a kulcsot: export SMA_API_KEY="sm_your_key_here".
  3. 3Nyissa meg a Bybit swapokat CCXT-vel (ccxt.bybit({"options":{"defaultType":"swap"}})), hagyja, hogy a stratégiája kiválasszon egy irányt, majd hívja meg a /v1/confirm végső kontextus ellenőrzésként.
  4. 4Csak akkor helyezze el a perpetuum bejegyzést CCXT-vel, ha a művelet CONFIRM, méretezve a size_mult.

Működő példa

Ez a szkript elolvassa a Bybit swap tickert CCXT-vel, levezet egy irányt, majd meghívja a GET /v1/confirm?symbol=BTC&direction=long mielőtt döntene a bejegyzésről.

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

Várt válasz

A sikeres hívás a /v1/confirm visszaad egy JSON-t, mint ez:

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 (erős ellentétes) és +1.0 (erős megerősítés) között mozog, confidence HIGH vagy MEDIUM, és size_mult egy 0.0–1.5 közötti javasolt méret szorzó. Teljes mező leírás a API dokumentációban.

Hogyan reagálj a válaszra

CONFIRM

A kontextus támogatja az irányt. Folytassa saját bejegyzés és kockázati szabályaival, opcionálisan méretezve a size_mult.

REDUCE

A jelek vegyesek. Fontolja meg kisebb pozíciót, szűkebb stop-ot, vagy várjon tisztább beállításra.

SKIP

A piaci kontextus nem támogatja ezt a kereskedést. Várjon, és ellenőrizze újra a következő lehetőségnél.

Készen áll az építésre?

Szerezzen ingyenes kulcsot, és végezze el az első megerősítő hívást egy percen belül.

Nem pénzügyi tanács. A kriptókereskedelem kockázatot hordoz.