Průvodce integrací

Používejte Smart Money API spolu s CCXT

Čtěte živá tržní data pomocí CCXT, zeptejte se Smart Money API, zli tok velryb a pozice derivátů potvrzují váš směr, a poté zadejte objednávku na burze dle vašeho výběru.

Pro koho je to určeno

Python vývojáři vytvářející burzově agnostické boty na CCXT kteří chtějí nezávislou kontrolu tržního kontextu před každou objednávkou. Smart Money API je podpora rozhodování — neprovádí objednávky za vás; CCXT zůstává pod kontrolou provádění.

Předpoklady

  • Python 3.9+ s pip install ccxt requests.
  • Nastavené API klíče pro CCXT (pro testování stačí pouze pro čtení).
  • Klíč Smart Money API (bezplatná úroveň pokrývá BTC).

Získejte svůj API klíč

Každý požadavek se ověřuje pomocí X-API-Key hlavičky. Pro získání klíče:

  1. 1Vytvořte si bezplatný účet, poté otevřete svůj dashboard.
  2. 2Zkopírujte API klíč zobrazený pod API Access. Bezplatná úroveň pokrývá BTC s 20 požadavky/den — dost na otestování tohoto průvodce od začátku do konce.
  3. 3Potřebujete více symbolů nebo vyšší limity? Porovnejte úrovně na stránce s cenami.

Uchovávejte klíč v tajnosti — uložte jej do proměnné prostředí, nikdy jej nezapisujte do zdrojového kódu.

Nastavení

  1. 1Nainstalujte knihovny: pip install ccxt requests.
  2. 2Exportujte svůj klíč: export SMA_API_KEY="sm_your_key_here".
  3. 3Nechte svou strategii rozhodnout o kandidátním směru z tržních dat CCXT, poté zavolejte /v1/confirm jako finální kontrolu kontextu.
  4. 4Zadejte objednávku pomocí CCXT pouze v případě, že akce je CONFIRM, velikost podle size_mult.

Pracovní příklad

Tento skript čte ticker pomocí CCXT, odvodí kandidátní směr, poté zavolá GET /v1/confirm?symbol=BTC&direction=long před rozhodnutím, zda objednávku zadat.

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

Očekávaná odpověď

Úspěšné volání /v1/confirm vrátí JSON podobný tomuto:

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 se pohybuje od -1.0 (silný proti) do +1.0 (silné potvrzení), confidence je HIGH nebo MEDIUM, a size_mult je navrhovaný multiplikátor velikosti 0.0–1.5. Viz úplný odkaz na pole v dokumentaci API.

Jak jednat na základě odpovědi

CONFIRM

Kontext podporuje váš směr. Pokračujte podle svých vlastních pravidel vstupu a rizika, případně upravte velikost podle size_mult.

REDUCE

Signály jsou smíšené. Zvažte menší pozici, těsnější stop-lossy nebo počkejte na čistší setup.

SKIP

Tržní kontext tuto obchod nepodporuje. Vyčkejte a zkontrolujte dalšího kandidáta.

Jste připraveni stavět?

Získejte bezplatný klíč a proveďte své první potvrzovací volání za méně než minutu.

Nejedná se o finanční poradenství. Obchodování s kryptoměnami zahrnuje riziko.