Guida all'integrazione

Utilizza Smart Money API insieme a CCXT

Leggi i dati di mercato in tempo reale con CCXT, chiedi a Smart Money API se il flusso delle balene e il posizionamento dei derivati confermano la tua direzione, quindi piazza l'ordine sull'exchange di tua scelta.

A chi è rivolto

Sviluppatori Python che creano bot indipendenti dall'exchange su CCXT che desiderano un controllo indipendente del contesto di mercato prima di ogni ordine. Smart Money API è un supporto decisionale — non piazza ordini per te; CCXT mantiene il controllo dell'esecuzione.

Prerequisiti

  • Python 3.9+ con pip install ccxt requests.
  • Chiavi API dell'exchange configurate per CCXT (sola lettura va bene per testare).
  • Una chiave API di Smart Money API (il piano gratuito copre BTC).

Ottieni la tua chiave API

Ogni richiesta si autentica con l' X-API-Key intestazione. Per ottenere una chiave:

  1. 1Crea un account gratuito, quindi apri il tuo dashboard.
  2. 2Copia la chiave API mostrata sotto Accesso API. Il piano gratuito copre BTC con 20 richieste/giorno — sufficienti per testare questa guida dall'inizio alla fine.
  3. 3Hai bisogno di più simboli o limiti più alti? Confronta i piani nella pagina dei prezzi.

Mantieni la chiave segreta — conservala in una variabile d'ambiente, non inserirla mai nel controllo del codice sorgente.

Configurazione

  1. 1Installa le librerie: pip install ccxt requests.
  2. 2Esporta la tua chiave: export SMA_API_KEY="sm_your_key_here".
  3. 3Lascia che la tua strategia decida una direzione candidata dai dati di mercato di CCXT, quindi chiama /v1/confirm come gate di contesto finale.
  4. 4Piazza l'ordine con CCXT solo quando l'azione è CONFIRM, dimensionando con size_mult.

Esempio funzionante

Questo script legge un ticker con CCXT, deriva una direzione candidata, quindi chiama GET /v1/confirm?symbol=BTC&direction=long prima di decidere se piazzare l'ordine.

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

Risposta attesa

Una chiamata riuscita a /v1/confirm restituisce un JSON come questo:

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 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 in base alla risposta

CONFERMA

Il contesto supporta la tua direzione. Procedi con le tue regole di ingresso e rischio, opzionalmente scalando la dimensione con size_mult.

RIDUCI

I segnali sono contrastanti. Considera una posizione più piccola, stop più stretti o aspetta un setup più chiaro.

SALTA

Il contesto di mercato non supporta questo trade. Rimani fuori e ricontrolla al 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.