מודלי נתונים ומבנה סכמה
הפניה מלאה למודלי הנתונים של Smart Money API. למד את המבנה והגדרות השדות עבור כל אובייקטי התגובה כולל פוזיציות לווייתן, שיעורי מימון, נזילות וציון אישור מבוסס AI.
סקירה כללית
הבנת מבני תגובת API חיונית לבניית אינטגרציות. הפניה זו מתעדת את כל הגדרות מודל הנתונים, סוגי שדות, מגבלות ודוגמאות. כל חותמי הזמן בפורמט ISO 8601 UTC. כל המחירים והסכומים מוחזרים כמחרוזות כדי למנוע אובדן דיוק בנקודה צפה.
אובייקט פוזיציית לווייתן
מייצג פוזיציה גדולה המוחזקת על ידי ארנק לווייתן מנוטר בבורסת מסחר ממונף.
| שדה | סוג | תיאור |
|---|---|---|
| id | string | מזהה פוזיציה ייחודי |
| wallet_address | string | כתובת ארנק לווייתן (פורמט 0x...) |
| exchange | string | bybit, binance, או hyperliquid |
| symbol | string | צמד מסחר (BTCUSDT, ETHUSDT וכו') |
| position_type | string | long או short |
| position_size | string | גודל בנכס הבסיס (למשל, BTC) |
| entry_price | string | מחיר כניסה ממוצע ב-USDT |
| current_price | string | מחיר סימון נוכחי ב-USDT |
| liquidation_price | string | מחיר בו הפוזיציה תינזל |
| pnl | string | רווח והפסד לא ממומש ב-USDT |
| pnl_percent | number | רווח והפסד לא ממומש באחוזים |
| leverage | integer | מכפיל מינוף (1-20x) |
| margin_balance | string | יתרת מרווח כוללת ב-USDT |
| used_margin | string | מרווח בשימוש ב-USDT |
| available_margin | string | מרווח זמין ב-USDT |
| margin_ratio | number | יחס מרווח זמין / מרווח בשימוש |
| funding_rate | string | שיעור מימון נוכחי (% שעתי) |
| time_opened | string | חותם זמן ISO 8601 של פתיחה |
| last_updated | string | חותם זמן ISO 8601 של עדכון אחרון |
דוגמת פוזיציית לווייתן
JSON
{
"id": "pos_1a2b3c4d5e6f7g8h",
"wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
"exchange": "bybit",
"symbol": "BTCUSDT",
"position_type": "long",
"position_size": "15.5",
"entry_price": "42150.00",
"current_price": "43200.50",
"liquidation_price": "34560.00",
"pnl": "16577.75",
"pnl_percent": 3.91,
"leverage": 5,
"margin_balance": "129000.00",
"used_margin": "126225.00",
"available_margin": "2775.00",
"margin_ratio": 0.022,
"funding_rate": "0.00012",
"time_opened": "2026-03-15T08:30:00Z",
"last_updated": "2026-03-21T14:35:45Z"
}
אובייקט שיעור מימון
מייצג שיעורי מימון במספר בורסות עבור סמל יחיד ותקופת זמן.
JSON
{
"timestamp": "2026-03-21T14:00:00Z",
"symbol": "BTCUSDT",
"bybit": {
"rate": "0.000120",
"next_funding_time": "2026-03-21T16:00:00Z",
"next_rate": "0.000145"
},
"binance": {
"rate": "0.000098",
"next_funding_time": "2026-03-21T16:00:00Z",
"next_rate": "0.000115"
},
"hyperliquid": {
"rate": "0.000140",
"next_funding_time": "2026-03-21T16:00:00Z",
"next_rate": "0.000160"
},
"aggregated": {
"mean": "0.000119",
"median": "0.000120",
"highest": "0.000160",
"lowest": "0.000098",
"spread": "0.000062"
}
}
אובייקט נזילות
מייצג נזילה כפויה של פוזיציה ממונפת.
JSON
{
"id": "liq_1a2b3c4d5e6f7g8h",
"exchange": "binance",
"symbol": "BTCUSDT",
"direction": "long",
"position_size": "12.5",
"liquidation_price": "41000.00",
"size_usd": "512500.00",
"timestamp": "2026-03-21T14:35:12Z"
}
אובייקט ריבית פתוחה
מייצג ריבית פתוחה מצטברת עבור כל הסוחרים הממונפים.
JSON
{
"symbol": "BTCUSDT",
"timestamp": "2026-03-21T14:00:00Z",
"total_oi_usd": "12456000000.00",
"long_oi_usd": "7234000000.00",
"short_oi_usd": "5222000000.00",
"long_short_ratio": 1.385,
"oi_change_percent": 2.34,
"exchanges": {
"bybit": {
"long": "3456000000.00",
"short": "2123000000.00"
},
"binance": {
"long": "2567000000.00",
"short": "2234000000.00"
},
"hyperliquid": {
"long": "1211000000.00",
"short": "865000000.00"
}
}
}
אובייקט ציון אישור
אות מסחר שנוצר על ידי AI המשולב פוזיציות לווייתן, נתונים על-שרשרתיים, שיעורי מימון וסנטימנט שוק.
JSON
{
"symbol": "BTCUSDT",
"overall_score": 78,
"signal": "bullish",
"confidence": 0.85,
"timestamp": "2026-03-21T14:30:00Z",
"components": {
"whale_score": 82,
"on_chain_score": 75,
"funding_score": 68,
"liquidation_score": 72,
"sentiment_score": 85
},
"reasoning": "צבירת לווייתן גדולה עם אותות חיוביים על-שרשרתיים",
"next_update": "2026-03-21T14:45:00Z"
}
אובייקט מדדים על-שרשרתיים
אנליטיקת על-שרשרת עבור ביטקוין ואיתריום.
JSON
{
"asset": "bitcoin",
"timestamp": "2026-03-21T00:00:00Z",
"exchange_flow": {
"inflow_btc": "245.67",
"outflow_btc": "812.34",
"net_flow_btc": "-566.67"
},
"whale_wallets": {
"count": 412,
"total_btc": "1243567.89",
"change_24h": 15.23
},
"mvrv_ratio": 1.42,
"nupl": 0.68,
"realized_price": "42156.50"
}
אובייקט תגובת שגיאה
פורמט תגובת שגיאה סטנדרטי לכל נקודות הקצה.
JSON
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "אימות בקשת נכשל",
"details": [
{
"field": "symbol",
"error": "פורמט צמד מסחר לא תקין"
}
],
"resolution": "השתמש בפורמט כמו BTCUSDT"
},
"timestamp": "2026-03-21T14:35:22Z"
}