Integrációs útmutató
Használja a Smart Money API-t a CCXT mellett
Olvassa élő piaci adatokat a CCXT-vel, kérdezze meg a Smart Money API-t, hogy a bálnák áramlása és a derivatív pozicionálás megerősíti-e az irányt, majd adja le a rendelést a választott tőzsdén.
Kinek szól
Python fejlesztők, akik tőzsdefüggetlen botokat építenek a CCXT segítségével, és független piaci kontextus-ellenőrzést szeretnének minden rendelés előtt. A Smart Money API döntéstámogatás – nem ad le rendeléseket Ön helyett; a CCXT irányítja a végrehajtást.
Előfeltételek
- Python 3.9+
pip install ccxt requests. - Tőzsde API kulcsok konfigurálva a CCXT-hez (csak olvasási mód is elég a teszteléshez).
- Egy Smart Money API kulcs (az ingyenes szint a BTC-t fedez).
Szerezze meg az API kulcsot
Minden kérés hitelesítést igényel a X-API-Key fejléc segítségével. Kulcs szerzéséhez:
- 1Hozzon létre egy ingyenes fiókot, majd nyissa meg a vezérlőpultot.
- 2Másolja az API kulcsot, amely a API hozzáférésalatt látható. Az ingyenes szint a BTC-t fedez 20 kérés/nap – elegendő ennek az útmutatónak a teljes teszteléséhez.
- 3Több szimbólumra vagy magasabb limitre van szüksége? Hasonlítsa össze a szinteket a díjszabás oldalon.
Tartsa titokban a kulcsot – tárolja környezeti változóban, soha ne tegye forráskódba.
Beállítás
- 1Telepítse a könyvtárakat:
pip install ccxt requests. - 2Exportálja a kulcsot:
export SMA_API_KEY="sm_your_key_here". - 3Hagyja, hogy a stratégiája döntsön egy jelölt irányról a CCXT piaci adatok alapján, majd hívja meg a
/v1/confirmvégső kontextus ellenőrzésként. - 4Csak akkor adja le a rendelést a CCXT-vel, ha a művelet
CONFIRM, méretezés asize_mult.
Működő példa
Ez a szkript egy tickert olvas a CCXT-vel, származtat egy jelölt irányt, majd meghívja a GET /v1/confirm?symbol=BTC&direction=long mielőtt döntene a rendelés leadásáról.
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")
Várt válasz
A sikeres hívás a /v1/confirm végpontra JSON-t ad vissza, mint például:
{
"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 -1.0 (erős ellentétes) és +1.0 (erős megerősítés) között mozog, confidence HIGH vagy MEDIUM, és size_mult egy 0.0–1.5 közötti javasolt méret-szorzó. Tekintse meg a teljes mezőreferenciát a API dokumentációban.
Hogyan reagáljon a válaszra
CONFIRM
A kontextus támogatja az irányt. Folytassa saját belépési és kockázati szabályaival, opcionálisan méretezve a méretet a size_mult.
REDUCE
A jelek vegyesek. Fontolja meg egy kisebb pozíciót, szűkebb stop-okat, vagy várjon egy tisztább beállításra.
SKIP
A piaci kontextus nem támogatja ezt a kereskedést. Várjon, és ellenőrizze újra a következő jelöltnél.
Készen áll az építésre?
Szerezzen egy ingyenes kulcsot, és tegye meg az első megerősítő hívást egy percen belül.
Nem pénzügyi tanács. A kriptovaluta kereskedés kockázatokat hordoz.