Integratiehandleiding
Gebruik Smart Money API naast CCXT
Lees live marktgegevens met CCXT, vraag Smart Money API of walvisstroom en derivatenpositionering jouw richting bevestigen, plaats vervolgens de order op de exchange van jouw keuze.
Voor wie dit bedoeld is
Python-ontwikkelaars die exchange-onafhankelijke bots bouwen op CCXT die een onafhankelijke marktcontextcontrole willen voor elke order. Smart Money API is beslissingsondersteuning — het plaatst geen orders voor jou; CCXT blijft verantwoordelijk voor de uitvoering.
Vereisten
- Python 3.9+ met
pip install ccxt requests. - Exchange API-sleutels geconfigureerd voor CCXT (alleen-lezen is voldoende om te testen).
- Een Smart Money API-sleutel (gratis tier dekt BTC).
Verkrijg je API-sleutel
Elk verzoek authenticeert met de X-API-Key header. Om een sleutel te krijgen:
- 1Maak een gratis account aan, open vervolgens je dashboard.
- 2Kopieer de API-sleutel onder API-toegang. De gratis tier dekt BTC met 20 verzoeken/dag — genoeg om deze handleiding van begin tot eind te testen.
- 3Meer symbolen of hogere limieten nodig? Vergelijk tiers op de prijspagina.
Houd de sleutel geheim — bewaar hem in een omgevingsvariabele, sla hem nooit op in broncodebeheer.
Setup
- 1Installeer de bibliotheken:
pip install ccxt requests. - 2Exporteer je sleutel:
export SMA_API_KEY="sm_your_key_here". - 3Laat je strategie een kandidaatrichting bepalen op basis van CCXT-marktgegevens, roep vervolgens
/v1/confirmaan als een laatste contextcontrole. - 4Plaats de order met CCXT alleen wanneer de actie is
CONFIRM, grootte bepalen doorsize_mult.
Werkend voorbeeld
Dit script leest een ticker met CCXT, leidt een kandidaatrichting af, roept vervolgens GET /v1/confirm?symbol=BTC&direction=long aan voordat besloten wordt of de order geplaatst moet worden.
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")
Verwachte reactie
Een succesvolle aanroep van /v1/confirm geeft JSON zoals dit terug:
{
"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 varieert van -1.0 (sterk tegen) tot +1.0 (sterke bevestiging), confidence is HOOG of MIDDEL, en size_mult is een 0.0–1.5 voorgestelde groottevermenigvuldiger. Zie het volledige veldreferentie in de API-documentatie.
Hoe te handelen naar de reactie
BEVESTIGEN
Context ondersteunt jouw richting. Ga verder met je eigen instap- en risicoregels, optioneel de grootte schalen door size_mult.
VERMINDEREN
Signalen zijn gemengd. Overweeg een kleinere positie, strakkere stops, of wacht op een schonere setup.
OVERSLAAN
Marktcontext ondersteunt deze trade niet. Wacht af en controleer opnieuw bij de volgende kandidaat.
Klaar om te bouwen?
Pak een gratis sleutel en maak je eerste bevestigingsaanroep in minder dan een minuut.
Geen financieel advies. Cryptohandel brengt risico's met zich mee.