Per i trader crypto che cercano un vantaggio, monitorare i portafogli dei grandi detentori — comunemente chiamati whale — può rivelare posizionamenti anticipati prima di grandi movimenti di prezzo. Costruire un bot di trading crypto con segnali di whale on-chain in Python ti permette di automatizzare la cattura e la reazione a questi dati ad alto valore. Questo tutorial illustra un'implementazione pratica utilizzando Smart Money API, una fonte specializzata di attività di whale aggregate dalla leaderboard di Hyperliquid combinata con dati derivati cross-exchange.
Comprendere i Segnali di Whale On-Chain
I portafogli whale sono indirizzi che detengono o scambiano quantità significative di criptovaluta. Quando una whale deposita asset su un exchange, apre una grande posizione o preleva da un exchange decentralizzato, spesso segnala un'intenzione — e il mercato spesso segue. Smart Money API scopre automaticamente circa 2.000 portafogli whale dalla leaderboard multi-timeframe di Hyperliquid e traccia i loro eventi sugli exchange supportati (solo Bybit, Binance e Hyperliquid). Questi eventi includono grandi afflussi, deflussi e cambiamenti di posizione.
Collegando questi segnali a un bot di trading, puoi programmare risposte come piazzare ordini limite, modificare stop-loss o inviare avvisi — tutto senza ritardi emotivi.
Iniziare con Smart Money API
Prima, registrati su smartmoneyapi.com per ottenere una chiave API. Il piano gratuito offre 200 chiamate al giorno, limitate ai dati di Bitcoin — sufficienti per i test. Per la funzionalità completa (tutti i simboli, eventi whale, derivati e metriche on-chain), è consigliato il piano Trader (1,000 chiamate/giorno) o Pro (5.000 chiamate/giorno).
Tutte le richieste sono autenticate tramite l'header X-API-Key header. L'endpoint base è https://api.smartmoneyapi.com. Ecco uno script Python minimale per testare la connessione:
import requests
API_KEY = "your_api_key_here"
BASE_URL = "https://api.smartmoneyapi.com"
headers = {"X-API-Key": API_KEY}
# Check health
resp = requests.get(f"{BASE_URL}/v1/health", headers=headers)
print(resp.json())Recuperare i Dati dei Portafogli Whale
Il segnale whale più diretto è disponibile tramite /v1/whales/summary, che restituisce metriche aggregate per tutti i portafogli tracciati, come il flusso netto totale e il numero di portafogli attivi. Per eventi individuali (depositi, prelievi, aperture di posizione), usa /v1/whales/events.
Esempio: Recupera gli ultimi 5 eventi whale:
endpoint = f"{BASE_URL}/v1/whales/events"
params = {"limit": 5}
resp = requests.get(endpoint, headers=headers, params=params)
events = resp.json()
for event in events:
print(f"Symbol: {event['symbol']}, Type: {event['event_type']}, "
f"Amount: {event['amount_usd']}, Wallet: {event['wallet_address'][:8]}...")Gli eventi includono campi come event_type (ad esempio, "deposit", "withdrawal", "open_long"), symbol, amount_usde un timestamp. Il tuo bot può filtrare per simboli specifici o soglie — ad esempio, agire solo quando una whale deposita oltre $500.000 USD su un exchange.
Integrare i Dati Whale in una Strategia di Trading
Una strategia semplice potrebbe utilizzare un segnale di "momento whale": se più whale depositano su un exchange per lo stesso simbolo in una finestra temporale breve, potrebbe indicare una pressione di vendita imminente. Al contrario, grandi prelievi verso self-custody spesso segnalano accumulo.
Puoi costruire un meccanismo di punteggio:
- Traccia il flusso netto in USD per simbolo nell'ultima ora.
- Se il flusso netto supera una soglia (in valore assoluto), genera un segnale.
- Combina con i dati derivati (sezione successiva) per conferma.
Importante: Questa è una metodologia basata sui dati che non offre garanzie. Esegui backtest accurati e non fare affidamento solo su un segnale.
Aggiungere Dati Derivati per Conferma
Smart Money API offre dati derivati cross-exchange da Bybit, Binance e solo Hyperliquid (no OKX). Usa l'endpoint /v1/derivatives/screener per recuperare metriche come open interest, tassi di funding e rapporti long/short per qualsiasi dei ~229 simboli auto-scoperti.
Esempio: Recupera il tasso di funding corrente e l'open interest per BTC-USDT perpetual:
screener = f"{BASE_URL}/v1/derivatives/screener"
params = {"symbol": "BTC/USDT:USDT", "exchange": "binance"}
resp = requests.get(screener, headers=headers, params=params)
data = resp.json()
print(f"OI: {data['open_interest']}, Funding Rate: {data['funding_rate']}")Abbinando eventi di deposito whale con open interest in aumento e un tasso di funding negativo (che indica dominanza short), puoi generare idee di trading più robuste.
Node Intelligence per Valutazione del Rischio dei Token (BSC & Avalanche)
Se il tuo bot opera su Binance Smart Chain (PancakeSwap) o Avalanche C-chain (Trader Joe), puoi sfruttare il prodotto Node Intelligence di Smart Money API. Questo funziona sul tuo full node (o un RPC rivendibile) e fornisce:
- Rilevamento di nuove coppie
- Monitoraggio di grandi swap
- Rilevamento honeypot (
/v1/node/{bsc|avax}/honeypot/{token}) - Valutazione del rischio dei token (
/v1/node/{bsc|avax}/token-risk/{token}) - Tracciamento dei portafogli
Ad esempio, prima di acquistare un token appena scoperto, chiama l'endpoint honeypot per verificare se il contratto ha restrizioni di vendita. La risposta include flag come is_honeypot e risk_score (0‑100).
token = "0x123...abc"
resp = requests.get(f"{BASE_URL}/v1/node/bsc/honeypot/{token}", headers=headers)
honeypot_check = resp.json()
if honeypot_check.get("is_honeypot"):
print("Token is a honeypot — skipping.")Smart Money API offre piani Node (Starter, Pro, API per chain) per questo servizio.
Costruire il Loop del Bot
Assembla i componenti in un loop continuo. Usa time.sleep() o uno scheduler (ad esempio, la libreria schedule ) per rispettare i limiti di chiamata API. Un intervallo tipico è 5-15 minuti per gli eventi whale e 1 minuto per i dati derivati, se il tuo piano lo consente.
Struttura pseudo-codice:
while True:
whales = get_whale_events(min_amount_usd=500_000)
for event in whales:
if is_bullish_signal(event):
oi, funding = get_derivatives(event['symbol'])
if oi > threshold and funding < -0.01:
execute_trade(event['symbol'], side="short")
time.sleep(300) # 5 minutesRicorda di implementare gestione degli errori, logging e modalità dry-run prima del trading live.
Domande Frequenti
Qual è la migliore libreria Python per costruire un bot di trading crypto?
Per API premium come Smart Money API, requests è sufficiente. Per la connettività agli exchange, ccxt è la libreria standard che supporta molti exchange. Per il backtesting, backtrader o vectorbt sono popolari.
Quanti portafogli whale traccia Smart Money API?
Circa 2.000 portafogli auto-scoperti dalla leaderboard multi-timeframe di Hyperliquid, solo sugli exchange Bybit, Binance e Hyperliquid.
Posso usare questo bot per token su BSC o Avalanche?
Sì, tramite il prodotto Node Intelligence. Hai bisogno di un full node (o RPC rivendibile) per la rispettiva chain. L'API fornisce rilevamento di nuove coppie, grandi swap, controlli honeypot e tracciamento dei portafogli per BSC e Avalanche.
Ho bisogno di dati reali su Bitcoin per iniziare?
No. Il piano gratuito offre 100 chiamate giornaliere solo per Bitcoin, ma puoi comunque testare gli endpoint per i simboli whitelistati. Per altri simboli, passa a Trader o Pro.
Conclusione Prospettica
Costruire un bot di trading crypto con segnali di whale on-chain in Python è sempre più accessibile grazie ad aggregatori specializzati come Smart Money API. Combinando eventi sui portafogli, sentiment derivati e controlli del rischio on-chain, crei un motore decisionale multi-faccettato — che riduce la dipendenza dall'azione di prezzo ritardata. Con l'espansione dell'ecosistema DeFi, la capacità di reagire programmaticamente al comportamento dei grandi detentori rimarrà uno strumento prezioso per i trader sistematici. Inizia sempre con paper trading e backtest iterativi prima di impegnare capitale.