مرجع کامل REST API

با استفاده از مرجع جامع REST ما، Smart Money API را به طور کامل بیاموزید. تمامی نقاط پایانی، پارامترها، روش‌های احراز هویت و الگوهای یکپارچه‌سازی دنیای واقعی برای اطلاعات مشتقات رمزنگاری و داده‌های ردیابی وال را بیاموزید.

مرور کلی

Smart Money API دسترسی RESTful به داده‌های مشتقات رمزنگاری در زمان واقعی در سه صرافی بزرگ: Bybit، Binance و Hyperliquid را فراهم می‌کند. API ما موقعیت‌های کیف‌پول وال، نرخ‌های تأمین مالی، معیارهای علاقه‌مندی باز، داده‌های تصفیه و سیگنال‌های زنجیره‌ای را در یک رابط یکپارچه جمع‌آوری می‌کند. چه در حال ساخت الگوریتم‌های معاملاتی، سیستم‌های مدیریت ریسک یا ابزارهای تحلیل بازار باشید، REST API دسترسی برنامه‌نویسی مستقیم به تمام اطلاعات Smart Money را به شما می‌دهد.

با بیش از ۲۲۹ نماد معاملاتی کشف شده به صورت خودکار و بیش از ۶۰۰ کیف‌پول وال تحت نظارت، API اطلاعات جامع بازار را فراهم می‌کند. اتصالات WebSocket در زمان واقعی به‌روزرسانی‌های زیر ثانیه ارائه می‌دهند، در حالی که نقاط پایانی REST ما پرس‌وجوهای دسته‌ای، بازیابی داده‌های تاریخی و تحلیل پرتفوی در مقیاس بزرگ را مدیریت می‌کنند.

تمام درخواست‌ها باید شامل اعتبارنامه‌های احراز هویت معتبر باشند. کاربران رایگان محدود به ۲۰ درخواست در روز برای BTC هستند. سطح Trader (۴۰۰ درخواست در روز) و سطح Pro (۴۰۰۰ درخواست در روز) تمام نمادها و ویژگی‌های پیشرفته را باز می‌کنند.

احراز هویت

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 (معتبر برای ۲۴ ساعت) ارسال کنند. مشتریان برنامه‌نویسی باید ترجیح دهند X-API-Key.

پایتون

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

URL پایه و نقاط پایانی

تمام درخواست‌های API به https://api.smartmoneyapi.comارسال می‌شوند. API به دسته‌های منطقی منابع با پیشوندهای نسخه سازماندهی شده است. نسخه پایدار فعلی v1.

URL پایه: https://api.smartmoneyapi.com/api/v1

URL 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"
}

نقطه پایانی موقعیت‌های وال

موقعیت‌های دقیق از کیف‌پول‌های وال تحت نظارت در تمام صرافی‌ها را بازیابی کنید. این نقطه پایانی اهرم در زمان واقعی، قیمت‌های ورود، قیمت‌های تصفیه و سود و زیان تحقق نیافته برای موقعیت‌های با ارزش بالا را نشان می‌دهد.

GET /v1/whales/events PRO

پارامتر	نوع	توضیحات
symbol	string	جفت معاملاتی (مثلاً BTCUSDT, ETHUSDT) optional
exchange	string	فیلتر بر اساس صرافی: bybit, binance, hyperliquid optional
min_position_size	number	حداقل اندازه موقعیت در دارایی پایه optional
direction	string	فقط موقعیت‌های long یا short optional
page	integer	شماره صفحه صفحه‌بندی، پیش‌فرض 1 optional
limit	integer	نتایج در هر صفحه، حداکثر 100، پیش‌فرض 50 optional

مثال درخواست:

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 دسترسی پیدا کنید. نرخ‌های تأمین مالی برای معاملات آربیتراژ، استراتژی‌های نوسانی و پوشش ریسک مشتقات حیاتی هستند. API ما نرخ‌ها را با دقت ۱۵ دقیقه جمع‌آوری می‌کند و تحلیل نرخ‌های تاریخی را ارائه می‌دهد.

GET /v1/funding-rates FREE

پارامتر	نوع	توضیحات
symbol	string	جفت معاملاتی (مثلاً BTCUSDT) required
exchange	string	صرافی: bybit, binance, hyperliquid optional
interval	string	1h, 4h, 1d, پیش‌فرض 1h optional
limit	integer	دوره‌های تاریخی برای بازگشت، حداکثر 500 optional

مثال درخواست:

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 TRADER

پارامتر	نوع	توضیحات
symbol	string	جفت معاملاتی required
exchange	string	bybit, binance, or hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, default 15m optional

نقطۀ پایانی تسویه‌ها

دو دیدگاه مکمل برای یک نماد برمی‌گرداند: اهرم‌پیش‌بینیشده سطوح (تخمینی از محل تجمع تسویه‌ها) و یک realized_heatmap — شدت تسویه‌های اجباری اجراشده (قیمت × زمان) که به‌صورت زنده از فیدهای WebSocket صرافی‌های عمومی جمع‌آوری شده‌اند: Binance, OKX, Bybit, Bitget, و BitMEX. نقشۀ حرارتی زمانی نمایش داده می‌شود که داده‌هایی برای نماد وجود داشته باشد.

GET /v1/liquidations TRADER

پارامتر	نوع	توضیحات
symbol	string	نماد دارایی، پیش‌فرض BTC optional

Trader خطر آبشاری، نزدیک‌ترین فاصله‌ها و مجموع/براساس طرف را برمی‌گرداند. 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 TRADER

پارامتر	نوع	توضیحات
chain	string	bsc یا avax؛ برای همه خالی بگذارید optional
limit	integer	حداکثر سطرها، پیش‌فرض 100، حداکثر 500 (جدیدترین اول) optional

نقطۀ پایانی تأیید

نقطۀ پایانی /v1/confirm یک امتیاز ترکیبی مبتنی بر قواعد و چندعاملی confluence را برمی‌گرداند که مشتقات، داده‌های زنجیره‌ای (رایگان Coin Metrics: MVRV / جریان صرافی / آدرس‌های فعال) و موقعیت‌‌های نهنگ‌ها را ترکیب می‌کند. امتیاز composite از -1.0 تا +1.0 متغیر است (نه 0–100) و هر پاسخ شامل یک تجزیه شفاف factors (امتیاز هر جزء × وزن)، adjustments, وزن‌هاو coverageمی‌شود. این یک پشتیبانی تصمیم‌گیری است، نه یک نرخ برد تضمینی. یک نماد ردیابی‌نشده به جای یک مقدار جعلی LOW، یک نتیجه صریح NO_DATA / پشتیبانی‌نشده برمی‌گرداند.

GET /v1/confirm TRADER

پارامترها: 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 ضریب پیشنهادی اندازه موقعیت است.

نقاط پایانی داده‌های زنجیره‌ای

به معیارهای زنجیره‌ای بیت‌کوین و اتریوم از جمله جریان‌های صرافی، حرکات کیف‌پول‌های نهنگ‌ها، نسبت MVRV، NUPL، شرایط خرج و نوسان تحقق‌یافته دسترسی پیدا کنید. این معیارها چرخه‌های تجمع/توزیع را شناسایی کرده و سیگنال‌های اولیه برای معکوس‌شدن‌های بزرگ ارائه می‌دهند.

GET /v1/on-chain/metrics PRO

پارامتر	نوع	توضیحات
asset	string	bitcoin یا ethereum required
metrics	array	معیارهای خاص: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (روزانه), 1w (هفتگی), پیش‌فرض 1d optional

مرجع مدل‌های داده

درک ساختار پاسخ‌های 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
  }
}

نمونه کدها

در زیر نمونه‌های کد آماده برای تولید با الگوهای رایج یکپارچه‌سازی آورده شده است.

مانیتورینگ موقعیت‌های نهنگ‌ها در پایتون

پایتون

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 کاهش یابد و عملکرد بهبود یابد.

فیلتر زودهنگام: از پارامترهای پرس‌وجو (نماد، صرافی، جهت) برای فیلتر کردن داده‌ها در سمت سرور استفاده کنید، نه در کد برنامه‌تان.

مدیریت محدودیت‌های نرخ: منطق تکرار با تأخیر نمایی را پیاده‌سازی کنید. هنگامی که به محدودیت‌های نرخ (وضعیت 429) برخوردید، صبر کنید و دوباره تلاش کنید.

استفاده از WebSocket برای زمان واقعی: برای داده‌های جریان‌دار، اتصالات WebSocket را به جای نظرسنجی نقاط پایانی REST ترجیح دهید. پهنای باند ذخیره می‌شود و تأخیر زیر ثانیه‌ای خواهید داشت.

اعتبارسنجی زمان‌ها: همه زمان‌ها به صورت ISO 8601 UTC هستند. همیشه برای نمایش به منطقه زمانی محلی خود تبدیل کنید و همیشه در UTC ذخیره کنید.

مدیریت قطع ارتباطات: منطق اتصال مجدد خودکار با تأخیر نمایی برای اتصالات WebSocket پیاده‌سازی کنید.

نظارت بر سهمیه شما: هدر X-Requests-Remaining در پاسخ‌ها را بررسی کنید. استفاده از API خود را طوری برنامه‌ریزی کنید که در محدوده سقف خود باقی بمانید.

الگوهای رایج یکپارچه‌سازی

الگوی 1: هشدار در مورد تجمع نهنگ‌ها

هنگامی که موقعیت‌های نهنگ‌ها از یک آستانه فراتر می‌روند، هشدارهایی تنظیم کنید که نشان‌دهنده روندهای صعودی بالقوه یا فازهای تجمع است.

الگوی 2: تشخیص آربیتراژ نرخ تأمین مالی

به طور خودکار تشخیص دهید که چه زمانی اختلاف نرخ تأمین مالی از آستانه‌های سودآور در صرافی‌ها فراتر می‌رود و الگوریتم‌های آربیتراژ بین صرافی‌ها را فعال می‌کند.

الگوی 3: نظارت بر آبشارهای تصفیه

تصفیه‌های بزرگ را ردیابی کنید و الگوریتم را برای سرمایه‌گذاری بر روی آبشارهای تصفیه و حرکت‌های قیمتی با تأثیر بالا قرار دهید.

الگوی 4: تأیید چند سیگنال

موقعیت‌های نهنگ‌ها، نرخ‌های تأمین مالی، معیارهای زنجیره‌ای و امتیازات تأیید هوش مصنوعی ما را برای سیگنال‌های ورودی با اطمینان بالا ترکیب کنید.

آماده شروع هستید؟

کلید API خود را از کنسول دریافت کنید و امروز شروع به ساخت کنید. همه حساب‌های جدید دسترسی رایگان با 100 درخواست در روز (BTC, ETH, SOL) دریافت می‌کنند. برای دسترسی نامحدود به همه نمادها و ویژگی‌های پیشرفته، به Trader یا Pro ارتقا دهید.

دریافت کلید API

باز کردن قفل ویژگی‌های Pro

دسترسی کامل به موقعیت‌های نهنگ‌ها، امتیازات تأیید، داده‌های زنجیره‌ای و 2000+ درخواست API روزانه دریافت کنید.

مشاهده قیمت‌گذاری