Guida all'integrazione
Conferma le entrate perpetuals di Bybit con Smart Money API
Leggi i dati di mercato live degli swap di Bybit con CCXT, chiedi a Smart Money API se il flusso delle balene e il posizionamento dei derivati confermano la tua direzione, quindi piazza l'ingresso perpetuals — dimensionato dal moltiplicatore suggerito.
A chi è rivolto
Sviluppatori Python che gestiscono un bot USDT-perpetuals su Bybit CCXT che desiderano un controllo indipendente del contesto di mercato prima di ogni ingresso. Smart Money API è un supporto decisionale — non piazza ordini per te; il tuo codice CCXT rimane in controllo dell'esecuzione e del rischio.
Prerequisiti
- Python 3.9+ con
pip install ccxt requests. - Chiavi API Bybit configurate per CCXT (sola lettura va bene per testare).
- Una chiave API Smart Money API (il livello gratuito copre BTC).
Ottieni la tua chiave API
Ogni richiesta si autentica con l' X-API-Key intestazione. Per ottenere una chiave:
- 1Crea un account gratuito, quindi apri il tuo dashboard.
- 2Copia la chiave API mostrata sotto Accesso API. Il livello gratuito copre BTC con 20 richieste/giorno — sufficienti per testare questa guida dall'inizio alla fine.
- 3Hai bisogno di più simboli o limiti più alti? Confronta i livelli nella pagina dei prezzi.
Mantieni la chiave segreta — conservala in una variabile d'ambiente, non inserirla mai nel controllo del codice sorgente.
Configurazione
- 1Installa le librerie:
pip install ccxt requests. - 2Esporta la tua chiave:
export SMA_API_KEY="sm_your_key_here". - 3Apri gli swap di Bybit con CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), lascia che la tua strategia scelga una direzione candidata, quindi chiama/v1/confirmcome ultimo controllo di contesto. - 4Piazza l'ingresso perpetuals con CCXT solo quando l'azione è
CONFIRM, dimensionando persize_mult.
Esempio pratico
Questo script legge un ticker swap di Bybit con CCXT, deriva una direzione candidata, quindi chiama GET /v1/confirm?symbol=BTC&direction=long prima di decidere se piazzare l'ingresso.
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")
Risposta attesa
Una chiamata riuscita a /v1/confirm restituisce un JSON come questo:
{
"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 varia da -1.0 (forte contro) a +1.0 (forte conferma), confidence è HIGH o MEDIUM, e size_mult è un moltiplicatore di dimensione suggerito 0.0–1.5. Vedi il riferimento completo dei campi nella documentazione API.
Come agire sulla risposta
CONFERMA
Il contesto supporta la tua direzione. Procedi con le tue regole di ingresso e rischio, eventualmente scalando la dimensione per size_mult.
RIDUCI
I segnali sono misti. Considera una posizione più piccola, stop più stretti o aspetta un setup più pulito.
SALTA
Il contesto di mercato non supporta questo trade. Rimani fuori e ricontrolla sul prossimo candidato.
Pronto a costruire?
Ottieni una chiave gratuita e fai la tua prima chiamata di conferma in meno di un minuto.
Non è un consiglio finanziario. Il trading di criptovalute comporta rischi.