Przewodnik integracji

Używaj Smart Money API razem z CCXT

Odczytuj dane rynkowe na żywo za pomocą CCXT, zapytaj Smart Money API, czy przepływ wielorybów i pozycje instrumentów pochodnych potwierdzają Twój kierunek, a następnie złóż zlecenie na wybranej giełdzie.

Dla kogo jest to przeznaczone

Deweloperzy Pythona budujący boty niezależne od giełdy na CCXT którzy chcą niezależnego sprawdzenia kontekstu rynkowego przed każdym zleceniem. Smart Money API to wsparcie decyzyjne — nie składa zleceń za Ciebie; CCXT pozostaje odpowiedzialne za wykonanie.

Wymagania wstępne

  • Python 3.9+ z pip install ccxt requests.
  • Klucze API giełdy skonfigurowane dla CCXT (tylko do odczytu wystarczy do testowania).
  • Klucz API Smart Money API (darmowy poziom obejmuje BTC).

Uzyskaj swój klucz API

Każde żądanie jest uwierzytelniane za pomocą X-API-Key nagłówka. Aby uzyskać klucz:

  1. 1Utwórz darmowe konto, a następnie otwórz swój panel sterowania.
  2. 2Skopiuj klucz API widoczny pod Dostęp do API. Darmowy poziom obejmuje BTC z limitem 20 żądań/dzień — wystarczy, aby przetestować ten przewodnik od początku do końca.
  3. 3Potrzebujesz więcej symboli lub wyższych limitów? Porównaj poziomy na stronie cenowej.

Zachowaj klucz w tajemnicy — przechowuj go w zmiennej środowiskowej, nigdy nie dodawaj go do kontroli źródła.

Konfiguracja

  1. 1Zainstaluj biblioteki: pip install ccxt requests.
  2. 2Eksportuj swój klucz: export SMA_API_KEY="sm_your_key_here".
  3. 3Pozwól swojej strategii zdecydować o kandydacie na kierunek na podstawie danych rynkowych CCXT, a następnie wywołaj /v1/confirm jako końcową bramę kontekstu.
  4. 4Złóż zlecenie za pomocą CCXT tylko wtedy, gdy działanie jest CONFIRM, określając wielkość przez size_mult.

Przykład działania

Ten skrypt odczytuje ticker za pomocą CCXT, określa kandydata na kierunek, a następnie wywołuje GET /v1/confirm?symbol=BTC&direction=long przed podjęciem decyzji o złożeniu zlecenia.

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

Oczekiwana odpowiedź

Udane wywołanie /v1/confirm zwraca JSON w następujący sposób:

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 zakres od -1.0 (silne przeciw) do +1.0 (silne potwierdzenie), confidence jest WYSOKIE lub ŚREDNIE, a size_mult to sugerowany mnożnik wielkości 0.0–1.5. Zobacz pełne odniesienie do pól w dokumentacji API.

Jak działać na podstawie odpowiedzi

POTWIERDŹ

Kontekst wspiera Twój kierunek. Kontynuuj zgodnie z własnymi zasadami wejścia i ryzyka, opcjonalnie skalując wielkość przez size_mult.

ZMNIEJSZ

Sygnały są mieszane. Rozważ mniejszą pozycję, węższe stop-lossy lub czekanie na czystsze ustawienie.

POMIŃ

Kontekst rynkowy nie wspiera tej transakcji. Odłóż na bok i sprawdź ponownie przy następnym kandydacie.

Gotowy do budowania?

Uzyskaj darmowy klucz i wykonaj swoje pierwsze potwierdzenie w mniej niż minutę.

To nie jest porada finansowa. Handel kryptowalutami wiąże się z ryzykiem.