Integreringsguide

Använd Smart Money API tillsammans med CCXT

Läs live-marknadsdata med CCXT, fråga Smart Money API om valflöde och derivatpositionering bekräftar din riktning, och placera sedan ordern på valfri börs.

Vem detta är för

Python-utvecklare som bygger börs-oberoende botar på CCXT som vill ha en oberoende marknadskontextkontroll före varje order. Smart Money API är beslutsstöd — det placerar inte order åt dig; CCXT behåller kontrollen över utförandet.

Förutsättningar

  • Python 3.9+ med pip install ccxt requests.
  • Börs-API-nycklar konfigurerade för CCXT (endast läsrättighet räcker för att testa).
  • En Smart Money API-nyckel (gratis nivå täcker BTC).

Skaffa din API-nyckel

Varje begäran autentiseras med X-API-Key header. För att få en nyckel:

  1. 1Skapa ett gratis konto, öppna sedan din instrumentpanel.
  2. 2Kopiera API-nyckeln som visas under API-åtkomst. Den gratis nivån täcker BTC med 20 förfrågningar/dag — tillräckligt för att testa denna guide från början till slut.
  3. 3Behöver du fler symboler eller högre gränser? Jämför nivåer på prissida.

Håll nyckeln hemlig — spara den i en miljövariabel, lägg aldrig in den i versionskontroll.

Installation

  1. 1Installera biblioteken: pip install ccxt requests.
  2. 2Exportera din nyckel: export SMA_API_KEY="sm_your_key_here".
  3. 3Låt din strategi bestämma en kandidatrikning från CCXT-marknadsdata, och anropa sedan /v1/confirm som en sista kontextgrind.
  4. 4Placera ordern med CCXT endast när åtgärden är CONFIRM, storlek efter size_mult.

Arbetsexempel

Detta skript läser en ticker med CCXT, härleder en kandidatrikning och anropar sedan GET /v1/confirm?symbol=BTC&direction=long innan det bestämmer sig för att placera ordern.

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

Förväntat svar

Ett lyckat anrop till /v1/confirm returnerar JSON så här:

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 sträcker sig från -1.0 (stark motriktning) till +1.0 (stark bekräftelse), confidence är HÖG eller MEDEL, och size_mult är en 0.0–1.5 föreslagen storleksmultiplikator. Se hela fältreferensen i API-dokumentationen.

Hur du agerar på svaret

BEKRÄFTA

Kontext stödjer din riktning. Fortsätt med dina egna inträdes- och riskregler, eventuellt skalning av storlek efter size_mult.

MINSKA

Signalerna är blandade. Överväg en mindre position, snävare stopp eller vänta på en renare setup.

HOPPA ÖVER

Marknadskontext stödjer inte denna affär. Stå vid sidan och kontrollera igen på nästa kandidat.

Redo att bygga?

Skaffa en gratis nyckel och gör ditt första bekräftelseanrop på under en minut.

Inte finansiell rådgivning. Kryptohandel innebär risk.