Ghid de integrare
Folosește Smart Money API alături de CCXT
Citește datele de piață în timp real cu CCXT, întreabă Smart Money API dacă fluxul balenelor și poziționarea derivatelor confirmă direcția ta, apoi plasează ordinul pe exchange-ul ales.
Pentru cine este destinat
Dezvoltatori Python care construiesc roboți agnostici la exchange pe CCXT care doresc o verificare independentă a contextului pieței înainte de fiecare ordin. Smart Money API este suport pentru decizii — nu plasează ordine pentru tine; CCXT rămâne responsabil de execuție.
Cerințe preliminare
- Python 3.9+ cu
pip install ccxt requests. - Chei API de exchange configurate pentru CCXT (doar citire este suficient pentru testare).
- O cheie Smart Money API (nivelul gratuit acoperă BTC).
Obține cheia ta API
Fiecare cerere se autentifică cu antetul X-API-Key . Pentru a obține o cheie:
- 1Creează un cont gratuit, apoi deschide panoul de control.
- 2Copiază cheia API afișată sub Acces API. Nivelul gratuit acoperă BTC cu 20 de cereri/zi — suficient pentru a testa acest ghid de la cap la coadă.
- 3Ai nevoie de mai multe simboluri sau limite mai mari? Compară nivelurile pe pagina de prețuri.
Păstrează cheia secretă — stochează-o într-o variabilă de mediu, nu o comite niciodată în sistemul de control al surselor.
Configurare
- 1Instalare biblioteci:
pip install ccxt requests. - 2Exportă cheia ta:
export SMA_API_KEY="sm_your_key_here". - 3Lasă strategia ta să decidă o direcție candidată din datele de piață CCXT, apoi apelează
/v1/confirmca o poartă finală de context. - 4Plasează ordinul cu CCXT doar când acțiunea este
CONFIRM, dimensionează dupăsize_mult.
Exemplu funcțional
Acest script citește un ticker cu CCXT, derivă o direcție candidată, apoi apelează GET /v1/confirm?symbol=BTC&direction=long înainte de a decide dacă să plaseze ordinul.
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ăspuns așteptat
Un apel reușit către /v1/confirm returnează JSON ca acesta:
{
"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 variază de la -1.0 (puternic contra) la +1.0 (puternic confirmare), confidence este HIGH sau MEDIUM, și size_mult este un multiplicator de dimensiune sugerat 0.0–1.5. Vezi referința completă a câmpurilor în documentația API.
Cum să acționezi în funcție de răspuns
CONFIRMĂ
Contextul susține direcția ta. Continuă cu propriile reguli de intrare și risc, opțional scalând dimensiunea după size_mult.
REDU
Semnalul este mixt. Ia în considerare o poziție mai mică, stopuri mai strânse sau așteptarea pentru o configurație mai clară.
OMITE
Contextul pieței nu susține această tranzacție. Stai deoparte și verifică din nou la următorul candidat.
Gata de construit?
Ia o cheie gratuită și fă prima ta apelare de confirmare în mai puțin de un minut.
Nu este sfat financiar. Tradingul cu criptomonede implică riscuri.