הפניה מלאה ל-REST API

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

סקירה כללית

Smart Money API מספק גישה RESTful לנתוני נגזרים של קריפטו בזמן אמת בשלוש בורסות מרכזיות: Bybit, Binance, ו-Hyperliquid. ה-API שלנו מאגד פוזיציות של ארנקי לווייתנים, שיעורי מימון, מדדי ריבית פתוחה, נתוני נזילות ואותות על השרשרת לממשק מאוחד אחד. בין אם אתה בונה אלגוריתמי מסחר, מערכות ניהול סיכונים או כלי ניתוח שוק, ה-REST API נותן לך גישה תוכניתית ישירה לכל המודיעין של Smart Money.

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

כל הבקשות חייבות לכלול פרטי אימות תקפים. משתמשים בחינם מקבלים 20 בקשות ביום המוגבלות ל-BTC. משתמשים בדרגת סוחר (400 בקשות/יום) ודרגת מקצוען (4,000 בקשות/יום) מקבלים גישה לכל הסמלים ותכונות מתקדמות.

אימות

Smart Money API משתמש באימות מפתח API. השיטה העיקרית היא X-API-Key כותרת הבקשה. אתה יכול ליצור מפתחות API מהלוח שלך. JWT של סשן דרך Authorization: Bearer מתקבל כגיבוי לסשנים של דפדפן/לוח, אך לקוחות API צריכים להשתמש ב X-API-Key.

אימות מפתח API (ראשי)

שלח את מפתח ה-API שלך ב X-API-Key כותרת בכל בקשה. לעולם אל תשים את המפתח שלך ב-URL.

HTTP

GET /v1/whales/events HTTP/1.1
Host: api.smartmoneyapi.com
X-API-Key: sm_your_key
Content-Type: application/json

JWT סשן (גיבוי)

סשנים של דפדפן/לוח יכולים להעביר JWT של סשן דרך Authorization: Bearer (תקף ל-24 שעות). לקוחות תוכניתיים צריכים להעדיף X-API-Key.

Python

import requests
import json

# קבל אסימון JWT
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# השתמש ב-JWT לבקשות הבאות
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

כתובת בסיס ונקודות קצה

כל בקשות ה-API נשלחות ל https://api.smartmoneyapi.com. ה-API מאורגן לקטגוריות משאבים לוגיות עם קידומת גרסה. הגרסה היציבה הנוכחית היא v1.

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

כתובת WebSocket: wss://ws.smartmoneyapi.com/stream

פורמט תגובה

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

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [
      {
        "wallet_address": "0x1234...",
        "symbol": "BTCUSDT",
        "position_size": 15.5,
        "entry_price": 42150.0,
        "current_price": 43200.5,
        "pnl": 16577.75,
        "pnl_percent": 3.91,
        "leverage": 5,
        "funding_rate": 0.00012,
        "last_updated": "2026-03-21T14:30:45Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total_pages": 1
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

נקודת קצה לפוזיציות לווייתנים

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

GET /v1/whales/events PRO

פרמטר	סוג	תיאור
symbol	string	צמד מסחר (למשל, BTCUSDT, ETHUSDT) אופציונלי
exchange	string	סנן לפי בורסה: bybit, binance, hyperliquid אופציונלי
min_position_size	number	גודל פוזיציה מינימלי בנכס הבסיס אופציונלי
direction	string	פוזיציות long או short בלבד אופציונלי
page	integer	מספר עמוד לסימון עמודים, ברירת מחדל 1 אופציונלי
limit	integer	תוצאות לעמוד, מקסימום 100, ברירת מחדל 50 אופציונלי

דוגמת בקשה:

cURL

curl -X GET "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&min_position_size=10&limit=25" \
  -H "X-API-Key: sm_your_key" \
  -H "Content-Type: application/json"

נקודת קצה לשיעורי מימון

גש לשיעורי מימון בזמן אמת והיסטוריים ב-Bybit, Binance, ו-Hyperliquid. שיעורי מימון קריטיים למסחר ארביטראז', אסטרטגיות swing וגידור נגזרים. ה-API שלנו מאגד שיעורים עם דיוק של 15 דקות ומספק ניתוח שיעורים היסטורי.

GET /v1/funding-rates FREE

פרמטר	סוג	תיאור
symbol	string	צמד מסחר (למשל, BTCUSDT) נדרש
exchange	string	בורסה: bybit, binance, hyperliquid אופציונלי
interval	string	1h, 4h, 1d, ברירת מחדל 1h אופציונלי
limit	integer	תקופות היסטוריות להחזרה, מקסימום 500 אופציונלי

דוגמת בקשה:

JavaScript

const fetchFundingRates = async () => {
  const response = await fetch(
    "https://api.smartmoneyapi.com/v1/funding-rates?symbol=BTCUSDT&interval=4h&limit=100",
    {
      headers: {
        "X-API-Key": "sm_your_key",
        "Content-Type": "application/json"
      }
    }
  );
  const data = await response.json();
  console.log(data);
};
fetchFundingRates();

נקודת קצה של עניין פתוח

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

GET /v1/open-interest סוחר

פרמטר	סוג	תיאור
symbol	string	צמד מסחר נדרש
exchange	string	bybit, binance, או hyperliquid אופציונלי
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, ברירת מחדל 15m אופציונלי

נקודת קצה של נזילות

מחזיר שתי נקודות מבט משלימות עבור סמל: רמות מוקרנות ממונפות רמות (הערכה של היכן נמצאים אשכולות נזילות) ו realized_heatmap — עוצמת הנזילות המבוצעת בפועל (מחיר × זמן) המצטברת בזמן אמת מפידים ציבוריים של בורסות: Binance, OKX, Bybit, Bitget, ו-BitMEX. מפת החום מוצגת כאשר יש נתונים עבור הסמל.

GET /v1/liquidations סוחר

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

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

נזילות DeFi על השרשרת

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

GET /v1/liquidations/onchain סוחר

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

נקודת קצה של אישור

ה /v1/confirm נקודת קצה מחזירה ציון מבוסס כללים, רב-גורמי confluence המשלב נגזרים, על השרשרת (Coin Metrics חינם: MVRV / זרימות בורסה / כתובות פעילות), ומיקומי לווייתנים. ה composite נע בין -1.0 ל-+1.0 (לא 0–100) וכל תגובה כוללת פירוט שקוף של factors (ציון לכל גורם × משקל), adjustments, משקלים, ו coverage. זהו תמיכה בהחלטה, לא הבטחה לשיעור זכייה. סמל שלא נמצא במעקב יחזיר תוצאה מפורשת של NO_DATA / לא נתמך במקום תוצאה מזויפת של LOW.

GET /v1/confirm סוחר

פרמטרים: symbol (BTC/ETH/SOL) ו direction (long/short). confidence הוא אחד מ-HIGH / MEDIUM / LOW / VETO / NO_DATA; action הוא אחד מ-CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult הוא מכפיל גודל המיקום המוצע.

נקודות קצה של נתונים על השרשרת

גש למדדים על השרשרת של Bitcoin ו-Ethereum כולל זרימות בורסה, תנועות ארנקים של לווייתנים, יחס MVRV, NUPL, תנאי הוצאה, ותנודתיות מבוצעת. מדדים אלה מזהה מחזורי הצטברות/פיזור ומספקים אותות מוקדמים להיפוכים גדולים.

GET /v1/on-chain/metrics PRO

פרמטר	סוג	תיאור
asset	string	bitcoin או ethereum נדרש
metrics	array	מדדים ספציפיים: exchange_flows, mvrv, nupl, whale_moves אופציונלי
interval	string	1d (יומי), 1w (שבועי), ברירת מחדל 1d אופציונלי

הפניית מודלי נתונים

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

אובייקט WhalePosition

JSON

{
  "id": "pos_1a2b3c4d5e6f7g8h",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "exchange": "bybit",
  "symbol": "BTCUSDT",
  "position_type": "long",
  "position_size": 15.5,
  "entry_price": 42150.0,
  "current_price": 43200.5,
  "pnl": 16577.75,
  "pnl_percent": 3.91,
  "leverage": 5,
  "margin_balance": 129000.0,
  "used_margin": 126225.0,
  "available_margin": 2775.0,
  "liquidation_price": 34560.0,
  "funding_rate": 0.00012,
  "time_opened": "2026-03-15T08:30:00Z",
  "last_updated": "2026-03-21T14:30:45Z"
}

אובייקט FundingRateRecord

JSON

{
  "timestamp": "2026-03-21T14:00:00Z",
  "symbol": "BTCUSDT",
  "bybit": {
    "funding_rate": 0.00012,
    "next_rate": 0.00015
  },
  "binance": {
    "funding_rate": 0.00010,
    "next_rate": 0.00013
  },
  "hyperliquid": {
    "funding_rate": 0.00014,
    "next_rate": 0.00016
  },
  "aggregated": {
    "mean": 0.000120,
    "median": 0.000120,
    "spread": 0.000060
  }
}

דוגמאות קוד

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

ניטור תנועות לווייתנים ב-Python

Python

import requests
import time
from typing import List, Dict

class SmartMoneyClient:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.smartmoneyapi.com/api/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def get_whale_positions(self, symbol: str = None) -> Dict:
        """אחזור תנועות לווייתנים עם אפשרות לסינון לפי סמל"""
        params = {}
        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            f"{self.base_url}/whales/events",
            headers=self.headers,
            params=params
        )
        return response.json()

    def get_funding_rates(self, symbol: str) -> Dict:
        """קבלת שיעורי מימון נוכחיים והיסטוריים"""
        response = requests.get(
            f"{self.base_url}/funding-rates",
            headers=self.headers,
            params={"symbol": symbol, "limit": 100}
        )
        return response.json()

    def monitor_whale_activity(self, symbol: str, interval_seconds: int = 60):
        """ניטור רציף של תנועות לווייתנים"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Whale {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Usage
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Total whale positions: {whales['data']['total']}")

שיטות עבודה מומלצות וטיפים לביצועים

השתמשו בניווט עמודים: תמיד השתמשו בניווט עמודים עבור תוצאות גדולות. השתמשו בפרמטרים limit ו-page כדי לאחזר נתונים בחבילות של 50-100 רשומות, לא את כל הנתונים בבת אחת.

שמרו מטמון לתגובות: תנועות לווייתנים לא משתנות כל שנייה. שמרו תוצאות במטמון למשך 30-60 שניות כדי להפחית קריאות API ולשפר ביצועים.

סננו מוקדם: השתמשו בפרמטרי שאילתה (symbol, exchange, direction) כדי לסנן נתונים בצד השרת, לא בקוד היישום שלכם.

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

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

אמתו חותמות זמן: כל חותמות הזמן הן בפורמט ISO 8601 UTC. תמיד המירו לאזור הזמן המקומי שלכם לתצוגה ותמיד שמרו ב-UTC.

תמודדו עם ניתוקים: יישמו לוגיקה של חיבור אוטומטי מחדש עם השהייה מעריכית עבור חיבורי WebSocket.

עקבו אחר המכסה שלכם: בדקו את כותרת X-Requests-Remaining בתגובות. תכננו את השימוש ב-API כך שתישארו במגבלות הרמה שלכם.

תבניות אינטגרציה נפוצות

תבנית 1: התראת הצטברות לווייתנים

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

תבנית 2: זיהוי ארביטראז' בשיעורי מימון

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

תבנית 3: ניטור שרשרת נזילות

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

תבנית 4: אישור רב-אותות

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

מוכנים להתחיל?

קבלו את מפתח ה-API שלכם מהקונסול והתחילו לבנות היום. כל החשבונות החדשים מקבלים גישה חינמית עם 20 בקשות ליום (BTC, ETH, SOL). שדרגו ל-Trader או Pro כדי לקבל גישה בלתי מוגבלת לכל הסמלים ולתכונות מתקדמות.

קבלו מפתח API

פתחו תכונות Pro

קבלו גישה מלאה לתנועות לווייתנים, ציוני אישור, נתוני on-chain ו-2000+ בקשות API יומיות.

צפו במחירים