מדריך אינטגרציה
השתמש ב-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צור חשבון חינמי, ואז פתח את ה לוח המחוונים.
- 2העתק את מפתח ה-API המוצג תחת גישה ל-API. הרמה החינמית מכסה BTC ב-20 בקשות/יום — מספיק כדי לבדוק את המדריך הזה מקצה לקצה.
- 3צריך יותר סמלים או גבולות גבוהים יותר? השווה רמות בדף ה מחירים.
שמור את המפתח בסוד — אחסן אותו במשתנה סביבה, לעולם אל תכניס אותו לבקרת מקור.
התקנה
- 1התקן את הספריות:
pip install ccxt requests. - 2ייצא את המפתח שלך:
export SMA_API_KEY="sm_your_key_here". - 3תן לאסטרטגיה שלך להחליט על כיוון מועמד מנתוני שוק של CCXT, ואז התקשר ל
/v1/confirmכשער הקשר סופי. - 4בצע את ההזמנה עם CCXT רק כאשר הפעולה היא
CONFIRM, גודל לפיsize_mult.
דוגמה עובדת
סקריפט זה קורא טיקר עם CCXT, מפיק כיוון מועמד, ואז מתקשר ל GET /v1/confirm?symbol=BTC&direction=long לפני ההחלטה האם לבצע את ההזמנה.
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 כזה:
{
"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
הקשר השוק אינו תומך בעסקה זו. הישאר בצד ובדוק שוב על המועמד הבא.
מוכן לבנות?
קח מפתח חינמי ובצע את שיחת האישור הראשונה שלך בתוך פחות מדקה.
לא ייעוץ פיננסי. מסחר בקריפטו כרוך בסיכון.