पूर्ण REST API संदर्भ

हमारे व्यापक REST संदर्भ के साथ Smart Money API में महारत हासिल करें। क्रिप्टो डेरिवेटिव्स इंटेलिजेंस और व्हेल ट्रैकिंग डेटा के लिए सभी एंडपॉइंट्स, पैरामीटर्स, प्रमाणीकरण विधियों और वास्तविक दुनिया के इंटीग्रेशन पैटर्न सीखें।

अवलोकन

Smart Money API तीन प्रमुख एक्सचेंजों: Bybit, Binance, और Hyperliquid में रीयल-टाइम क्रिप्टोकरेंसी डेरिवेटिव्स डेटा तक RESTful पहुंच प्रदान करता है। हमारा API व्हेल वॉलेट पोजीशन्स, फंडिंग रेट्स, ओपन इंटरेस्ट मेट्रिक्स, लिक्विडेशन डेटा, और ऑन-चेन सिग्नल्स को एक एकीकृत इंटरफेस में समेटता है। चाहे आप ट्रेडिंग एल्गोरिदम, रिस्क मैनेजमेंट सिस्टम, या मार्केट एनालिसिस टूल्स बना रहे हों, REST API आपको सभी Smart Money इंटेलिजेंस तक सीधी प्रोग्रामेटिक पहुंच प्रदान करता है।

229+ स्वतः खोजे गए ट्रेडिंग सिंबल्स और 600+ मॉनिटर किए गए व्हेल वॉलेट्स के साथ, API व्यापक मार्केट इंटेलिजेंस प्रदान करता है। रीयल-टाइम WebSocket कनेक्शन सब-सेकंड अपडेट्स देते हैं, जबकि हमारे REST एंडपॉइंट्स बैच क्वेरीज़, ऐतिहासिक डेटा पुनर्प्राप्ति, और पोर्टफोलियो विश्लेषण को बड़े पैमाने पर संभालते हैं।

सभी अनुरोधों में वैध प्रमाणीकरण क्रेडेंशियल्स शामिल होने चाहिए। फ्री टियर उपयोगकर्ताओं के पास BTC तक सीमित 100 अनुरोध प्रति दिन होते हैं। ट्रेडर टियर (1,000 अनुरोध/दिन) और प्रो टियर (5,000 अनुरोध/दिन) सभी सिंबल्स और उन्नत सुविधाओं को अनलॉक करते हैं।

प्रमाणीकरण

Smart Money API API कुंजी प्रमाणीकरण का उपयोग करता है। प्राथमिक विधि है X-API-Key अनुरोध हेडर। आप अपने डैशबोर्ड से API कुंजियाँ उत्पन्न कर सकते हैं। एक सत्र JWT via 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 पास कर सकते हैं via 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	ट्रेडिंग पेयर आवश्यक
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 वैकल्पिक

ट्रेडर कैस्केड रिस्क, निकटतम दूरियां, और रियलाइज्ड टोटल/बाय-साइड लौटाता है। प्रो पूर्ण प्रोजेक्टेड लेवल्स प्लस पूरा realized_heatmap (मैट्रिसेस, प्रति-कीमत क्लस्टर, प्रति-एक्सचेंज काउंट्स)।

ऑन-चेन डेफी लिक्विडेशन्स

हमारे स्वयं के स्थानीय BSC और Avalanche फुल नोड्स से सीधे कैप्चर किए गए निष्पादित डेफी लेंडिंग-प्रोटोकॉल लिक्विडेशन्स — किसी ट्रेडिंग बॉट से स्वतंत्र। BSC पर Venus/Cream और Moolah, और Avalanche पर AAVE V3/V2, Benqi, BankerJoe, Granary और Vinium को कवर करता है। प्रमाणित की (ट्रेडर+) की आवश्यकता होती है; प्रो अतिरिक्त रूप से बॉट-निर्भर जोखिम वाली पोजीशन्स लौटाता है।

GET /v1/liquidations/onchain ट्रेडर

पैरामीटर	प्रकार	विवरण
chain	string	bsc या avax; सभी के लिए छोड़ दें वैकल्पिक
limit	integer	अधिकतम पंक्तियां, डिफॉल्ट 100, अधिकतम 500 (नवीनतम-पहले) वैकल्पिक

कन्फर्मेशन एंडपॉइंट

The /v1/confirm एंडपॉइंट एक नियम-आधारित, मल्टी-फैक्टर confluence स्कोर लौटाता है जो डेरिवेटिव्स, ऑन-चेन (मुफ्त कॉइन मेट्रिक्स: MVRV / एक्सचेंज-फ्लो / एक्टिव-एड्रेस), और व्हेल पोजिशनिंग को जोड़ता है। composite -1.0 से +1.0 (0–100 नहीं) तक होता है और प्रत्येक प्रतिक्रिया में एक पारदर्शी factors ब्रेकडाउन (प्रति-लेग स्कोर × वजन), adjustments, weights, और coverageशामिल होता है। यह निर्णय समर्थन है, गारंटीकृत जीत दर नहीं। एक अनट्रैक्ड सिंबल एक स्पष्ट NO_DATA / असमर्थित परिणाम लौटाता है न कि एक निर्मित LOW।

GET /v1/confirm ट्रेडर

पैरामीटर्स: symbol (BTC/ETH/SOL) और direction (लॉन्ग/शॉर्ट)। 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 प्रो

पैरामीटर	प्रकार	विवरण
asset	string	bitcoin या ethereum आवश्यक
metrics	array	विशिष्ट मेट्रिक्स: exchange_flows, mvrv, nupl, whale_moves वैकल्पिक
interval	string	1d (दैनिक), 1w (साप्ताहिक), डिफॉल्ट 1d वैकल्पिक

डेटा मॉडल्स रेफरेंस

API प्रतिक्रियाओं की संरचना को समझना इंटीग्रेशन के लिए आवश्यक है। नीचे सभी एंडपॉइंट्स में उपयोग किए गए पूर्ण डेटा मॉडल परिभाषाएं दी गई हैं।

व्हेलपोजिशन ऑब्जेक्ट

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

फंडिंगरेट रिकॉर्ड ऑब्जेक्ट

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 रिकॉर्ड के चंक्स में डेटा प्राप्त करने के लिए लिमिट और पेज पैरामीटर्स का उपयोग करें।

प्रतिक्रियाओं को कैश करें: व्हेल पोजीशन्स हर सेकंड नहीं बदलती हैं। एपीआई कॉल्स को कम करने और प्रदर्शन को बेहतर बनाने के लिए परिणामों को 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 रिक्वेस्ट्स का पूर्ण एक्सेस प्राप्त करें।

मूल्य निर्धारण देखें