מדריך אינטגרציה

השתמש ב-Smart Money API לצד CCXT

קרא נתוני שוק חיים עם CCXT, שאל את Smart Money API האם זרימת הלווייתנים ומיקום הנגזרים מאשרים את הכיוון שלך, ואז בצע את ההזמנה בבורסה שבחרת.

למי זה מיועד

מפתחי Python שבונים בוטים שאינם תלויים בבורסה על CCXT שרוצים בדיקת הקשר שוק עצמאית לפני כל הזמנה. Smart Money API הוא תמיכה בהחלטות — הוא לא מבצע הזמנות עבורך; CCXT נשאר בשליטה על הביצוע.

דרישות מוקדמות

  • Python 3.9+ עם pip install ccxt requests.
  • מפתחות API של בורסה מוגדרים ל-CCXT (קריאה בלבד מספיקה לבדיקה).
  • מפתח API של Smart Money API (הרמה החינמית מכסה BTC).

קבל את מפתח ה-API שלך

כל בקשה מאומתת עם ה X-API-Key header. כדי לקבל מפתח:

  1. 1צור חשבון חינמי, ואז פתח את ה לוח המחוונים.
  2. 2העתק את מפתח ה-API המוצג תחת גישה ל-API. הרמה החינמית מכסה BTC ב-20 בקשות/יום — מספיק כדי לבדוק את המדריך הזה מקצה לקצה.
  3. 3צריך יותר סמלים או גבולות גבוהים יותר? השווה רמות בדף ה מחירים.

שמור את המפתח בסוד — אחסן אותו במשתנה סביבה, לעולם אל תכניס אותו לבקרת מקור.

התקנה

  1. 1התקן את הספריות: pip install ccxt requests.
  2. 2ייצא את המפתח שלך: export SMA_API_KEY="sm_your_key_here".
  3. 3תן לאסטרטגיה שלך להחליט על כיוון מועמד מנתוני שוק של CCXT, ואז התקשר ל /v1/confirm כשער הקשר סופי.
  4. 4בצע את ההזמנה עם CCXT רק כאשר הפעולה היא CONFIRM, גודל לפי size_mult.

דוגמה עובדת

סקריפט זה קורא טיקר עם CCXT, מפיק כיוון מועמד, ואז מתקשר ל GET /v1/confirm?symbol=BTC&direction=long לפני ההחלטה האם לבצע את ההזמנה.

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

תגובה צפויה

שיחה מוצלחת ל /v1/confirm מחזירה JSON כזה:

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 נע בין -1.0 (התנגדות חזקה) ל-+1.0 (אישור חזק), confidence הוא HIGH או MEDIUM, ו size_mult הוא מכפיל גודל מוצע 0.0–1.5. ראה את התייחסות השדה המלאה ב תיעוד API.

כיצד לפעול על פי התגובה

CONFIRM

הקשר תומך בכיוון שלך. המשך עם כללי הכניסה והסיכון שלך, אפשר לשנות את הגודל לפי size_mult.

REDUCE

האותות מעורבים. שקול עמדה קטנה יותר, עצירות הדוקות יותר, או המתנה להגדרה נקייה יותר.

SKIP

הקשר השוק אינו תומך בעסקה זו. הישאר בצד ובדוק שוב על המועמד הבא.

מוכן לבנות?

קח מפתח חינמי ובצע את שיחת האישור הראשונה שלך בתוך פחות מדקה.

לא ייעוץ פיננסי. מסחר בקריפטו כרוך בסיכון.