Guide d'intégration
Confirmez les entrées en perpétuels Bybit avec Smart Money API
Lisez les données de marché en direct des swaps Bybit avec CCXT, demandez à Smart Money API si les flux des baleines et le positionnement des dérivés confirment votre direction, puis passez l'ordre en perpétuels — dimensionné par le multiplicateur suggéré.
À qui cela s'adresse
Développeurs Python exécutant un bot sur les perpétuels USDT de Bybit via CCXT qui souhaitent une vérification indépendante du contexte de marché avant chaque entrée. Smart Money API est une aide à la décision — il ne passe pas d'ordres pour vous ; votre code CCXT garde le contrôle de l'exécution et du risque.
Prérequis
- Python 3.9+ avec
pip install ccxt requests. - des clés API Bybit configurées pour CCXT (lecture seule suffit pour les tests).
- Une clé API Smart Money API (le niveau gratuit couvre BTC).
Obtenez votre clé API
Chaque requête s'authentifie avec l'en-tête X-API-Key . Pour obtenir une clé :
- 1Créez un compte gratuit, puis ouvrez votre tableau de bord.
- 2Copiez la clé API affichée sous Accès API. Le niveau gratuit couvre BTC à 20 requêtes/jour — suffisant pour tester ce guide de bout en bout.
- 3Besoin de plus de symboles ou de limites plus élevées ? Comparez les niveaux sur la page des tarifs.
Gardez la clé secrète — stockez-la dans une variable d'environnement, ne la commettez jamais dans le contrôle de source.
Configuration
- 1Installez les bibliothèques :
pip install ccxt requests. - 2Exportez votre clé :
export SMA_API_KEY="sm_your_key_here". - 3Ouvrez les swaps Bybit avec CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), laissez votre stratégie choisir une direction candidate, puis appelez/v1/confirmcomme porte de contexte finale. - 4Passez l'ordre en perpétuels avec CCXT uniquement lorsque l'action est
CONFIRM, en dimensionnant parsize_mult.
Exemple fonctionnel
Ce script lit un ticker de swap Bybit avec CCXT, déduit une direction candidate, puis appelle GET /v1/confirm?symbol=BTC&direction=long avant de décider de passer ou non l'ordre.
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")
Réponse attendue
Un appel réussi à /v1/confirm renvoie un JSON comme ceci :
{
"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 varie de -1.0 (forte opposition) à +1.0 (forte confirmation), confidence est HIGH ou MEDIUM, et size_mult est un multiplicateur de taille suggéré entre 0.0 et 1.5. Voir la référence complète des champs dans la documentation API.
Comment agir sur la réponse
CONFIRM
Le contexte soutient votre direction. Poursuivez avec vos propres règles d'entrée et de risque, en ajustant éventuellement la taille par size_mult.
REDUCE
Les signaux sont mitigés. Envisagez une position plus petite, des stops plus serrés ou attendez un setup plus clair.
SKIP
Le contexte de marché ne soutient pas ce trade. Abstenez-vous et revérifiez lors du prochain candidat.
Prêt à construire ?
Obtenez une clé gratuite et effectuez votre premier appel de confirmation en moins d'une minute.
Ce n'est pas un conseil financier. Le trading de crypto comporte des risques.