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:

  1. 1Creează un cont gratuit, apoi deschide panoul de control.
  2. 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ă.
  3. 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

  1. 1Instalare biblioteci: pip install ccxt requests.
  2. 2Exportă cheia ta: export SMA_API_KEY="sm_your_key_here".
  3. 3Lasă strategia ta să decidă o direcție candidată din datele de piață CCXT, apoi apelează /v1/confirm ca o poartă finală de context.
  4. 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.

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ăspuns așteptat

Un apel reușit către /v1/confirm returnează JSON ca acesta:

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