Guide d'intégration
Utilisez Smart Money API avec CCXT
Lisez les données de marché en temps réel avec CCXT, demandez à Smart Money API si les flux de baleines et le positionnement des dérivés confirment votre direction, puis passez l'ordre sur l'échange de votre choix.
Pour qui est-ce ?
Développeurs Python créant des bots indépendants des échanges sur CCXT qui souhaitent une vérification indépendante du contexte de marché avant chaque ordre. Smart Money API est un support décisionnel — il ne passe pas d'ordres pour vous ; CCXT reste en contrôle de l'exécution.
Prérequis
- Python 3.9+ avec
pip install ccxt requests. - Clés API d'échange configurées pour CCXT (lecture seule suffit pour tester).
- Une clé API Smart Money API (le niveau gratuit couvre le BTC).
Obtenez votre clé API
Chaque demande 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 le BTC avec 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". - 3Laissez votre stratégie décider d'une direction candidate à partir des données de marché CCXT, puis appelez
/v1/confirmcomme dernière vérification contextuelle. - 4Passez l'ordre avec CCXT uniquement lorsque l'action est
CONFIRM, en dimensionnant parsize_mult.
Exemple pratique
Ce script lit un ticker avec CCXT, dérive une direction candidate, puis appelle GET /v1/confirm?symbol=BTC&direction=long avant de décider de passer 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.binance() # any CCXT exchange
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": "ccxt-bot"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/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", "market", direction, qty)
print(f"Would place {direction} {qty} BTC/USDT")
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é de 0.0 à 1.5. Consultez la référence complète des champs dans la documentation API.
Comment agir sur la réponse
CONFIRMER
Le contexte soutient votre direction. Procédez avec vos propres règles d'entrée et de risque, en ajustant éventuellement la taille par size_mult.
RÉDUIRE
Les signaux sont mitigés. Envisagez une position plus petite, des stops plus serrés ou attendez une configuration plus claire.
IGNORER
Le contexte de marché ne soutient pas ce trade. Abstenez-vous et vérifiez à nouveau sur le 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.