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é :

  1. 1Créez un compte gratuit, puis ouvrez votre tableau de bord.
  2. 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.
  3. 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

  1. 1Installez les bibliothèques : pip install ccxt requests.
  2. 2Exportez votre clé : export SMA_API_KEY="sm_your_key_here".
  3. 3Laissez votre stratégie décider d'une direction candidate à partir des données de marché CCXT, puis appelez /v1/confirm comme dernière vérification contextuelle.
  4. 4Passez l'ordre avec CCXT uniquement lorsque l'action est CONFIRM, en dimensionnant par size_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.

ccxt_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.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 :

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 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.