مکمل REST API حوالہ

ہمارے جامع REST حوالے کے ساتھ Smart Money API میں مہارت حاصل کریں۔ کرپٹو ڈیریویٹو انٹیلی جنس اور وہیل ٹریکنگ ڈیٹا کے لیے تمام اینڈ پوائنٹس، پیرامیٹرز، تصدیق کے طریقوں، اور حقیقی دنیا کے انضمام کے نمونوں کو سیکھیں۔

جائزہ

Smart Money API تین بڑے ایکسچینجز: Bybit، Binance، اور Hyperliquid پر ریئل ٹائم کرپٹو کرنسی ڈیریویٹو ڈیٹا تک RESTful رسائی فراہم کرتا ہے۔ ہمارا 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

# Get JWT token
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# Use JWT for subsequent requests
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

WebSocket URL: 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	صرف لمبی یا شارٹ پوزیشنز اختیاری
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 پر ریئل ٹائم اور تاریخی فنڈنگ ریٹس تک رسائی حاصل کریں۔ فنڈنگ ریٹس آربیٹریج ٹریڈنگ، سوئنگ اسٹریٹیجیز، اور ڈیریویٹو ہیجنگ کے لیے اہم ہیں۔ ہمارا 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	ٹریڈنگ جوڑا required
exchange	string	bybit, binance, or hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, default 15m optional

لیکویڈیشنز اینڈ پوائنٹ

ایک symbol کے لیے دو تکمیلی نظریات واپس کرتا ہے: لیوریج-پروجیکٹڈ levels (لیکویڈیشن کلسٹرز کے مقام کا اندازہ) اور ایک realized_heatmap — اصل میں انجام دی گئی فورسڈ-لیکویڈیشن کی شدت (قیمت × وقت) جو عوامی ایکسچینج ویب ساکٹ فیڈز سے لائیو جمع کی گئی ہے: Binance, OKX, Bybit, Bitget, اور BitMEX۔ ہیٹ میپ اس وقت موجود ہوتا ہے جب symbol کے لیے ڈیٹا اسٹریم میں ہو۔

GET /v1/liquidations ٹریڈر

پیرامیٹر	ٹائپ	تفصیل
symbol	string	ایسٹ symbol, ڈیفالٹ BTC optional

ٹریڈر کیسکیڈ رسک، قریبی فاصلوں، اور ریئلائزڈ ٹوٹلز/بائی سائیڈ واپس کرتا ہے۔ پرو مکمل پروجیکٹڈ levels کے ساتھ ساتھ مکمل realized_heatmap (میٹرکس، فی-قیمت کلسٹرز، فی-ایکسچینج کاؤنٹس) واپس کرتا ہے۔

آن چین ڈی فائی لیکویڈیشنز

ہمارے اپنے مقامی BSC اور Avalanche فل نوڈز سے براہ راست کیپچر کی گئی ڈی فائی لینڈنگ-پروٹوکول لیکویڈیشنز — کسی بھی ٹریڈنگ بوٹ سے آزاد۔ BSC پر Venus/Cream اور Moolah، اور Avalanche پر AAVE V3/V2, Benqi, BankerJoe, Granary اور Vinium کا احاطہ کرتا ہے۔ ایک تصدیق شدہ کلید (ٹریڈر+) کی ضرورت ہوتی ہے؛ پرو اضافی طور پر بوٹ پر منحصر رسک والی پوزیشنز واپس کرتا ہے۔

GET /v1/liquidations/onchain ٹریڈر

پیرامیٹر	ٹائپ	تفصیل
chain	string	bsc یا avax؛ تمام کے لیے چھوڑ دیں optional
limit	integer	زیادہ سے زیادہ قطاریں، ڈیفالٹ 100، زیادہ سے زیادہ 500 (نئی ترین-پہلے) optional

کنفرمیشن اینڈ پوائنٹ

The /v1/confirm اینڈ پوائنٹ ایک رول-بیسڈ، ملٹی-فیکٹر confluence اسکور واپس کرتا ہے جو ڈیریویٹیوز، آن چین (مفت Coin Metrics: MVRV / exchange-flow / active-address)، اور وہیل پوزیشننگ کو ملاتا ہے۔ composite -1.0 سے +1.0 تک ہوتا ہے (0–100 نہیں) اور ہر ردعمل میں ایک شفاف factors بریک ڈاؤن (فی-لیگ اسکور × وزن)، adjustments, weights, اور coverageشامل ہوتا ہے۔ یہ فیصلہ سپورٹ ہے، کوئی گارنٹیڈ ون-ریٹ نہیں۔ ایک انٹریکڈ symbol ایک واضح 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 تجویز کردہ پوزیشن-سائز ملٹی پلائر ہے۔

آن چین ڈیٹا اینڈ پوائنٹس

بٹ کوائن اور Ethereum آن چین میٹرکس تک رسائی حاصل کریں جن میں ایکسچینج فلو، وہیل والیٹ کی حرکتیں، 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 Object

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 Object

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']}")

بہترین طریقے اور کارکردگی کے نکات

پیجینیشن استعمال کریں: بڑے نتیجے کے سیٹس کو ہمیشہ پیجینیشن کے ساتھ حاصل کریں۔ تمام ڈیٹا ایک ساتھ لینے کی بجائے 50-100 ریکارڈز کے چنک میں ڈیٹا حاصل کرنے کے لیے limit اور page پیرامیٹرز استعمال کریں۔

جوابات کو کیش کریں: وہیل پوزیشنز ہر سیکنڈ میں تبدیل نہیں ہوتیں۔ API کالز کو کم کرنے اور کارکردگی کو بہتر بنانے کے لیے نتائج کو 30-60 سیکنڈز کے لیے کیش کریں۔

جلد فلٹر کریں: اپنی ایپلیکیشن کوڈ میں فلٹر کرنے کی بجائے سرور سائیڈ ڈیٹا کو فلٹر کرنے کے لیے کوئری پیرامیٹرز (symbol, exchange, direction) استعمال کریں۔

ریٹ لیمٹس کو ہینڈل کریں: ایکسپونینشل بیک آف ریٹری لاجک کو نافذ کریں۔ جب آپ ریٹ لیمٹس (429 اسٹیٹس) کو ہٹاتے ہیں، تو انتظار کریں اور دوبارہ کوشش کریں۔

ریل ٹائم کے لیے WebSocket استعمال کریں: سٹریمنگ ڈیٹا کے لیے، پولنگ REST اینڈ پوائنٹس کی بجائے WebSocket کنکشنز کو ترجیح دیں۔ آپ بینڈوتھ بچائیں گے اور سب سیکنڈ لیٹنسی حاصل کریں گے۔

ٹائم اسٹیمپس کی تصدیق کریں: تمام ٹائم اسٹیمپس ISO 8601 UTC ہیں۔ ڈسپلے کے لیے ہمیشہ اپنے مقامی ٹائم زون میں تبدیل کریں اور ہمیشہ UTC میں اسٹور کریں۔

ڈس کنکشنز کو ہینڈل کریں: WebSocket کنکشنز کے لیے ایکسپونینشل بیک آف کے ساتھ خودکار ری کنکشن لاجک کو نافذ کریں۔

اپنے کوٹا کی نگرانی کریں: جوابات میں X-Requests-Remaining ہیڈر کو چیک کریں۔ اپنے ٹائر کی حد کے اندر رہنے کے لیے اپنے API کے استعمال کی منصوبہ بندی کریں۔

عام انضمامی نمونے

نمونہ 1: وہیل اکمولیشن پر الرٹ

وہیل پوزیشنز کے ایک حد سے بڑھنے پر الرٹس سیٹ اپ کریں، جو ممکنہ بل رنز یا اکمولیشن فیزز کی نشاندہی کر سکتے ہیں۔

نمونہ 2: فنڈنگ ریٹ آربیٹریج ڈیٹیکشن

خودکار طور پر پتہ لگائیں جب فنڈنگ ریٹ سپریڈز منافع بخش حدوں کو عبور کر جائیں، جو کراس ایکسچینج آربیٹریج الگورتھمز کو قابل بناتے ہیں۔

نمونہ 3: لیکویڈیشن کیسکیڈ مانیٹرنگ

بڑی لیکویڈیشنز کو ٹریک کریں اور الگورتھم کو کیسکیڈنگ لیکویڈیشنز اور ہائی امپیکٹ پرائس مووز پر کیپیٹلائز کرنے کے لیے پوزیشن دیں۔

نمونہ 4: ملٹی سگنل کنفرمیشن

ہائی کنویکشن انٹری سگنلز کے لیے وہیل پوزیشنز، فنڈنگ ریٹس، آن چین میٹرکس، اور ہماری AI کنفرمیشن اسکورز کو ملا دیں۔

شروع کرنے کے لیے تیار ہیں؟

اپنی API کلید کنسول سے حاصل کریں اور آج ہی بنانا شروع کریں۔ تمام نئے اکاؤنٹس کو 20 درخواستوں فی دن (BTC, ETH, SOL) کے ساتھ مفت ٹائر تک رسائی ملتی ہے۔ تمام علامات اور جدید خصوصیات تک لامحدود رسائی کے لیے ٹریڈر یا پرو میں اپ گریڈ کریں۔

API کلید حاصل کریں

پرو خصوصیات کو انلاک کریں

وہیل پوزیشنز، کنفرمیشن اسکورز، آن چین ڈیٹا، اور 2000+ روزانہ API درخواستوں تک مکمل رسائی حاصل کریں۔

قیمت دیکھیں