הפניית API

Smart Money API

API מודיעין מקצועי שמאגד נתוני נגזרים, מדדי שרשרת ופעילות ארנקים של לווייתנים לציון ביטחון יחיד עבור בוט המסחר שלך.

גרסת ה-API הנוכחית: v1. כתובת בסיס: https://api.smartmoneyapi.com/v1

עקרונות עיצוב

ארבעה רעיונות מעצבים כל נקודת קצה וכל ציון שה-API מחזיר. הם גם הגבולות הכנים של מה שהוא מבטיח — ומה שלא.

אסטרטגיה ראשונה, לא אות ראשון. זה לא פיד אותות קנה/מכור. אתה מביא את האסטרטגיה והכניסה; ה-API אומר לך האם מבנה השוק הסובב — מיקום נגזרים, מימון, עניין פתוח, נזילות, זרימה בשרשרת והסכמת לווייתנים — מסכים עם העסקה שאתה כבר רוצה לבצע.

ציון ביטחון, לא חיזוי בינארי. כל תשובה נושאת דירוג confidence (גבוה / בינוני / נמוך) ו composite מ-1.0- עד +1.0. אין הבטחות ואין קריאות אורקל — אתה מקבל קריאה מכוונת על הסכמה, עם הסיבות מאחוריה, כך שתוכל להתאים את הגודל לפי הביטחון.

תמיכה בהחלטה, לא ייעוץ ביצוע. ה-API מחזיר המלצה של אישור / הפחתה / דילוג ומכפיל גודל עבור שלך לוגיקה לפעול עליה. הוא לעולם לא מבצע הזמנות, ושום דבר כאן אינו ייעוץ פיננסי. אתה נשאר אחראי לסיכון, גודל וביצוע.

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

למי מיועד ה-API הזה

ה-API הזה נבנה עבור מפתחי בוטים, אלגוריתמים וסוכני AI בקריפטו שכבר יש להם אות ארוך/קצר — מאסטרטגיית TA, מודל ML, צינור Freqtrade, התראת TradingView או סוכן LLM — ורוצים החלטה מהירה לפני מסחר אישור / הפחתה / דילוג לפני התחייבות הון.

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

זה לא גנרטור אותות עצמאי, מוצר תרשים או מקום ביצוע. אם אין לך אות משלך לשער, התחל עם דף ביצועים כדי לראות איך הציון התנהג לפני שחיברת אותו לבוט חי.

קבלת גישה

1 — הירשם. צור חשבון חינם ב הרשמה (אימייל/סיסמה או Google). אין צורך בכרטיס אשראי עבור הרמה החינמית.

2 — פתח את לוח הבקרה שלך. שלך לוח בקרה מציג את מפתח ה-API שלך, התוכנית הנוכחית ושימוש חי מול המכסה היומית שלך.

3 — העתק את מפתח ה-API שלך. מפתחות מקדימים sm_. העבר אותו כ X-API-Key כותרת בכל בקשה (ראה אימות). שדרג בכל עת ב עמוד תמחור להעלאת מגבלות ולפתיחת סמלים ונקודות קצה נוספים.

מפרט, SDK וספר מתכונים

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

משאב	מה זה
ספר מתכונים	מתכונים להעתקה-הדבקה לאינטגרציות הנפוצות ביותר — אשר לפני כניסה, שער לאות Freqtrade, גודל לפי מכפיל, טיפול ב-402/429, וחיבור לסוכן קידוד.
מפרט OpenAPI	הגדרת OpenAPI קריאה למכונה של כל נקודת קצה. ייבוא ל-Postman/Insomnia, יצירת לקוחות, או הזנה ל-LLM. ב `github.com/tashiardit/smartmoneyapi-docs`.
לקוח Python	ספריית הלקוח הרשמית של Python ב `github.com/tashiardit/smartmoneyapi-python`.
/llms.txt	סיכום טקסט פשוט של ה-API המתאים ל-LLM. הפנה את Claude, Codex, או Cursor אליו (ראה סוכני קידוד).

התחלה מהירה תוך 2 דקות

שלב 1 — כתובת בסיס. כל נקודת קצה נמצאת תחת:

כתובת בסיס
https://api.smartmoneyapi.com

שלב 2 — קבל את מפתח ה-API שלך. הירשם בחינם (לא נדרש כרטיס אשראי) והעתק את המפתח שלך מה לוח מחוונים. העבר אותו כ X-API-Key כותרת בכל בקשה.

שלב 3 — השיחה הראשונה שלך. הדבק את זה בטרמינל שלך והחלף sm_your_key עם המפתח מלוח המחוונים שלך:

cURL

curl -H "X-API-Key: sm_your_key" "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

תגובה צפויה:

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": ["שיעור מימון חיובי בכל הפלטפורמות", "לווייתנים: 67% קונצנזוס לונג"]
}

כאשר confidence הוא HIGH או MEDIUM ו action הוא CONFIRM, קבע את גודל המיקום לפי size_mult. זהו לולאת האינטגרציה המלאה. ראה שדות תגובה למפרט השדות המלא.

אימות

כל הבקשות דורשות מפתח API המועבר כ X-API-Key כותרת HTTP.

כותרת HTTP
X-API-Key: sm_your_api_key_here

מפתח ה-API שלך זמין מה לוח מחוונים לאחר ההרשמה. שמור על המפתח שלך בסוד — אל תחשוף אותו בקוד צד לקוח או במאגרים ציבוריים.

אימות WebSocket שונה. לעולם אל תשים את המפתח שלך בכתובת URL של WebSocket. זרמים בזמן אמת משתמשים ב כרטיסיםלטווח קצר וחד-פעמיים: שלח את המפתח שלך ל /v1/ws/ticket עם ה X-API-Key כותרת, ואז התחבר עם הכרטיס שהוחזר. ראה אימות WebSocket (כרטיסים).

כניסה עם Google (Firebase Auth)

משתמשים יכולים להיכנס באמצעות חשבון Google שלהם דרך Firebase Authentication. לאחר כניסה מוצלחת עם Google בצד הלקוח, החלף את אסימון ה-ID של Firebase עבור מפגש API מקושר. המערכת מסנכרנת אוטומטית את זהות Google שלך עם מערכת מפתחות ה-API.

זמין ל: חינם סוחר מקצועי

POST /auth/google

גוף הבקשה

שדה	סוג	תיאור
id_tokenנדרש	מחרוזת	אסימון ID של Firebase שהתקבל לאחר כניסה עם Google בצד הלקוח

תגובה לדוגמה

JSON

{
"api_key": "sm_your_linked_key",
"uid": "firebase_uid_abc123",
"email": "[email protected]",
"plan": "trader",
"synced": true
}

נתוני פרופיל משתמש — אימייל, תוכנית, היסטוריית שימוש, העדפות — נשמרים ב-Firestore ומקושרים לחשבון Google שלך. ניתן לבקש ייצוא נתונים מלא או מחיקת חשבון בכל עת דרך הגדרות הפרטיות בלוח המחוונים.

מגבלות קצב

תוכנית	קריאות/יום	מגבלת פרץ	עיכוב נתונים
חינם	50	2/דקה	60 שניות
סוחר	1,000	20/דקה	זמן אמת
Pro	5,000	60/min	Real-time
Enterprise	100,000	400/min	Real-time

כותרות מגבלת קצב כלולות בכל תגובה: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Base URL

https://api.smartmoneyapi.com/v1

כל נקודות הקצה להלן הן יחסיות לכתובת הבסיס הזו. כל התגובות הן ב-JSON עם Content-Type: application/json.

שגיאות

שגיאות משתמשות בקודי סטטוס HTTP סטנדרטיים וגוף JSON עקבי. תמיד תנפו על קוד הסטטוס, לא על טקסט התגובה. השלוש שתיתקלו בהן לרוב:

סטטוס	קוד	משמעות ומה לעשות
401	לא מורשה	מפתח API חסר או לא תקף. בדוק ש- `X-API-Key` הכותרת קיימת ונכונה.
402	נדרש תשלום	נקודת הקצה או הסמל דורשים תוכנית גבוהה יותר מזו שיש למפתח שלך (למשל, מפתח חינמי שמתקשר ל-WebSocket firehose). שדרג או חזור לנקודת קצה ציבורית.
429	חריגת מגבלת קצב	מגבלה יומית או מגבלת פרץ הושגה. התרחק ונסה שוב אחרי `X-RateLimit-Reset`; אל תפגע חזק.

כל שגיאה מחזירה את אותה צורה:

JSON
{
 "error": "rate_limit_exceeded",
 "message": "Daily limit of 100 calls reached. Resets at 00:00 UTC.",
 "status": 429
}

לרשימה המלאה של קודי סטטוס (400 / 403 / 500 / 503 ועוד), ראה קודי שגיאה. אינטגרציה חזקה מתייחסת ל-5xx ו-429 כאל זמניים (נסה שוב עם התרחקות) ול-401/402/403 כאל סופיים (תקן את המפתח או התוכנית).

שיטות עבודה מומלצות לאבטחה

שלח את המפתח בכותרת, לעולם לא בכתובת ה-URL. תמיד העבר X-API-Key ככותרת HTTP. מפתחות במחרוזות שאילתה (?key=) נרשמים על ידי פרוקסיס, מאזני עומס והיסטוריית דפדפן — האימות הישן ?key= לא מתקבל עוד בנקודות קצה של WebSocket מסיבה זו בדיוק.

שמור מפתחות בצד השרת. לעולם אל תטמיע מפתח API ב-JavaScript בצד הלקוח, בחבילת אפליקציה ניידת או במאגר ציבורי. טען אותו ממשתנה סביבה או ממנהל סודות. אם מפתח דולף, החלף אותו.

החלף מפתחות באופן תקופתי. צור מחדש את המפתח שלך מה- dashboard על פי לוח זמנים ומידת הצורך אם אתה חושד בחשיפה. המפתח הישן מפסיק לעבוד ברגע שמפתח חדש מונפק.

השתמש בכרטיסים עבור חיבורי דפדפן. לזרמים בזמן אמת מהדפדפן, החלף את המפתח שלך בכרטיס לשימוש חד פעמי במקום להתחבר עם המפתח הגולמי — ראה אימות WebSocket (כרטיסים).

שימוש עם סוכני קידוד / LLMs

בונים עם Claude Code, Codex, Cursor, או כל סוכן קידוד LLM? אתה יכול להעביר לסוכן את כל מה שהוא צריך כדי לחבר את ה-API הזה בצורה נכונה בפעם אחת. שני מקורות קריאים למכונה פורסמו:

משאב	URL
סיכום LLM	`https://smartmoneyapi.com/llms.txt`
מפרט OpenAPI	`github.com/tashiardit/smartmoneyapi-docs`

הפנה את הסוכן שלך ל- /llms.txt קובץ (ה- llms.txt convention) לקבלת סקירה תמציתית, ואז למפרט OpenAPI עבור צורות בקשה/תגובה מדויקות. שורת הנחייה אחת שעובדת היטב:

הנחייה

# הדבק לתוך Claude Code / Cursor / Codex
קרא https://smartmoneyapi.com/llms.txt ואת מפרט OpenAPI ב-
github.com/tashiardit/smartmoneyapi-docs, ואז הוסף בדיקה מקדימה
לרובוט שלי שמתקשר ל-GET /v1/confirm ודלג על כניסות
אלא אם הפעולה היא CONFIRM.

ראה את ספר בישול למתכון עבור סוכן קידוד.

נקודות קצה

GET /confirm

נקודת הקצה המרכזית. מחזירה ציון ביטחון מורכב והמלצת פעולה עבור כיוון מסחר נתון. התקשר לזה לפני הכניסה לכל עמדה.

כיסוי, במונחים פשוטים. /confirm כרגע מדרג BTC, ETH ו-SOL — הסמלים עם מספיק היסטוריה פתורה כדי לאשר בכנות. סורק הנגזרות בנפרד מנטר ~519 שווקי נגזרות למימון, נתוני OI ונתוני נזילות, ומעקב אחר לווייתנים מכסה 600+ ארנקים. Pro פותח את הסורק המלא, יצוא וכיסוי שווקים רחב יותר; /confirm תמיכה בסמלים מתרחבת ככל שכל שוק צובר מסלול אמין.

פרמטרים

פרמטר	סוג	תיאור
symbolנדרש	string	סמל נכס. אחד מ: `BTC`, `ETH`, `SOL` (Trader+)
directionנדרש	string	כיוון מסחר: `long` או `short`
sourceאופציונלי	string	תווית למקור האיתות שלך (נרשם לניתוח). מקסימום 32 תווים.

דוגמת בקשה

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

דוגמת תגובה

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "direction": "long",
 "composite": 0.74,
 "confidence": "HIGH",
 "action": "CONFIRM_FULL",
 "size_mult": 1.5,
 ציון נגזרות: 0.81,
 ציון שרשרת: 0.68,
 ציון לווייתנים: 0.73,
 ציון x: 0.0,
 גורמים: {
 נגזרות: { ציון: 0.81, משקל: 0.40, משקלי: 0.324 },
 שרשרת: { ציון: 0.68, משקל: 0.35, משקלי: 0.238, מקור: coinmetrics, זמין: True },
 לווייתן: { ציון: 0.73, משקל: 0.25, גורם התיישנות: 1.0, משקלי: 0.183 }
  },
 התאמות: { הסכמה: 0.0, מגמה: 0.0, חדשות מאקרו: 0.0 },
 משקלים: { נגזרות: 0.40, שרשרת: 0.35, מודיעין לווייתנים: 0.25 },
 כיסוי: { נגזרים: True, לווייתן: True, על-שרשרת: True },
 סיבות: [
 שיעור המימון חיובי בכל הפלטפורמות,
 LSR לטובת לונגים: 1.42,
 לווייתנים: 67% קונצנזוס לונג,
 MVRV מעל 1.0 — בוליש על-שרשרת
  ]
}

שקוף בתכנון. כל תגובה מכילה factors אובייקט המציג כל רגל ניקוד × משקל = משוקלל תרומה, אובייקט adjustments לשינויים לאחר סינון, weights בשימוש, ו coverage מפה. הרגל על-שרשרת משתמשת בנתוני Coin Metrics בחינם אמיתיים (MVRV / זרימת-בורסה / כתובות-פעילות) כאשר לא מוגדר מפתח Glassnode. זהו ציון רב-גורמי התכנסות ניקוד — תמיכה בהחלטה, לא אחוז ניצחון מובטח.

סמלים לא מעקב הם כנים. סמל מחוץ ליקום הנגזרים/לווייתנים המעקב מחזיר "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" עם "unsupported":true — לעולם לא מזויף LOW.

שדות תגובה

שדה	סוג	תיאור
ts	integer	חותמת זמן יוניקס של החישוב
symbol	string	סימול נכס (BTC/ETH/SOL)
direction	string	כיוון מבוקש (long/short)
composite	float	ציון התכנסות מורכב מ-1.0- (מנוגד קיצוני) עד 1.0+ (אישור חזק). לא שיעור ניצחון.
base_composite	float	התכנסות לפני יישום התאמות פוסט-פילטר
confidence	string	`HIGH` / `MEDIUM` / `LOW` / `VETO` / `NO_DATA`
action	string	`CONFIRM_FULL` / `CONFIRM_REDUCED` / `CONFIRM_MINIMAL` / `VETO_SKIP` / `NO_DATA_SKIP`
size_mult	float	מכפיל גודל מיקום מוצע (למשל 0.0 – 1.5)
unsupported	bool	`true` כאשר הסימול מחוץ לכיסוי (מלווה ב-NO_DATA)
deriv_score	float	ציון משנה נגזרות (1- עד 1)
onchain_score	float	ציון משנה על-שרשרת (1- עד 1)
whale_score	float	ציון משנה קונצנזוס לווייתנים (1- עד 1)
x_score	float	ציון משנה X/רגש חברתי (1- עד 1); 0 כאשר לא בשימוש
factors	object	פירוט לפי רכיב: `score × weight = weighted` עבור נגזרות / על-שרשרת / לווייתנים / x_sentiment (על-שרשרת כולל `source`)
adjustments	object	כיוונונים פוסט-פילטר חתומים (הסכמה, מגמה, rsi_1h, news_macro, מומנטום, שעה ביום, דעיכת רצף)
weights	object	קבוצת משקלות שבפועל שימשה להערכה זו
coverage	object	`{derivatives, whale, onchain}` — אילו רכיבים הכילו נתונים אמיתיים
reasons	array	מחרוזות הסבר קריאות לאדם עבור הציון

GET /snapshot

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

Requires: סוחר Pro

GET /onchain

מחזיר מדדים גולמיים מהשרשרת: MVRV, SOPR, זרימה נטו בבורסות, יחס הון ממומש, וסיווג מיקום במחזור.

דרישות: סוחר Pro

GET /v1/derivatives/*

מסנן נגזרים רב-בורסתי ל-500+ סמלים: מפת חום של שערי מימון, דירוגי עניין פתוח, וזיהוי אותות יחס Long/Short. 10 השורות העליונות ציבוריות; המסנן המלא דורש סוחר או Pro. נקודות קצה: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET /v1/options/*

ניתוחי אופציות של BTC & ETH ממקור Deribit (ציבורי, ללא אימות): יחס Put/Call, Max Pain, ועניין פתוח לפי Strike. נקודות קצה: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET /v1/etf/*

זרימות נטו יומיות של ETF ל-BTC & ETH ופירוט לפי קרן (ציבורי). נקודות קצה: /v1/etf/flows, /v1/etf/funds.

GET /v1/historical/*

מידע היסטורי על מימון, עניין פתוח, יחס Long/Short (Binance), ו-OHLCV (CoinGecko) לבדיקות רטרו. נקודות קצה: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET /v1/dex/*

צמדי מטבעות פופולריים, חיפוש אסימונים, ופרטי צמדים המופעלים על ידי DexScreener (ציבורי, ללא אימות). נקודות קצה: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET /v1/news/*

מודיעין חדשותי: חדשות מדיניות/גיאופוליטיות/קריפטו מסווגות לפי קטגוריות השפעה, פלוס מדד Fear & Greed (ציבורי, ללא אימות). נקודות קצה: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET /whales

מחזיר נתוני קונצנזוס של ארנקי לווייתנים: פיצול Long/Short, חשיפה נומינלית כוללת, 10 הפוזיציות המובילות (Pro בלבד), וספירת ארנקים.

דרישות: סוחר Pro

GET /signals

מחזיר זרם של האותות האחרונים בדירוג HIGH/MEDIUM בכל הנכסים המנוטרים. שימושי לסריקת הזדמנויות.

דרישות: Pro

GET /v1/strategies/*

תיעוד שקוף לקריאה בלבד של אסטרטגיות המסחר האוטומטיות הפועלות על בסיס אותות Smart Money — כולל deriv40 אסטרטגיית העתקת מסחר SmartMoney (account=9). כל נקודות הקצה מקבלות ?account=<id> פרמטר שאילתה ומחזירות JSON. אין צורך באימות (תיעוד ציבורי).

נקודות קצה

GET /v1/strategies/stats?account=9 — מדדים מרכזיים: total_trades, win_rate, profit_factor, total_pnl_usdt, account_growth_percent, initial_equity, current_equity, max_drawdown_portfolio, max_drawdown_trade.
GET /v1/strategies/equity?account=9 — עקומת הון עבור גרפים: { initial_equity, curve: [{ time, equity }] }.
GET /v1/strategies/trades?account=9&limit=500 — יומן מסחר סגור: מערך (או {trades:[…]}) של symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
GET /v1/strategies/active?account=9 — פוזיציות פתוחות כרגע: מערך (או {positions:[…]}) של symbol, side/direction, entry_price, unrealized_pnl.
GET /v1/strategies/signals — פירוט לפי סוג אות המזין את האסטרטגיות (מספר / ניצחונות / שיעור ניצחונות / רווח ממוצע לאות).

ביצועי עבר אינם מעידים על תוצאות עתידיות. הנתונים מוזנו רטרו על פני תקופה אחת של ~3 חודשים פלוס מסחר חי ומוצגים לפני עמלות במקומות המצוינים.

GET /export

הורד נתוני אותות היסטוריים כ-CSV לבדיקות רטרו. פרמטרים: symbol, from (unix ts), to (unix ts).

דרישות: Pro

GET /health

בדיקת תקינות מערכת. מחזיר עדכניות נתונים לכל מקור וסטטוס API כללי. אין צורך באימות.

תגובת JSON
{
 "status": "ok",
 "uptime_s": 1209600,
 "sources": {
 "bybit": { "lag_s": 42, "ok": true },
 "binance": { "lag_s": 38, "ok": true },
 "hyperliquid": { "lag_s": 61, "ok": true },
 "onchain": { "lag_s": 290, "ok": true }
  }
}

GET /usage

מחזיר סטטיסטיקות שימוש נוכחיות ב-API: קריאות היום, סיכומים חודשיים, מגבלות מכסה, וזמני איפוס.

POST /webhooks

דרישות: Pro

רשום כתובת HTTPS לקבלת דחיפות אירועים חתומות בזמן אמת כאשר אות משוגר בנכסים המנוטרים שלך. משלים כוללים X-SmartMoney-Event כותרת וחתימת HMAC-SHA256 ב X-SmartMoney-Signature, וניסויים חוזרים עד 3× עם השהיה מתגברת.

גוף בקשה

שדה	סוג	תיאור
urlנדרש	מחרוזת	נקודת קצה HTTPS אליה לשלוח אירועים (חייבת להתחיל ב `https://`)
eventsנדרש	מערך	שמות אירועים, למשל `["HIGH","MEDIUM","VETO"]` או `["*"]`
symbolsנדרש	מערך	סמלים לסינון, למשל `["BTC","ETH"]` או `["*"]`
secretנדרש	מחרוזת	סוד החתימה שלך, ≥ 16 תווים (מאוחסן כגיבוב)

אימות החתימה

מפתח ה-HMAC הוא הגיבוב SHA-256 של הסוד הרשום שלך. חשב את HMAC-SHA256 של גוף הבקשה הגולמי עם המפתח הזה והשווה (בזמן קבוע) נגד X-SmartMoney-Signature. See the מדריך ליישום Webhook.

אינטליגנציה

GET /analysis

דרישות: Pro

מחזיר סיווג מונחה-בינה מלאכותית של מצב שוק עם זיהוי התנגשויות אותות. מנתח הסכמה בין אותות, מזהה פערים בין נגזרות, נתוני on-chain ונתוני לווייתנים, ומייצר סיכום בשפה טבעית עם גורמי סיכון עתידיים והמלצה עם אופק זמן.

פרמטרים

פרמטר	סוג	תיאור
symbolנדרש	string	סמל נכס: `BTC`, `ETH`, או `SOL`

תגובה לדוגמה

JSON

{
 "ts": 1710940821,
 "symbol": "BTC",
 "regime": "late_cycle_divergence",
 "regime_label": "Late Cycle — Signal Divergence",
 "summary": "BTC נמצא בשלב מאוחר של מחזור שוורים עם חוזק on-chain שמתנגש עם מתיחות יתר של נגזרות. לווייתנים מפחיתים חשיפה בזמן ש-LSR קמעונאי עולה.",
 "signal_conflicts": [
 ציון לווייתנים bearish בעוד ציון on-chain bullish,
 שיעור המימון בשיא של 3 חודשים — סיכון פוטנציאלי ללחיצה
  ],
 risk_factors: [מימון גבוה, סטייה ב-OI, הפחתת לווייתנים],
 recommendation: הפחיתו חשיפה long, הדקו stops. הימנעו מ-longs חדשים מעל המחיר הנוכחי.,
 time_horizon: 4h–12h
}

נדרש תוכנית Pro. נקודת קצה זו צורכת 3 קריאות API לבקשה עקב עומס עיבוד AI.

GET /liquidations

דרישות: Trader Pro

מחזיר שתי תצוגות משלימות: (1) leverage-projected levels — הערכה של היכן מקבצי liquidation נמצאים; ו-(2) a realized_heatmap — ה REAL executed עוצמת forced-liquidation (מחיר × זמן), מצטברת בזמן אמת מפידים ציבוריים של WebSocket בבורסות: Binance, OKX, Bybit, Bitget, BitMEX. מפת החום מוצגת כאשר יש נתונים לסמל בזרם (חסרה בשוק מאוד שקט או מייד לאחר ההפעלה).

Parameters

Parameter	Type	תיאור
סמלאופציונלי	מחרוזת	סמל נכס (ברירת מחדל `BTC`). מפת חום אמיתית מכסה סמלי פרp סחירים באופן פעיל.

תגובה לדוגמה

JSON

{
 "symbol": "BTC",
 "cascade_risk": "HIGH",
 "nearest_long_liq_pct": -3.2,
 "nearest_short_liq_pct": 4.1,
 // נזילות שבוצעו בפועל — חי מ-5 בורסות
 "realized_heatmap": {
 "window_minutes": 240, "price_min": 91000.0, "price_max": 99000.0,
 "clusters": [ { "price": 93250.0, "notional": 4820000.0, "count": 37, "dominant_side": "long" } ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 }
  }
}

תוכנית סוחר: cascade_risk, מרחקים קרובים, וסכומים שבוצעו/לפי צד. תוכנית מקצועית: השלכה מלאה levels פלוס המלא realized_heatmap (מטריצות, אשכולות לפי מחיר, ספירות לפי בורסה). ההערכה המושלכת עונה על "איפה הסטופים"; מפת החום שבוצעה מראה "מה באמת נוזל."

GET /liquidations/heatmap

זמין ל: חינם לא נדרש אימות (מוגבל לפי IP)

ציבורי מפת חום נזילות לפי רמת מחיר. מחזירה מטריצת מחיר × זמן בסגנון Coinglass של נזילות שבוצעו בפועל נזילות כפויות, מקובצות לפי המחיר בו כל נזילה נרשמה — מצטבר חי מזרמי WebSocket ציבוריים של בורסות: Binance, OKX, Bybit, Bitget, BitMEX. ה clusters מערך הוא הפלט המעשי: דליי מחיר מדורגים לפי נזילות נומינלית, כל אחד מתויג עם הצד הדומיננטי שלו. הנתונים תלויים בזרם החי — סמל שקט מאוד או שער שזה עתה הופעל מחזיר את המבנה הריק המתוקן בתוספת note. הרמות המוצגות הן רק נזילות אמיתיות, לעולם לא מוערכות.

פרמטרים

פרמטר	סוג	תיאור
symbolאופציונלי	string	סמל הנכס (ברירת מחדל `BTC`).
window_minutesאופציונלי	int	חלון זמן רטרוספקטיבי בדקות (ברירת מחדל `240`, מוגבל ל-5–1440).
price_bucketsאופציונלי	int	מספר דליים של מחירים (ברירת מחדל `50`, מוגבל ל-5–100).

תגובה לדוגמה

JSON

{
 "symbol": "BTC", "window_minutes": 240, "price_buckets": 50,
 "price_min": 91000.0, "price_max": 99000.0, "price_bucket_size": 160.0,
 "price_levels": [ 91080.0, 91240.0, … ], "time_buckets": [ … ],
 "matrix": [ [ … ] ], "long_matrix": [ [ … ] ], "short_matrix": [ [ … ] ],
 "clusters": [
    { "price": 93250.0, "notional": 4820000.0, "long_notional": 4100000.0,
 "short_notional": 720000.0, "count": 37, "dominant_side": "long" }
  ],
 "by_side": { "long": 6100000.0, "short": 2400000.0 },
 "totals": { "long_liq_notional": 6100000.0, "short_liq_notional": 2400000.0, "total_notional": 8500000.0, "count": 214 },
 "exchanges": { "binance": 120, "okx": 40, "bybit": 34, "bitget": 12, "bitmex": 8 },
 "generated_at": 1710940200, "public": true
}

הערה כנה: נקודת קצה זו משקפת רק את מה שזרם החיי תפס. כאשר סמל שקט או שהזרם רק התחיל, totals.count is 0, clusters is empty, and a note שדה מסביר מדוע. זהו רישום של ביצועי נזילות — לא תחזית. עבור ההערכה החזויה "איפה העצירות", השתמש בנקודת הקצה המאומתת /liquidations נקודת קצה.

GET /liquidations/onchain

דרישות: Trader Pro

בוצע נזילות הלוואות DeFi בשרשרת נלכדו ישירות מהצמתים המקומיים שלנו BSC + Avalanche full nodes — עצמאי מכל בוט מסחר. מכסה את Venus/Cream ו-Moolah ב-BSC, ואת AAVE V3/V2, Benqi, BankerJoe, Granary ו-Vinium ב-Avalanche. רמת Pro מחזירה בנוסף at_risk עמדות (תלוי בבוט, עשוי להיות חסר).

פרמטרים

פרמטר	סוג	תיאור
chainאופציונלי	string	`bsc` or `avax`. השמט עבור כל השרשראות.
limitאופציונלי	integer	מספר שורות מקסימלי (ברירת מחדל 100, מקסימום 500). החדש ביותר ראשון.

תגובה לדוגמה

JSON

{
 "chain": "bsc", "count": 2,
 "liquidations": [
    { "chain": "bsc", "protocol": "Venus", "borrower": "0x2be6…8dfa",
 "debt_symbol": "DAI", "repay_usd": 426.15,
 "collateral_symbol": "WBNB", "tx_hash": "0x718c…7c0e", "block": 89170816, "ts": 1710940200 }
  ],
 "summary": {
 "window_hours": 24, "enabled": true,
 "by_protocol": { "bsc:Venus": { "count": 61, להחזיר_דולר_ידוע: 148230.55 } },
 צמתים: { bsc: { נגיש: true, בלוק_ראשי: 89173010, אירועים_סה"כ: 61 } }
  }
}

GET /smart-stop

דרישות: סוחר מקצועי

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

פרמטרים

פרמטר	סוג	תיאור
symbolנדרש	string	סמל נכס: `BTC`, `ETH`, או `SOL`
directionנדרש	string	כיוון פוזיציה: `long` או `short`
entry_priceאופציונלי	float	מחיר הכניסה שלך. ברירת מחדל: מחיר השוק הנוכחי אם לא צוין.
risk_pctאופציונלי	float	סיכון מקסימלי מקובל כאחוז מהחשבון. ברירת מחדל: `2.0`

תגובה לדוגמה

JSON

{
 symbol: BTC,
 direction: long,
 entry_price: 96420,
 stops: {
 tight: { price: 95100, note: מתחת למבנה שעתי. הכי טוב לסקאלפינג. },
 recommended: { price: 93800, note: מתחת לצבר נוזליות מרכזי ב-94K$. עצירת סחיפה סטנדרטית. },
 wide: { price: 91200, note: מתחת לאזור ביקוש 4 שעות. עצירת פוזיציה ארוכה. }
  },
 avoid_zones: [
    { low: 94200, high: 94800, reason: צבר נוזליות צפוף — סיכון החלקה גבוה }
  ],
 take_profit_suggestions: [
    { tp1: 98500, tp2: 101000, tp3: 104200 }
  ]
}

תוכנית סוחר: מחזיר רק את recommended העצירה המומלצת. תוכנית מקצועית: כל שלוש רמות העצירה, avoid_zones, והצעות רווח מלאות.

GET /funding-arb

דרישות: סוחר מקצועי

מזהה הזדמנויות ארביטראז' שיעורי מימון בין בורסות בזמן אמת. מחזיר הזדמנויות מדורגות עם תשואה שנתית משוערת, צמד הבורסות האופטימלי ופעולת הגידור הנדרשת ללכידת הפער.

פרמטרים

פרמטר	סוג	תיאור
min_spreadאופציונלי	float	פער מינימלי בשיעור המימון להכללה (כעשרוני). ברירת מחדל: `0.01`
symbolאופציונלי	string	סינון לנכס ספציפי. השמט לסריקת כל הנכסים הנתמכים.

תגובה לדוגמה

JSON

{
 ts: 1710940821,
 opportunities: [
    {
 symbol: BTC,
 spread: 0.032,
 apr: 84.2,
 long_exchange: hyperliquid,
 short_exchange: bybit,
 action: קנה HYPE / מכור BYBIT,
 estimated_profit_8h_usd: 26.4
    }
  ]
}

תוכנית סוחר: רק ההזדמנות המובילה, ללא נתוני פער היסטוריים. תוכנית מקצועית: כל ההזדמנויות הנוכחיות עם היסטוריית פער 24 שעות לכל צמד בורסות.

גרסה ציבורית חינמית ללא אימות

נקודת קצה ציבורית ללא מפתח מחזירה את 10 ההזדמנויות המובילות עם מסך בין-בורסתי חי, אידיאלי להטמעה או בדיקות מהירות. היא משמיטה היסטוריית פער לנכס ספציפי ושדות כבדים ומשירת מטמון של 120 שניות. כאשר אין פערי מימון בין-בורסתיים בחלון הטריות, היא מחזירה opportunities מערך ריק עם note — ללא נתונים מפוברקים לעולם.

GET (ללא אימות)

GET /v1/derivatives/funding-arb

JSON

{
 opportunities: [
    {
 symbol: OGN,
 spread_pct: 0.297667,
 annualized_apr: 325.95,
 long_exchange: bybit,
 short_exchange: hyperliquid,
 estimated_profit_per_10k: 29.77,
 risk_notes: ספרד נמוך — וודא שעמלות לא גובות את מרווח הארביטרז'.
    }
  ],
 scanned_symbols: 222,
 ts: 1783268753,
 public: True,
 limited: True
}

חינם, אין צורך במפתח API. רק 10 ההזדמנויות המובילות, מוגבלות ומאוחסנות במטמון (120 שניות). עמוד סינון חי: funding-arb.html.

GET /smart-money/flow

דרישות: Trader Pro

מדד כיווני לווייתנים משוקלל איכות לכל סמל, בדירוג -100 (כסף לווייתנים נוטה לקצר) עד +100 (נוטה ללונג). נבנה מאלפי ארנקי לווייתנים במעקב ב-Hyperliquid — כל אחד משוקלל לפי שיעור הניצחונות ההיסטורי וה-PnL שלו ומופחת לפי עדכניות. זהו מדד מיקום, לא אות קניה/מכירה או חיזוי מחיר. סמלים עם מעט ארנקים תורמים מסומנים thin ומדורגים בכנות. עמוד חי: smart-money-flow.html.

פרמטרים

פרמטר	סוג	תיאור
symbolאופציונלי	string	סמל בודד (למשל `BTC`). השמט כדי לקבל את כל הסמלים במעקב לפי דירוג \|score\|.
window_hoursאופציונלי	int	חלון דירוג, מוגבל ל `1..168`. ברירת מחדל `24`.

תגובה לדוגמה

JSON

{
 symbols: [
    {
 symbol: SPX,
 score: -90.93,
 direction: strong_short,
 n_wallets: 26,
 long_usd: 184200.0, short_usd: 2410000.0,
 quality_weighted: true,
 "sample_quality": "rich",
 "top_contributors": [ { "wallet": "0x31ca…974b", "direction": "short", "value_usd": 5338.25, "weight": 0.4948 } ]
    }
  ],
 "window_hours": 24,
 "quality_weighted": true,
 "ts": 1783270000,
 "note": "מדד מיקום כיווני של לווייתנים משוקלל איכות (-100..+100). לא חיזוי מחיר או אות קנייה/מכירה."
}

תוכנית סוחר: 12 הסמלים המובילים, פרטי תורמים מוסתרים. תוכנית מקצועית: כל הסמלים עם פרטים לכל סמל top_contributors. משקלי ארנק מוגבלים ל [0.25,1.0]; PnL הוא פרוקסי לא ממומש מתמונות המיקום האחרונות.

GET "/v1/whales/crowding"

זמין ל: חינם אין צורך באימות — גישה אנונימית מקבלת את 10 הסמלים המובילים, סוחר+ מקבל את הרשימה המלאה

משולב מיקום לווייתנים והקשר צפיפות לכל סמל, ממוזג בין Hyperliquid + GMX v2 + Jupiter Perps. מחזיר ערך נקוב גולמי/נטו, הטיה כיוונית, ספירת ארנקים ופלטפורמות, ריכוז מיקום (חלק top-3 + HHI), ממוצע מינוף משוקלל, ו דליים קרבה לניקוי ($ ערך נקוב שנמצא בתוך 5% ו-10% ממחיר הניקוי המשוער, מפוצל long/short). זהו הקשר, לא אות כיווני. שדות שאינם ניתנים לגזירה הם null ומוצגים כ — — למשל lev_wavg/crowding_index כאשר אף מיקום אינו נושא מינוף. מרחקי ניקוי הם הערכת מרווח מבודד (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), לא מחירי ניקוי שדווחו על ידי הבורסה.

פרמטרים

פרמטר	סוג	תיאור
min_notionalאופציונלי	float	ערך נקוב גולמי מינימלי משולב (USD) לסמל שייכלל. ברירת מחדל: `1000000`.

בקשה לדוגמה

GET (ללא אימות)

curl "https://api.smartmoneyapi.com/v1/whales/crowding?min_notional=1000000"

תגובה לדוגמה

JSON

{
 "ok": true, "ts": 1783423500, min_notional: 1000000, n_symbols: 92,
 symbols: [
    {
 symbol: BTC,
 gross_usd: 2447900000.0, net_usd: -51000000.0, skew: -0.021,
 n_whales: 414, n_venues: 3,
 venues: {
 hl: { gross: 1900000000.0, net: -40000000.0, n_whales: 272 },
 gmx: { gross: 320000000.0, net: -6000000.0, n_whales: 59 },
 jupiter: { gross: 227900000.0, net: -5000000.0, n_whales: 83 }
      },
 conc_top3: 0.159, hhi: 0.011, lev_wavg: 19.1,
 liq_within_5pct: { long: 621700000.0, short: 665600000.0 },
 liq_within_10pct: { long: 840000000.0, short: 910000000.0 },
 crowding_index: 0.003
    }
  ],
 caveats: [ מרחקי נזילות הם הערכות מבודדות-מרווח, לא מדווחים על ידי הבורסה. ]
}

הערה כנה: skew is net/gross ∈ [-1,1]; crowding_index = |skew|·conc_top3·min(lev/20,1). רק פלטפורמות שקיימות בפועל מופיעות ב venues. פוזיציות ללא מינוף אינן נכללות בדלי הנזילות ולא מונחות. מתקשרים אנונימיים מקבלים את 10 הסמלים המובילים לפי גולמי (עם gated: true); Trader+ מקבלים את הרשימה המלאה.

GET /v1/options/gex

זמין ל: Free לא נדרש אימות (מוגבל לפי IP)

Dealer חשיפה לגאמה (GEX) אנליטיקה עבור BTC & ETH, מחושבת בזמן אמת משרשרת האופציות הציבורית של Deribit (ללא אימות). מחזירה GEX נטו של דילר לכל סטרייק (מוסכמת SpotGamma של דילר-שורט), את רמת הפיכת הגאמה (סטרייק שבו GEX נטו מצטבר חוצה אפס), את מבנה מועד IV (IV ATM לפי ימים לפקיעה), ואת הטיית IV לפקיעה הקרובה (הפוך סיכון 25Δ פרוקסי). מצב GEX הוא positive (דילרים לונג גאמה → מדכא תנודתיות) או negative (מגביר תנודתיות). עצמאי לחלוטין - מחושב מחדש בכל קריאה, ללא תלות במסד נתונים מאוחסן.

פרמטרים

פרמטר	סוג	תיאור
symbolאופציונלי	string	`BTC` או `ETH` רק. ברירת מחדל: `BTC`.

בקשה לדוגמה

GET (ללא אימות)

curl "https://api.smartmoneyapi.com/v1/options/gex?symbol=BTC"

תגובה לדוגמה

JSON

{
 "symbol": "BTC", "available": true, "spot": 63203.0,
 "net_gex": 18240000.0, "regime": "positive",
 "gamma_flip": 64919.82, "gamma_flip_pct": 2.72,
 "call_gex": 31200000.0, "put_gex": -12960000.0,
 "by_strike": [
    { "strike": 60000, "net_gex": -2100000.0 },
    { "strike": 65000, "net_gex": 4800000.0 }
  ],
 "term_structure": [
    { "expiry": "8JUL26", "dte": 0.76, "atm_iv": 62.1 },
    { "expiry": "27MAR26", "dte": 14.2, "atm_iv": 58.4 }
  ],
 "skew": {
 "expiry": "8JUL26", "dte": 0.76,
 "put_iv": 69.69, "atm_iv": 62.1, "call_iv": 55.34,
 "risk_reversal": 14.35, "bias": "downside_fear"
  }
}

הערה כנה: מכפיל החוזה של Deribit הוא 1 (OI במטבע). בכל כשל בקבלת נתונים, הנתיב מחזיר available: false עם פאנלים ריקים - לעולם לא GEX מזויף. הטיית IV משתמשת בפרוקסי סטרייק קבוע של ±10% עבור 25Δ (25-דלתא אמיתי דורש פתרון דלתא לכל סטרייק); מתאים להצגה, מתועד כקירוב.

GET /v1/liquidations/simulate

זמין ל: Free לא נדרש אימות (מוגבל לפי IP)

Interactive בדיקת לחץ של שרשרת נזילות. בהינתן תנועת מחיר היפותטית, מחזיר את הערכת הפוזיציות הממונפות שיונזלו, נפח כפוי לפי רמת מחיר / צד / בורסה, וקריאת עומק שרשרת. תנועה כלפי מטה מנזלת לונגים שמחיר הנזילות שלהם נמצא מעל או שווה ליעד; תנועה כלפי מעלה מנזלת שורטים שמחיר הנזילות שלהם נמצא מתחת או שווה לו. שני שיטות עצמאיות משולבות: מחירי נזילות מדויקים מוויילס במעקב של Hyperliquid אמיתי מינוף/כניסה, בתוספת אשכולות סטטיסטיים של פסי OI לכל בורסה (מינוף הקהל מוסק ממימון). הכל מסומן בבירור estimated: true — זה לא יכול לדעת מרווח לכל חשבון, צולב לעומת מבודד, מרווח נוסף, או ADL.

פרמטרים

פרמטר	סוג	תיאור
סמלאופציונלי	מחרוזת	סמל נכס. ברירת מחדל: `BTC`.
move_pctאופציונלי	מספר עשרוני	תנועת מחיר היפותטית כאחוז (שלילי = מטה, חיובי = מעלה). ברירת מחדל: `-5`.

בקשת דוגמה

GET (ללא אימות)

curl "https://api.smartmoneyapi.com/v1/liquidations/simulate?symbol=BTC&move_pct=-5"

תגובת דוגמה

JSON

{
 "ok": true, "estimated": true, "symbol": "BTC",
 "ref_price": 63000.0, "move_pct": -5.0, "target_price": 59850.0,
 "triggered_notional_usd": 380000000.0,
 "cascade_depth": 0.029, "cascade_bucket": "low",
 "by_exchange": { "hyperliquid": 260000000.0, "binance": 80000000.0, "bybit": 40000000.0 },
 "by_side": { "long": 380000000.0, "short": 0.0 },
 "clusters": [
    { "price": 60100.0, "side": "long", "notional_usd": 42000000.0, "whale_usd": 18000000.0, "oi_usd": 24000000.0 }
  ],
 "whale_positions_used": 272, "exchanges": 3,
 "realized_context": { "available": true, שעות_כיסוי: 17.8, לפי_צד_24שעות: { לונג: 6100000.0, שורט: 2400000.0 } },
 methodology: { disclaimer: הערכה — לא ניתן לדעת מרווח לכל חשבון, cross לעומת isolated, הוספת מרווח, או ADL. }
}

הערה כנה: כל מספר מוקרן נגזר מקריאות DB אמיתיות; שום דבר לא מומצא במקרה של כשל. סמל שאינו במעקב, צילום מסך לא מעודכן, או מחיר חסר מחזירים ok: true, empty: true הודעה בפשטות, לא גרפים מזויפים. realized_context הוא מדגם צעיר וגדל מזרם החיסול הכפוי החי, שמוצג רק כהקשר — הוא לעולם לא הופך את ההקרנה ל"ממומשת".

GET /v1/wallet/{addr}/profile

זמין ל: Free לא נדרש אימות (מוגבל לפי IP)

פרופיל ארנק חוצת פלטפורמות בנוי לחלוטין מצילומי מצב חי של עמדות לווייתנים במעקב. עבור לווייתן במעקב ב-Hyperliquid, מחזיר את העמדות הפתוחות הנוכחיות, סדרת זמן של PnL לא ממומש / חשיפה / ספירת עמדות סדרת זמן, ציר זמן של פעילות OPEN/CLOSE/FLIP (ששוחזר על ידי השוואה בין צילומי מצב עוקבים), התווית המפוענחת מהלוח המובילים של HL, וסיכום ספר פתוח. עמוד חי: wallet-profiler.html.

פרמטרים

פרמטר	סוג	תיאור
addrנדרש	מחרוזת	כתובת ארנק (קטע נתיב), למשל `/v1/wallet/0x3bcae23e…/profile`.
ימיםאופציונלי	מספר שלם	חלון התבוננות אחורה עבור הסדרה ולוח הזמנים. ברירת מחדל: `30`.

בקשה לדוגמה

GET (ללא אימות)

curl https://api.smartmoneyapi.com/v1/wallet/0x3bcae23e8c380dab4732e9a159c0456f12d866f3/profile?days=30

תגובה לדוגמה

JSON

{
 אוקיי: True, ארנק: 0x3bcae23e…, מעקב: True,
 זמן_ראייה_ראשונה: 1782827733, זמן_צילום_אחרון: 1783418468, נכון ל: 1783418468,
 hyperliquid: {
 תווית: { שם: אנדרה חזר, ניקוד: 74,
 רווח_והפסד_חלון_בדולר: 1307000, אחוז_ניצחון: 71, עסקאות: 42 },
 פוזיציות: [
      { בורסה: hyperliquid, סמל: ETH, כיוון: short,
 גודל: 1200.0, מחיר_כניסה: 1800.0, רווח_והפסד_לא_ממומש: 34800.0,
 מינוף: 20.0, ערך_בדולר: 2160000.0 }
    ],
 סדרה: [ { תאריך: 1783330000, רווח_והפסד_לא_ממומש: 42000.0, חשיפה_בדולר: 18400000.0, פוזיציות: 5 } ],
 ציר_זמן: [ { תאריך: 1783400000, אירוע: היפוך, סמל: ETH,
 כיוון: short, מכיוון: long, ערך_בדולר: 2160000.0 } ],
 סיכום: {
 פוזיציות_פתוחות: 5, ברווח: 3, בהפסד: 2, longs: 0, shorts: 5,
 סה"כ_רווח_והפסד_לא_ממומש: -12000.0, סה"כ_חשיפה_בדולר: 21000000.0, מינוף_ממוצע: 19.9,
 חלון_ימים: 30, צילומים_בחלון: 474,
 רווח_והפסד_ממומש: None, הערה_על_רווח_והפסד_ממומש: לא ניתן לגזור — רואים רק צילומים פתוחים, לא מילויי סגירה.
    }
  }
}

הערה כנה: כל מה שמוצג הוא אמיתי מנתוני הצילומים — pnl זה סימון השוק הלא ממומש של HL עצמה, value_usd זה נומינלי פתוח. רווח והפסד ממומש לכל סבב אינו זמין (אנו רואים רק צילומים פתוחים, לא מילויי סגירה) ומוצג כ null / —; אירועי סגירה בציר הזמן אינם טוענים לרווח והפסד. כתובת תקפה אך לא מעקב מחזירה tracked: false עם הערה; כתובת לא תקפה מחזירה ok: false, error: "invalid_address" (HTTP 400). תווית הלוח המובילים של HL היא מיקום החלון של HL עצמה בזמן הגילוי, לא מחושב על ידינו.

GET /flows

דרישות: Pro

מחזיר נתוני זרימת הון בין-נכסים המציגים דפוסי רוטציה בין BTC, ETH ו-SOL במספר חלונות זמן. שימושי לזיהוי איזה נכס צובר הון ואיזה נכס מחולק בכל רגע נתון.

תגובה לדוגמה

JSON

{
 תאריך: 1710940821,
 זרימות: {
 BTC: { 1h: 142000000, 4h: 380000000, 12h: -90000000, 24h: 220000000 },
 ETH: { 1h: -38000000, 4h: -110000000, 12h: 55000000, 24h: -80000000 },
 SOL: { 1h: 12000000, 4h: 29000000, 12h: 18000000, 24h: 44000000 }
  },
 רוטציות_שזוהו: [
 הון מסתובב מ-ETH ל-BTC בחלון של 4 שעות,
 צבירת SOL עקבית בכל החלונות
  ]
}

נדרש תוכנית Pro. ערכי זרימה הם זרם הון נטו בדולר (חיובי) או יציאה (שלילי) לכל חלון זמן.

GET /whale-events

דרישות: Trader Pro

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

פרמטרים

פרמטר	סוג	תיאור
סמלאופציונלי	מחרוזת	סנן לפי נכס. השמט עבור כל הנכסים המנוטרים.
חשיבותאופציונלי	מחרוזת	סנן לפי חשיבות האירוע: `high`, `medium`, או `all`. ברירת מחדל: `all`
שעותאופציונלי	מספר שלם	חלון זמן רטרוספקטיבי בשעות. ברירת מחדל: `24`

תגובה לדוגמה

JSON

{
 סמל: BTC,
 סיכום: {
 היפוכים_ל-long: 3,
 היפוכים_ל-short: 1,
 פתיחות_חדשות: 7,
 סגירות: 2
  },
 אירועים: [
    {
 סוג: היפוך ללונג,
 ארנק: 0xWhale...a4f2,
 כיוון: לונג,
 גודל_בדולר: 4200000,
 חותמת זמן: 1710938400
    }
  ]
}

תוכנית סוחר: מחזיר את summary האובייקט בלבד. תוכנית פרומיום: הזנה events מלאה עם מזהה ארנק, גדלים וחותמות זמן.

GET /regimes/history

דרישה: פרומיום

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

פרמטרים

פרמטר	סוג	תיאור
symbolאופציונלי	string	סמל נכס. ברירת מחדל: `BTC`
regimeאופציונלי	string	סנן לסוג משטר ספציפי, למשל `late_cycle_divergence`. השאר ריק לכל המשטרים.
daysאופציונלי	integer	חלון הסתכלות אחורה בימים. ברירת מחדל: `30`. מקסימום: `365`

תגובה לדוגמה

JSON

{
 symbol: BTC,
 current_regime: late_cycle_divergence,
 regime_summary: {
 late_cycle_divergence: { occurrences: 4, avg_duration_h: 38, avg_return_pct: -2.1 },
 accumulation: { occurrences: 6, avg_duration_h: 72, avg_return_pct: 5.4 },
 breakout: { occurrences: 3, avg_duration_h: 18, avg_return_pct: 9.2 }
  },
 transitions: [
    { from: accumulation, to: breakout, ts: 1710850000 },
    { from: breakout, to: late_cycle_divergence, ts: 1710915000 }
  ]
}

נדרשת תוכנית פרומיום. שלב עם /analysis כדי לאמת הנחות אסטרטגיה מול נתוני ביצועי משטר היסטוריים.

GET /exchange-health

זמין עבור: חינם סוחר פרומיום

מחזיר סטטוס בריאות בזמן אמת לכל הבורסות המנוטרות כולל זמן תגובה לכל בורסה, שיעורי שגיאות ומדדי נתונים מיושנים. אין צורך באימות – נקודת קצה ציבורית.

תגובה לדוגמה

JSON

{
 overall_status: ok,
 ts: 1710940821,
 exchanges: {
 bybit: { status: ok, latency_ms: 42, error_rate_1h: 0.0, last_data_age_s: 18 },
 binance: { status: ok, latency_ms: 38, error_rate_1h: 0.0, last_data_age_s: 22 },
 hyperliquid: { status: degraded, latency_ms: 310, error_rate_1h: 0.04, last_data_age_s: 95 },
 okx: { status: ok, latency_ms: 55, error_rate_1h: 0.0, last_data_age_s: 30 }
  }
}

GET /sentiment

דרישה: סוחר פרומיום

מחזיר מדד פחד ותאוות בצע (0-100) המחושב בזמן אמת מסנטימנט נגזרים, פעילות לווייתנים, תנודתיות ואיתותים חברתיים. כולל פירוט רכיבים והיסטוריה של 24 שעות לניתוח מגמות.

פרמטרים

פרמטר	סוג	תיאור
symbolאופציונלי	string	סמל נכס. ברירת מחדל: `BTC`

תגובה לדוגמה

JSON

{
 "symbol": "BTC",
 "score": 72,
 "label": "Greed",
 "components": {
 "volatility": 65,
 "momentum": 78,
 "derivatives": 70,
 "whale_activity": 75,
 "social": 68
  },
 "history_24h": [
    { "ts": 1710940800, "score": 68, "label": "Greed" },
    { "ts": 1710937200, "score": 65, "label": "Greed" }
  ],
 "ts": 1710940821
}

מקבילה מתחרה: Santiment Social Volume + Alternative.me Fear & Greed — משולבים לנקודת קצה אחת עם פירוט רכיבים.

אינטגרציות

GET /tradingview/setup

דרישות: Trader Pro

מחזיר את הגדרת האינטגרציה האישית שלך ב-TradingView: כתובת Webhook, סוד לאימות, ואינדיקטורי Pine Script מוכנים לשימוש שמתחברים ישירות ל-Smart Money API. העתק-הדבק את ה-Pine Script ל-TradingView כדי להציג את האותות שלנו על כל גרף.

תגובה לדוגמה

JSON

{
 "webhook_url": "https://api.smartmoneyapi.com/v1/tradingview/webhook",
 "webhook_secret": "tvs_a1b2c3...",
 "pine_scripts": {
 "composite_indicator": "// Smart Money Composite v1\n//@version=5\nindicator(...)...",
 "whale_activity": "// Whale Activity Overlay v1\n...",
 "funding_dashboard": "// Funding Rate + LSR Dashboard v1\n..."
  }
}

POST /tradingview/webhook

זמין ל: Trader Pro

מקבל התראת TradingView, מעביר אותה דרך /confirm, ומחזיר את האישור. TradingView לא יכול לשלוח כותרות מותאמות אישית, אז בצע אימות על ידי הכללת ה-webhook שלך secret בגוף ה-JSON (נקודת קצה זו לא משתמשת ב-X-API-Key). התגובה עוטפת את האישור ומוסיפה ברמה העליונה action של CONFIRMED (ביטחון דימון HIGH/MEDIUM) או VETOED.

גוף בקשת

JSON

{
 "secret": "your_webhook_secret",
 "symbol": "BTC",
 "direction": "long",
 "timeframe": "1h",
 "strategy": "EMA crossover",
 "price": 67500.0
}

נדרש: secret, symbol, direction (long|short). אופציונלי: source, timeframe, strategy, price.

התאמה אישית

GET /preferences

דרישות: Trader Pro

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

PUT /v1/preferences

עדכן העדפות על ידי שליחת גוף JSON עם כל תת-קבוצה של השדות הבאים. שדות שלא נכללו נשמרים עם הערכים הנוכחיים שלהם.

שדות העדפה

שדה	סוג	תיאור
default_trade_size_usd	float	גודל פוזיציה ברירת מחדל בדולרים לחישובי Kelly ועצירות חכמות
risk_tolerance	string	`conservative`, `moderate`, או `aggressive`
default_risk_pct	float	סיכון ברירת מחדל למסחר כאחוז מהחשבון. משמש על ידי `/smart-stop` כאשר `risk_pct` חסר
watchlist	array	רשימה מסודרת של סמלי נכסים, למשל `["BTC","ETH","SOL"]`
notification_email	string	כתובת אימייל למשלוח התראות
timezone	string	מחרוזת אזור זמן IANA, למשל `America/New_York`

PUT — גוף לדוגמה

{
 "default_trade_size_usd": 5000,
 "risk_tolerance": "moderate",
 "default_risk_pct": 1.5,
 "watchlist": ["BTC", "ETH", "SOL"]
}

GET /watchlist

דרישות: סוחר מקצוען

מחזיר צילום מצב של אישור ומדדי סיכון מרכזיים עבור כל הסמלים ברשימת המעקב שלך. מספק סקירה רב-נכסית ללא צורך בקריאה /confirm נפרדת לכל סמל.

תגובה לדוגמה

JSON

{
 "ts": 1710940821,
 "watchlist": [
    {
 "symbol": "BTC",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "accumulation",
 "cascade_risk": "LOW"
    },
    {
 "symbol": "ETH",
 "confidence": "MEDIUM",
 "action": "REDUCE",
 "regime": "late_cycle_divergence",
 "cascade_risk": "HIGH"
    },
    {
 "symbol": "SOL",
 "confidence": "HIGH",
 "action": "CONFIRM",
 "regime": "breakout",
 "cascade_risk": "MEDIUM"
    }
  ]
}

שידור בזמן אמת (החלפות חיות)

שידור החלפות DEX ≥ $500 מזוהות בזמן אמת מהצמתים שלנו ב-BSC ו-Avalanche. שני ערוצי תקשורת זמינים: שידור Server-Sent Events (SSE) ציבורי עבור לקוחות חינמיים/דפדפן, ושידור WebSocket בעל זמן אפס נמוך עבור רמות בתשלום. אירועים משודרים תוך שניות מהכללה בבלוק.

שידור SSE ציבורי (חינם)

זמין עבור: חינם סוחר מקצוען

GET /v1/stream/public-swaps

לא נדרש אימות. תמיכה מקורית EventSource בכל הדפדפנים המודרניים. השרת משדר swap אירועים ודופק תקופתי כדי לשמור על החיבור פעיל.

JavaScript (דפדפן)

const es = new EventSource("https://api.smartmoneyapi.com/v1/stream/public-swaps");
es.addEventListener("swap", e => {
  const swap = JSON.parse(e.data);
  console.log(swap.chain, swap.pair, swap.amount_usd);
});

שידור WebSocket (בתשלום)

דרישות: סוחר מקצוען

WSS /v1/ws/live-swaps?ticket=…

אימות (מומלץ): לעולם אל תשים את המפתח ארוך הטווח שלך ב-URL — הוא נרשם על ידי פרוקסים ונשמר בהיסטוריית הדפדפן. במקום זאת, שלח את המפתח שלך ל- /v1/ws/ticket באמצעות ה- X-API-Key header הבטוח, ואז פתח את החיבור עם הכרטיס החד-פעמי שהוחזר ticket (תקף למשך ~60 שניות, נפדה פעם אחת). לקוחות בצד השרת שיכולים להגדיר headers יכולים במקום זאת להעביר X-API-Key ישירות ב-handshake. מפתחות ברמה חינמית מקבלים 402 payment_required תגובה. מסגרת hello נשלחת בעת החיבור עם הרמה שלך וסף השידור.

JavaScript (דפדפן)

// 1. החלף את המפתח שלך בכרטיס קצר טווח (המפתח נשאר ב-header)
const r = await fetch("https://api.smartmoneyapi.com/v1/ws/ticket", {
  method: "POST", headers: { "X-API-Key": "sm_xxx" }
});
const { ticket } = await r.json();
// 2. פתח את החיבור עם הכרטיס החד-פעמי
const ws = new WebSocket(`wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=${ticket}`);
ws.onmessage = e => {
  const swap = JSON.parse(e.data);
  if (swap.type === "swap") console.log(swap);
};

אימות WebSocket (כרטיסים)

למה: לעולם אל תשים את מפתח ה-API שלך ב-URL של WebSocket — מחרוזות שאילתה נרשמות על ידי פרוקסים, מאזני עומס ונשמרות בהיסטוריית הדפדפן. במקום זאת, החלף את המפתח שלך בכרטיס קצר טווח, חד-פעמי כרטיס באמצעות POST מאומת רגיל, ואז התחבר עם הכרטיס הזה.

זרימה: POST ל- /v1/ws/ticket עם ה- X-API-Key header שלך → קבל { "ticket": "…", "expires_in": 60 }. לאחר מכן פתח wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>. הכרטיס הוא חד-פעמי ומתוקף ל ~60 שניות. לקוחות צד-שרת שיכולים להגדיר כותרות בקשה יכולים להעביר במקום זאת X-API-Key ישירות בידshake של WebSocket — אין צורך בכרטיס.

POST /v1/ws/ticket

דרישות: Trader Pro

מייצר כרטיס חד-פעמי לידshake WebSocket מאומת. התחברות עם ה X-API-Key header (המפתח שלך לעולם לא עוזב את כותרות הבקשה). הכרטיס המוחזר ניתן לפדיון פעם אחת ב /v1/ws/live-swaps לפני שתוקפו פג.

cURL

curl -X POST -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/ws/ticket"

תגובה לדוגמה

JSON

{
 "ticket": "wst_9f3c1a8e4b2d…",
 "expires_in": 60
}

שדות תגובה

שדה	סוג	תיאור
ticket	string	אסימון חד-פעמי לצירוף כ `?ticket=` בכתובת ה-URL של WebSocket. ניתן לפדיון פעם אחת, לאחר מכן מבוטל.
expires_in	number	שניות עד לפקיעת תוקף הכרטיס (~60). יש לייצר כרטיס חדש לכל ניסיון חיבור.

הערה: האימות הישן באמצעות ?key= query-param הוא לא מתקבל יותר בנקודות קצה של WebSocket מסיבות אבטחה. השתמשו בכרטיס (לקוחות דפדפן) או ב X-API-Key handshake header (לקוחות צד-שרת).

צילום REST

GET /v1/live-swaps/recent?limit=20

מחזיר את N ההחלפות האחרונות שהופצו מהמאגר המתגלגל. שימושי להצגה ראשונית בלוחות מחוונים לפני פתיחת חיבור הזרם. זמין גם: /v1/live-swaps/status לסטטיסטיקות משדרים.

סכמת אירוע

שדה	סוג	תיאור
chain	string	`bsc` או `avalanche`
dex	string	שם הנתב (למשל `pancakeswap_v2`, `traderjoe`) או `unknown_dex`
swapper	string	כתובת 0x המלאה של הארנק שביצע את ההחלפה
swapper_short	string	צורה מקוצרת לתצוגה (למשל `0xb300…028d`)
swapper_url	string	קישור ישיר לסוואפר בבלוק אקספלורר של השרשרת
tx_hash	string	hash העסקה
explorer_url	string	קישור ישיר לעסקה ב-BscScan / Snowtrace
token_in	string	סמל האסימון שנמכר (למשל `USDT`)
token_out	string	סמל האסימון שנקנה
amount_usd	number	ערך ההחלפה בדולרים (מינימום: 500$)
pair	string	תווית זוג מעוצבת (למשל `USDT → USDC`)
block	number	מספר הבלוק שבו כרו את ההחלפה
timestamp	number	שניות epoch יוניקס
significance	string	`low` / `medium` / `high` / `critical` בהתבסס על גודל בדולרים
seq	number	מספר סידורי מונוטוני לשידור — משמש לגילוי פערים

POST /alerts/conditions

דרישות: Pro

צור כללי התרעה מותאמים אישית המופעלים כאשר מדד מסוים חוצה סף. התראות נשלחות דרך webhook, אימייל, או הזנת התראות בלוח המחוונים בהתאם להעדפותיך.

GET /v1/alerts/conditions

מחזיר רשימה של כל תנאי ההתרעה המוגדרים שלך עם ה-ID, ההגדרות והסטטוס הנוכחי שלהם.

DELETE /v1/alerts/conditions/{id}

מוחק לצמיתות תנאי התרעה לפי ה-ID שלו.

GET /v1/alerts/history

מחזיר אירועי הפעלת התראות אחרונים עם חותמות זמן, תנאים תואמים וערך המדד בזמן ההפעלה.

צור התרעה — גוף הבקשה

שדה	סוג	תיאור
namerequired	string	תווית קריאה אנושית להתראה זו (עד 64 תווים)
metricנדרש	string	המדד למעקב. ראה טבלת מדדים זמינים למטה.
symbolאופציונלי	string	הקשר נכס. נדרש עבור מדדים המוגבלים לסמל כגון `funding_rate`.
operatorנדרש	string	אופרטור השוואה: `gt`, `lt`, `eq`, `crosses_above`, `crosses_below`
thresholdנדרש	float	ערך מספרי להשוואה מול המדד
deliveryאופציונלי	string	ערוץ משלוח, למשל `telegram` (ברירת מחדל) או `webhook`
cooldown_minutesאופציונלי	integer	דקות מינימליות בין הפעלות חוזרות (ברירת מחדל 60)

הרשימה החיה של מדדים ואופרטורים תקפים מוחזרת על ידי GET /v1/alerts/conditions as available_metrics and available_operators.

מדדים זמינים

מדד	תיאור
funding_rate	שיעור המימון הנוכחי עבור סמל (כעשרוני)
global_lsr	יחס long/short גלובלי עבור סמל
long_pct	אחוז החשבונות עם עמדות long נטו עבור סמל
top_trader_lsr	יחס long/short של סוחרים מובילים עבור סמל
taker_ratio	יחס קניה/מכירה של takers עבור סמל
mvrv	יחס ערך שוק לערך ממומש (BTC/ETH)
sopr	יחס רווח פלט שהוצא (BTC/ETH)
exchange_net_flow	איתון זרימה נטו של בורסה בשרשרת
accumulation	איתון הצטברות בשרשרת
whale_long_pct	אחוז ארנקי הלווייתנים המעקבים עם עמדות long עבור סמל
whale_n_wallets	מספר ארנקי הלווייתנים המעקבים עם עמדה בסמל
composite_long	ציון מורכב עבור סמל שנבדק בכיוון long
composite_short	ציון מורכב עבור סמל שנבדק בכיוון short
funding_spread	פער מימון בין פלטפורמות עבור סמל

POST — גוף דוגמה

{
 "name": "BTC funding rate spike",
 "metric": "funding_rate",
 "symbol": "BTC",
 "operator": "gt",
 "threshold": 0.05
}

GET /kelly

דרישות: Pro

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

פרמטרים

פרמטר	סוג	תיאור
symbolנדרש	string	סמל נכס: `BTC`, `ETH`, או `SOL`
confidenceאופציונלי	string	רמת ביטחון האיתון למודל: `HIGH`, `MEDIUM`, או `LOW`. ברירת מחדל: `HIGH`
directionאופציונלי	string	כיוון מסחר: `long` או `short`. ברירת מחדל: `long`
account_sizeאופציונלי	float	גודל חשבון בדולרים לחישוב `suggested_size_usd`. ברירת מחדל: `10000`

תגובה לדוגמה

JSON

{
 "symbol": "BTC",
 "confidence": "HIGH",
 "direction": "long",
 "win_rate": 0.68,
 "avg_reward_risk_ratio": 2.1,
 "kelly_fraction": 0.36,
 "half_kelly": 0.18,
 "suggested_size_usd": 1800,
 "samples": 142,
 "note": "מומלץ Half-Kelly למסחר חי כדי להתחשב בשגיאות אומדן."
}

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

GET /performance

זמין ל: Free Trader Pro

מחזיר נתוני דיוק היסטוריים עבור אותות שהונפקו על ידי ה-API, מפולחים לפי רמת ביטחון. שימושי להבנת אמינות האותות לפני הקצאת הון.

פרמטרים

פרמטר	סוג	תיאור
symboloptional	string	סנן לפי נכס. השמט לסטטיסטיקות מצטברות עבור כל הסמלים.
daysoptional	integer	חלון הסתכלות לאחור בימים. ברירת מחדל: `30`

תגובה לדוגמה

JSON

{
 "symbol": "BTC",
 "period_days": 30,
 "by_confidence": {
 "HIGH": { "win_rate": 0.71, "samples": 58, "avg_return_pct": 3.4 },
 "MEDIUM": { "win_rate": 0.54, "samples": 84, "avg_return_pct": 1.2 }
  }
}

סטטיסטיקות ואותות

GET /v1/stats

זמין ל: Free Trader Pro לא נדרש אימות

סטטיסטיקות ביצועים כנים ברמת האתר המקורן מ- smart_money_confirm תוצאות קריאות נפרדות. מחזיר שיעורי הצלחה ברמות ביטחון HIGH ו-MEDIUM, דיוק כללי, גורם רווח, ופילוח לפי סמל. כל הנתונים הם בתוך המדגם במהלך חלון הדירוג; עיין ב- calibration.html להקשר ולמתודולוגיית החזקה קדימה.

תגובה לדוגמה

JSON

{
 "high_winrate": 0.714,
 "high_winrate_n": 14,
 "medium_winrate": 0.530,
 "medium_winrate_n": 34,
 "overall_accuracy": 0.613,
 "overall_accuracy_n": 48,
 "profit_factor": 1.77,
 "avg_win_pct": 4.2,
 "winrate_horizon": "24h",
 "winrate_basis": "distinct confirm calls, 24h resolved outcomes",
 "winrate_by_symbol": {
 "BTC": { "win_rate": 0.68, "n": 22 },
 "ETH": { "win_rate": 0.55, "n": 18 },
 "SOL": { "win_rate": 0.60, "n": 8 }
  },
 "forward_holdout": {
 "win_rate": 0.59,
 "high_win_rate": 0.70,
 "high_n": 10,
 "is_distinct_from_insample": false
  }
}

אזהרת מדגם פנימי. כל הנתונים בתגובה זו מחושבים מאותה תקופה בה נעשה שימוש לכיול המדרג. ה- forward_holdout object הוא המספר היחיד שנצבר על נתונים שהמדרג מעולם לא ראה — צפו בו גדל עם הזמן. ראה calibration.html למתודולוגיה המלאה ולגבול בין מדגם פנימי לבדיקה קדימה.

GET /v1/signals/performance

זמין ל: Free Trader Pro לא נדרש אימות

מעקב אחר תוצאות אותות לאורך מספר אופקי רזולוציה (4h, 12h, 24h, 72h). מחזיר שיעורי פגיעה לכל אופק, ספירת אותות כוללת, ופילוח לפי סוג אות.

פרמטרים

פרמטר	סוג	תיאור
daysoptional	integer	חלון הסתכלות לאחור בימים. ברירת מחדל: `30`
signal_typeoptional	string	סנן לפי סוג, למשל `smart_money_confirm` or `regime_flip`. השמט עבור כל הסוגים.
symboloptional	string	סנן לפי סמל נכס, למשל `BTC`. השמט לצבירה עבור כל הסמלים.

תגובה לדוגמה

JSON

{
 "signal_type": "smart_money_confirm",
 "symbol": "BTC",
 "days": 30,
 "total_signals": 48,
 אופקים: {
 4h: { שיעור פגיעה: 0.65, נפתר: 46 },
 12h: { שיעור פגיעה: 0.61, נפתר: 44 },
 24h: { שיעור פגיעה: 0.58, נפתר: 40 },
 72h: { שיעור פגיעה: 0.54, נפתר: 32 }
  },
 פירוט לפי סוג: {
 אישור כסף חכם: { מספר: 35, שיעור פגיעה_24h: 0.61 },
 היפוך משטר: { מספר: 13, שיעור פגיעה_24h: 0.47 }
  }
}

GET /v1/signals/recent

זמין ל: חינם סוחר Pro לא נדרש אימות

זרם של אותות HIGH ו-MEDIUM שפורסמו לאחרונה בכל הסמלים המנוטרים. כל ערך כולל את סוג האות, רמת הביטחון, הכיוון וסטטוס הפתרון אם זמין.

תגובה לדוגמה

JSON

{
 signals: [
    {
 id: 1042,
 symbol: BTC,
 direction: long,
 signal_type: smart_money_confirm,
 confidence: HIGH,
 composite: 0.74,
 ts: 1710940821,
 resolved: True,
 outcome_24h: win
    }
  ],
 count: 50
}

GET /v1/signals/{id}/outcome

זמין ל: חינם סוחר Pro לא נדרש אימות

תוצאה נפתרת עבור אות בודד לפי המזהה המספרי שלו. מחזור פגיעה/החטאה בכל אופק פתרון (4h, 12h, 24h, 72h) יחד עם המחיר בזמן האות ובזמן הפתרון.

פרמטרים

פרמטר	סוג	תיאור
idנדרש	מספר שלם	מזהה אות (קטע נתיב), למשל `/v1/signals/1042/outcome`

תגובה לדוגמה

JSON

{
 id: 1042,
 symbol: BTC,
 direction: long,
 confidence: HIGH,
 entry_price: 63200.0,
 ts: 1710940821,
 outcomes: {
 4h: { result: win, price: 64100.0, pct: 1.41 },
 12h: { result: win, price: 65200.0, pct: 3.16 },
 24h: { result: win, price: 65800.0, pct: 4.11 },
 72h: { result: pending, price: None, pct: None }
  }
}

GET /v1/confirm-winrate

נדרש: חינם סוחר Pro

פירוט שיעור הניצחון של אותות אישור עבור מפתח ה-API של המשתמש המאומת. מחזיר שיעורי ניצחון של קריאות נפרדות בכל רמת ביטחון, גורם רווח ונתונים לכל סמל. נדרש X-API-Key כותרת.

בקשה לדוגמה

cURL

curl -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm-winrate"

תגובה לדוגמה

JSON

{
 high_winrate: 0.714,
 high_n: 14,
 medium_winrate: 0.530,
 בינוני_n: 34,
 דיוק_כללי: 0.613,
 כללי_n: 48,
 גורם_רווח: 1.77,
 שיעור_ניצחון_אופק: 24h,
 לפי_סמל: {
 BTC: { שיעור_ניצחון: 0.68, n: 22 },
 ETH: { שיעור_ניצחון: 0.55, n: 18 }
  }
}

בסיס קריאה ייחודי. שיעורי ניצחון מחושבים לכל קריאת אישור ייחודית (אחת לכל סמל בכל חלון של 5 דקות), ולא לכל פניית API - זה מונע אינפלציית N מבוטים ששולחים בקשות חוזרות. הנתונים הם בתוך המדגם במהלך חלון ברירת המחדל של 30 יום; אותה אזהרה כמו ב /v1/stats חלה.

שער הצל

דרישות: חינם סוחר מקצועי

פנקס החלטות אישי בלתי ניתן לשינוי, שניתן רק להוספה. שלח את החלטות המסחר שלך לפני או אחרי ביצוען; המערכת מחשבת ציון אישור מול מנוע הכסף החכם ומוסיפה שורה קבועה. השתמש בזה כדי לבנות רישום זמן אמיתי וכנה של עד כמה האות של ה-API תאם את הכניסות שלך - לחלוטין נפרד ממאגר שיעורי הניצחון הגלובליים. תגובות ברמות חינם וסוחר מוסרות שדות ראיות; מקצועי מחזיר את הפירוט המלא. עיכוב רמה חל על נתוני רמת חינם.

POST /v1/shadow-gate/decisions

שלח החלטה. אידמפוטנטי על Idempotency-Key כותרת הבקשה - שליחה מחדש של אותו מפתח מחזירה את השורה הקיימת בלי ליצור כפיל. המערכת קוראת מייד למנוע האישור ומוסיפה את התוצאה כשורת פנקס בלתי ניתנת לשינוי.

גוף הבקשה

שדה	סוג	תיאור
symbolנדרש	string	סמל נכס, למשל `BTC`
sideנדרש	string	כיוון מסחר: `long` or `short`
strategy_idאופציונלי	string	תגית אסטרטגיה מוגדרת על ידי הקורא (מקסימום 64 תווים). נשמר כפי שהוא למיון וסינון.

בקשת דוגמה

cURL

curl -X POST \
 -H "X-API-Key: sm_your_key" \
 -H "Idempotency-Key: my-signal-20260701-001" \
 -H "Content-Type: application/json" \
 -d '{"symbol":"BTC","side":"long","strategy_id":"ema_crossover"}' \
 "https://api.smartmoneyapi.com/v1/shadow-gate/decisions"

תגובת דוגמה

JSON

{
 "id": 318,
 "symbol": "BTC",
 "side": "long",
 "strategy_id": "ema_crossover",
 "decision": "CONFIRM",
 "confidence": "HIGH",
 "composite": 0.74,
 "size_mult": 1.5,
 "ts": 1710940821,
 "resolved": false
}

הערת רמה. תגובות חינם וסוחר משמיטות את factors / adjustments שדות הראיות. מקצועי מחזיר את פירוט האישור המלא. עיכוב רמה חל על חינם - השורה נכתבת מייד אך ציון האישור עשוי לשקף נתונים במטמון בני עד 60 שניות.

GET /v1/shadow-gate/decisions

רשום את החלטות שער הצל שלך, החדשות ביותר ראשונות. מוגבל לבעלים - רק החלטות שנשלחו על ידי מפתח ה-API שלך מוחזרות.

פרמטרים

פרמטר	סוג	תיאור
limitאופציונלי	integer	מספר שורות מקסימלי להחזיר. ברירת מחדל: `50`, מקסימום: `200`
cursorאופציונלי	string	מצביע עמודים אטום מתגובה קודמת של `next_cursor` שדה. השמט לדף הראשון.

תגובת דוגמה

JSON

{
 "decisions": [
    { "id": 318, "symbol": "BTC", "side": "long", "decision": "CONFIRM", "confidence": "HIGH", "composite": 0.74, "size_mult": 1.5, "ts": 1710940821, "resolved": false },
    { "id": 317, "symbol": "ETH", "side": short, decision: SKIP, confidence: LOW, composite: -0.12, size_mult: 0.0, ts: 1710937000, resolved: True }
  ],
 count: 2,
 next_cursor: None
}

GET /v1/shadow-gate/decisions/{id}

החלטה בודדת לפי מזהה, כולל כל הראיות לאישור עבור רמת Pro. תגובות לרמות Free ו-Trader כוללות factors and adjustments stripped. Returns 403 if the decision belongs to a different API key.

Example Response (Pro)

JSON

{
 id: 318,
 symbol: BTC,
 side: long,
 strategy_id: ema_crossover,
 decision: CONFIRM,
 confidence: HIGH,
 composite: 0.74,
 size_mult: 1.5,
 factors: {
 derivatives: { score: 0.81, weight: 0.40, weighted: 0.324 },
 onchain: { score: 0.68, weight: 0.35, weighted: 0.238 },
 whale: { score: 0.73, weight: 0.25, weighted: 0.183 }
  },
 ts: 1710940821,
 resolved: False,
 outcome: None
}

POST /v1/shadow-gate/decisions/{id}/resolve

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

Request Body

Field	Type	Description
outcomerequired	string	Trade outcome: `win` or `loss`
exit_priceoptional	float	Exit price for the trade. Stored for reference; used to compute P&L % if provided.
pnl_pctoptional	float	Realized P&L as a percentage of position size, e.g. `3.5` or `-1.2`

Example Response

JSON

{
 id: 318,
 resolved: True,
 outcome: win,
 exit_price: 65800.0,
 pnl_pct: 4.1,
 resolved_at: 1711027200
}

Immutability. The ledger row is append-only. Once a decision is submitted it cannot be deleted, and once resolved it cannot be re-resolved. This ensures the track record you build is honest and tamper-evident.

Error Codes

Status	Code	Description
400	invalid_params	Missing or invalid query parameters
401	unauthorized	Missing or invalid API key
403	plan_restriction	Endpoint not available on your current plan
429	rate_limit_exceeded	Daily or burst limit reached
500	internal_error	Server error — check /health for source status
503	data_stale	Data source unavailable; returned with last known data

Code Examples

Python

import requests

r = requests.get(
 https://api.smartmoneyapi.com/v1/confirm,
  params={symbol: BTC, direction: long},
  headers={X-API-Key: sm_your_key}
)
data = r.json()

print(data["confidence"])  # HIGH / MEDIUM
print(data["size_mult"]) # 1.5 / 1.0

Python

import requests

API_KEY = "sm_your_key"
BASE_URL = "https://api.smartmoneyapi.com/v1"

def confirm_trade(symbol, direction):
  resp = requests.get(
    f"{BASE_URL}/confirm",
    params={"symbol": symbol, "direction": direction},
    headers={"X-API-Key": API_KEY},
    timeout=5
  )
  resp.raise_for_status()
 return resp.json()

# In your trading loop:
signal = confirm_trade("BTC", "long")
if signal["confidence"] not in ["HIGH", "MEDIUM"]:
 print("דילוג — ביטחון לא מספיק")
else:
  size = base_size * signal["size_mult"]
 place_order(symbol, direction, size)

JavaScript / Node.js

JavaScript

const API_KEY = 'sm_your_key';

async function confirmTrade(symbol, direction) {
 const params = new URLSearchParams({ symbol, direction });
 const res = await fetch(
    `https://api.smartmoneyapi.com/v1/confirm?${params}`,
    { headers: { 'X-API-Key': API_KEY } }
  );
 if (!resok) throw new Error(`API error: ${resstatus}`);
 return res.json();
}

// Usage
confirmTrade('BTC', 'long').then(data => {
  console.log(dataconfidence, datasize_mult);
});

cURL

Shell

# Confirm a long trade
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/confirm?symbol=BTC&direction=long"

# Get whale data
curl -X GET \
  -H "X-API-Key: sm_your_key" \
 "https://api.smartmoneyapi.com/v1/whales?symbol=BTC"

# Check usage
curl -X GET \
  -H X-API-Key: sm_your_key \
 https://api.smartmoneyapi.com/v1/usage

אינטגרציה של Freqtrade

הוסף אישור Smart Money לכל אסטרטגיית Freqtrade על ידי דריסת ה confirm_trade_entry מתודה.

Python — אסטרטגיית Freqtrade

import requests
from freqtrade.strategy import IStrategy

class SmartMoneyStrategy(IStrategy):
  SM_API_KEY = "sm_your_key"
  SM_BASE = "https://api.smartmoneyapi.com/v1"

 def confirm_trade_entry(self, pair, order_type,
                         amount, rate, time_in_force,
                         current_time, entry_tag, **kwargs):
    symbol = pair.split("/")[0]
 if symbol not in ["BTC", "ETH", "SOL"]:
 return True # דלג על בדיקה עבור לא נתמך
 try:
      r = requests.get(
        f"{self.SM_BASE}/confirm",
        params={"symbol": symbol, "direction": "long"},
        headers={"X-API-Key": self.SM_API_KEY},
        timeout=3
      ).json()
 return r.get("confidence") in ["HIGH", "MEDIUM"]
 except:
 return True # כשל פתוח בשגיאת API

CCXT + Smart Money

Python — CCXT

import ccxt, requests

exchange = ccxt.bybit({
 "apiKey": "YOUR_BYBIT_KEY",
 "secret": "YOUR_BYBIT_SECRET"
})

SM_KEY = "sm_your_key"

def smart_trade(symbol, side, amount):
 # בדוק אישור תחילה
  conf = requests.get(
 "https://api.smartmoneyapi.com/v1/confirm",
    params={"symbol": symbol, "direction": side},
    headers={"X-API-Key": SM_KEY}
  ).json()

 if conf["confidence"] not in ["HIGH", "MEDIUM"]:
 print(f"Skipping {symbol} {side} — insufficient confidence.")
 return None

  adj_amount = amount * conf["size_mult"]
  order = exchange.create_market_order(
    f"{symbol}/USDT", side, adj_amount
  )
 print(f"Order placed: {adj_amount} {symbol} {side}")
 return order

צריך עזרה?

בדוק את דף סטטוס ה-API למידע בריאות בזמן אמת, או השתמש ב טופס יצירת קשר.