Integreringsguide

Bekräfta Bybit perpetuals-entries med Smart Money API

Läs live-data från Bybit swap-marknaden med CCXT, fråga Smart Money API om valflöde och derivatpositionering bekräftar din riktning, och placera sedan perpetuals-entryn — storleksbestämd av den föreslagna multiplikatorn.

Vem detta är för

Python-utvecklare som kör en Bybit USDT-perpetuals bot på CCXT som vill ha en oberoende marknadskontextkontroll före varje entry. Smart Money API är beslutsstöd — den placerar inte order åt dig; din CCXT-kod behåller kontrollen över exekvering och risk.

Förutsättningar

  • Python 3.9+ med pip install ccxt requests.
  • Bybit API-nycklar konfigurerade för CCXT (skrivskyddad räcker för tester).
  • En Smart Money API-nyckel (gratis-nivån täcker BTC).

Hämta din API-nyckel

Varje förfrågan autentiseras med X-API-Key header. För att få en nyckel:

  1. 1Skapa ett gratis konto, öppna sedan din instrumentpanel.
  2. 2Kopiera API-nyckeln som visas under API-åtkomst. Den gratis nivån täcker BTC med 20 förfrågningar/dag — tillräckligt för att testa denna guide från början till slut.
  3. 3Behöver du fler symboler eller högre gränser? Jämför nivåer på prissättningssidan.

Håll nyckeln hemlig — spara den i en miljövariabel, lägg aldrig in den i versionskontroll.

Installation

  1. 1Installera biblioteken: pip install ccxt requests.
  2. 2Exportera din nyckel: export SMA_API_KEY="sm_your_key_here".
  3. 3Öppna Bybit swaps med CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), låt din strategi välja en kandidatrikting, och anropa sedan /v1/confirm som en sista kontextgrind.
  4. 4Placera perpetuals-entryn med CCXT endast när åtgärden är CONFIRM, storleksbestämd av size_mult.

Arbetsexempel

Detta skript läser en Bybit swap-ticker med CCXT, härleder en kandidatrikting, och anropar sedan GET /v1/confirm?symbol=BTC&direction=long innan det bestämmer sig för att placera entryn.

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

Förväntat svar

Ett lyckat anrop till /v1/confirm returnerar JSON så hä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 sträcker sig från -1.0 (stark motriktning) till +1.0 (stark bekräftelse), confidence är HIGH eller MEDIUM, och size_mult är en 0.0–1.5 föreslagen storleksmultiplikator. Se hela fältreferensen i API-dokumentationen.

Hur man agerar på svaret

CONFIRM

Kontexten stödjer din riktning. Fortsätt med dina egna entry- och riskregler, eventuellt skala storleken med size_mult.

REDUCE

Signalerna är blandade. Överväg en mindre position, snävare stopp, eller vänta på en renare setup.

SKIP

Marknadskontexten stödjer inte denna handel. Vänta och kontrollera nästa kandidat.

Redo att bygga?

Hämta en gratis nyckel och gör ditt första bekräftelseanrop på under en minut.

Intek finansiell rådgivning. Kryptohandel innebär risk.