Integratiehandleiding

Bevestig Bybit perpetuals entries met Smart Money API

Lees live Bybit swap-marktgegevens met CCXT, vraag Smart Money API of walvisstroom en derivatenpositionering jouw richting bevestigen, plaats vervolgens de perpetuals entry — geschaald door de voorgestelde multiplier.

Voor wie dit bedoeld is

Python-ontwikkelaars die een Bybit USDT-perpetuals bot draaien op CCXT die een onafhankelijke marktcontextcontrole willen voor elke entry. Smart Money API is beslissingsondersteuning — het plaatst geen orders voor jou; jouw CCXT-code blijft de controle houden over uitvoering en risico.

Vereisten

  • Python 3.9+ met pip install ccxt requests.
  • Bybit API-sleutels geconfigureerd voor CCXT (alleen-lezen is voldoende om te testen).
  • Een Smart Money API-sleutel (gratis tier dekt BTC).

Verkrijg je API-sleutel

Elk verzoek wordt geverifieerd met de X-API-Key header. Om een sleutel te krijgen:

  1. 1Maak een gratis account aan, open vervolgens je dashboard.
  2. 2Kopieer de API-sleutel die wordt weergegeven onder API-toegang. De gratis tier dekt BTC met 20 verzoeken/dag — genoeg om deze handleiding van begin tot eind te testen.
  3. 3Meer symbolen of hogere limieten nodig? Vergelijk tiers op de prijspagina.

Houd de sleutel geheim — bewaar hem in een omgevingsvariabele, commit hem nooit naar broncodebeheer.

Setup

  1. 1Installeer de bibliotheken: pip install ccxt requests.
  2. 2Exporteer je sleutel: export SMA_API_KEY="sm_your_key_here".
  3. 3Open Bybit swaps met CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), laat je strategie een kandidaatrichting kiezen, roep vervolgens /v1/confirm aan als een laatste contextpoort.
  4. 4Plaats de perpetuals entry met CCXT alleen wanneer de actie is CONFIRM, geschaald door size_mult.

Werkend voorbeeld

Dit script leest een Bybit swap-ticker met CCXT, leidt een kandidaatrichting af, roept vervolgens GET /v1/confirm?symbol=BTC&direction=long aan voordat wordt besloten of de entry moet worden geplaatst.

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

Verwachte reactie

Een succesvolle aanroep naar /v1/confirm geeft JSON zoals dit terug:

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 varieert van -1.0 (sterk tegen) tot +1.0 (sterke bevestiging), confidence is HOOG of MEDIUM, en size_mult is een 0.0–1.5 voorgestelde grootte multiplier. Zie het volledige veldreferentie in de API-documentatie.

Hoe te handelen op de reactie

BEVESTIG

Context ondersteunt jouw richting. Ga verder met je eigen entry en risicoregels, optioneel schaal de grootte door size_mult.

VERMINDER

Signalen zijn gemengd. Overweeg een kleinere positie, strakkere stops of wacht op een schonere setup.

SLA OVER

Marktcontext ondersteunt deze trade niet. Blijf aan de kant en controleer opnieuw bij de volgende kandidaat.

Klaar om te bouwen?

Pak een gratis sleutel en maak je eerste bevestigingsaanroep in minder dan een minuut.

Geen financieel advies. Cryptohandel brengt risico's met zich mee.