Průvodce integrací

Potvrďte vstupy na Bybit perpetuals pomocí Smart Money API

Čtěte živá data swapového trhu Bybit pomocí CCXT, zeptejte se Smart Money API, zda tok velryb a pozice v derivátech potvrzují váš směr, a poté vstupte na perpetuals — s velikostí podle navrhovaného multiplikátoru.

Pro koho je to určeno

Python vývojáři, kteří provozují bot na Bybit USDT-perpetuals na CCXT kteří chtějí nezávislou kontrolu tržního kontextu před každým vstupem. Smart Money API je podpora rozhodování — neumisťuje objednávky za vás; váš kód CCXT zůstává pod kontrolou provedení a rizika.

Předpoklady

  • Python 3.9+ s pip install ccxt requests.
  • Bybit API klíči nakonfigurovanými pro CCXT (pro testování stačí read-only).
  • Klíč Smart Money API (bezplatná úroveň pokrývá BTC).

Získejte svůj API klíč

Každý požadavek se ověřuje pomocí X-API-Key hlavičky. Pro získání klíče:

  1. 1Vytvořte si bezplatný účet a otevřete svůj dashboard.
  2. 2Zkopírujte API klíč zobrazený pod API Access. Bezplatná úroveň pokrývá BTC s 20 požadavky/den — dost na otestování tohoto průvodce od začátku do konce.
  3. 3Potřebujete více symbolů nebo vyšší limity? Porovnejte úrovně na stránce s cenami.

Uchovávejte klíč v tajnosti — uložte ho do proměnné prostředí, nikdy ho neukládejte do zdrojového kódu.

Nastavení

  1. 1Nainstalujte knihovny: pip install ccxt requests.
  2. 2Exportujte svůj klíč: export SMA_API_KEY="sm_your_key_here".
  3. 3Otevřete Bybit swaps pomocí CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), nechte vaši strategii vybrat kandidátní směr a poté zavolejte /v1/confirm jako finální kontrolu kontextu.
  4. 4Vstupte na perpetuals pomocí CCXT pouze tehdy, když je akce CONFIRM, s velikostí podle size_mult.

Pracovní příklad

Tento skript čte ticker Bybit swapu pomocí CCXT, odvozuje kandidátní směr a poté volá GET /v1/confirm?symbol=BTC&direction=long před rozhodnutím, zda vstoupit.

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

Očekávaná odpověď

Úspěšné volání /v1/confirm vrátí JSON jako tento:

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 se pohybuje od -1.0 (silný proti) do +1.0 (silné potvrzení), confidence je HIGH nebo MEDIUM, a size_mult je navrhovaný multiplikátor velikosti 0.0–1.5. Viz úplný referenční popis polí v API docs.

Jak reagovat na odpověď

CONFIRM

Kontext podporuje váš směr. Pokračujte podle svých vlastních pravidel vstupu a rizika, případně upravte velikost podle size_mult.

REDUCE

Signály jsou smíšené. Zvažte menší pozici, těsnější stop-lossy nebo čekání na čistší setup.

SKIP

Tržní kontext tuto obchodní příležitost nepodporuje. Vyčkejte a zkontrolujte další kandidáta.

Připraveni stavět?

Získejte bezplatný klíč a proveďte první potvrzovací volání za méně než minutu.

Nejedná se o finanční poradenství. Obchodování s kryptoměnami zahrnuje riziko.