সম্পূর্ণ REST API রেফারেন্স

আমাদের বিস্তৃত REST রেফারেন্স দিয়ে Smart Money API আয়ত্ত করুন। ক্রিপ্টো ডেরিভেটিভস ইন্টেলিজেন্স এবং হোয়েল ট্র্যাকিং ডাটার জন্য সমস্ত এন্ডপয়েন্ট, প্যারামিটার, অথেন্টিকেশন পদ্ধতি এবং বাস্তব-বিশ্বের ইন্টিগ্রেশন প্যাটার্ন শিখুন।

ওভারভিউ

Smart Money API তিনটি প্রধান এক্সচেঞ্জ — Bybit, Binance, এবং Hyperliquid-এ রিয়েল-টাইম ক্রিপ্টোকারেন্সি ডেরিভেটিভস ডাটায় RESTful অ্যাক্সেস প্রদান করে। আমাদের API হোয়েল ওয়ালেট পজিশন, ফান্ডিং রেট, ওপেন ইন্টারেস্ট মেট্রিক্স, লিকুইডেশন ডাটা এবং অন-চেইন সিগন্যালগুলিকে একটি একক ইউনিফাইড ইন্টারফেসে একত্রিত করে। আপনি ট্রেডিং অ্যালগরিদম, রিস্ক ম্যানেজমেন্ট সিস্টেম বা মার্কেট অ্যানালাইসিস টুল তৈরি করছেন না কেন, REST API আপনাকে সরাসরি প্রোগ্রাম্যাটিক অ্যাক্সেস দেয় সমস্ত Smart Money ইন্টেলিজেন্সে।

229+ স্বয়ংক্রিয়ভাবে আবিষ্কৃত ট্রেডিং সিম্বল এবং 600+ মনিটর করা হোয়েল ওয়ালেট সহ, API ব্যাপক মার্কেট ইন্টেলিজেন্স প্রদান করে। রিয়েল-টাইম WebSocket সংযোগ সাব-সেকেন্ড আপডেট সরবরাহ করে, যখন আমাদের REST এন্ডপয়েন্টগুলি ব্যাচ ক্যোয়ারী, হিস্টোরিক্যাল ডাটা রিট্রিভাল এবং পোর্টফোলিও অ্যানালাইসিস স্কেলে পরিচালনা করে।

সমস্ত অনুরোধে অবশ্যই বৈধ অথেন্টিকেশন ক্রেডেনশিয়াল অন্তর্ভুক্ত থাকতে হবে। ফ্রি টিয়ার ব্যবহারকারীদের জন্য BTC-তে সীমাবদ্ধ 20টি অনুরোধ/দিন রয়েছে। ট্রেডার টিয়ার (400 অনুরোধ/দিন) এবং প্রো টিয়ার (4,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.

পাইথন

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) 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 15-মিনিট গ্রানুলারিটি সহ রেট একত্রিত করে এবং হিস্টোরিক্যাল রেট অ্যানালাইসিস প্রদান করে।

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

ওপেন ইন্টারেস্ট এন্ডপয়েন্ট

সমস্ত লিভারেজ ট্রেডারদের সমষ্টিগত ওপেন ইন্টারেস্ট মনিটর করুন। মূল্য আন্দোলন থেকে ওপেন ইন্টারেস্টের বিভেদ সম্ভাব্য বিপরীতমুখী এবং ট্রেন্ড ধারাবাহিকতার সুযোগ নির্দেশ করে। পরম OI এবং OI পরিবর্তনের হার উভয়ই ট্র্যাক করুন।

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

লিকুইডেশন এন্ডপয়েন্ট

একটি সিম্বলের জন্য দুটি পরিপূরক ভিউ প্রদান করে: লিভারেজ-প্রজেক্টেড levels (একটি অনুমান যেখানে লিকুইডেশন ক্লাস্টার অবস্থিত) এবং একটি realized_heatmap — বাস্তবায়িত জোরপূর্বক লিকুইডেশনের তীব্রতা (মূল্য × সময়) পাবলিক এক্সচেঞ্জ ওয়েবসকেট ফিড থেকে লাইভ অ্যাগ্রিগেট করা: Binance, OKX, Bybit, Bitget, এবং BitMEX। হিটম্যাপ উপস্থিত থাকে যখন স্ট্রিমে সিম্বলের জন্য ডেটা থাকে।

GET /v1/liquidations ট্রেডার

প্যারামিটার	টাইপ	বিবরণ
symbol	string	অ্যাসেট সিম্বল, ডিফল্ট 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

কনফার্মেশন এন্ডপয়েন্ট

দ্য /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 required
metrics	array	নির্দিষ্ট মেট্রিক্স: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (দৈনিক), 1w (সাপ্তাহিক), ডিফল্ট 1d optional

ডেটা মডেল রেফারেন্স

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"হোয়েল {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# ব্যবহার
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"মোট হোয়েল পজিশন: {whales['data']['total']}")

সেরা অনুশীলন ও পারফরম্যান্স টিপস

পেজিনেশন ব্যবহার করুন: বড় রেজাল্ট সেটের জন্য সর্বদা পেজিনেশন ব্যবহার করুন। লিমিট ও পেজ প্যারামিটার ব্যবহার করে ৫০-১০০ রেকর্ডের চাঙ্কে ডেটা ফেচ করুন, একবারে সব ডেটা নয়।

রেসপন্স ক্যাশ করুন: হোয়েল পজিশন প্রতি সেকেন্ডে পরিবর্তিত হয় না। API কল কমানো ও পারফরম্যান্স বাড়ানোর জন্য ৩০-৬০ সেকেন্ডের জন্য রেজাল্ট ক্যাশ করুন।

প্রাথমিকভাবে ফিল্টার করুন: কোয়েরি প্যারামিটার (সিম্বল, এক্সচেঞ্জ, দিক) ব্যবহার করে সার্ভার সাইডে ডেটা ফিল্টার করুন, আপনার অ্যাপ্লিকেশন কোডে নয়।

রেট লিমিট হ্যান্ডেল করুন: এক্সপোনেনশিয়াল ব্যাকঅফ রিট্রি লজিক ইমপ্লিমেন্ট করুন। যখন রেট লিমিট (৪২৯ স্ট্যাটাস) পাবেন, অপেক্ষা করে আবার চেষ্টা করুন।

রিয়েল-টাইমের জন্য WebSocket ব্যবহার করুন: স্ট্রিমিং ডেটার জন্য পোলিং REST এন্ডপয়েন্টের বদলে WebSocket কানেকশন পছন্দ করুন। আপনি ব্যান্ডউইথ বাঁচাবেন এবং সাব-সেকেন্ড লেটেন্সি পাবেন।

টাইমস্ট্যাম্প ভ্যালিডেট করুন: সমস্ত টাইমস্ট্যাম্প ISO 8601 UTC ফরম্যাটে। ডিসপ্লের জন্য সর্বদা আপনার লোকাল টাইমজোনে কনভার্ট করুন এবং স্টোর করুন সর্বদা UTC তে।

ডিসকানেকশন হ্যান্ডেল করুন: WebSocket কানেকশনের জন্য এক্সপোনেনশিয়াল ব্যাকঅফ সহ অটোমেটিক রিকানেকশন লজিক ইমপ্লিমেন্ট করুন।

আপনার কোটা মনিটর করুন: রেসপন্সের X-Requests-Remaining হেডার চেক করুন। আপনার API ব্যবহার আপনার টায়ার লিমিটের মধ্যে রাখার জন্য পরিকল্পনা করুন।

সাধারণ ইন্টিগ্রেশন প্যাটার্ন

প্যাটার্ন ১: হোয়েল অ্যাকিউমুলেশনে অ্যালার্ট

হোয়েল পজিশন একটি থ্রেশহোল্ড অতিক্রম করলে অ্যালার্ট সেট আপ করুন, যা সম্ভাব্য বুল রান বা অ্যাকিউমুলেশন ফেজ নির্দেশ করে।

প্যাটার্ন ২: ফান্ডিং রেট আরবিট্রেজ ডিটেকশন

স্বয়ংক্রিয়ভাবে সনাক্ত করুন যখন ফান্ডিং রেট স্প্রেড লাভজনক থ্রেশহোল্ড অতিক্রম করে এক্সচেঞ্জ জুড়ে, যা ক্রস-এক্সচেঞ্জ আরবিট্রেজ অ্যালগরিদম সক্ষম করে।

প্যাটার্ন ৩: লিকুইডেশন ক্যাসকেড মনিটরিং

বড় লিকুইডেশন ট্র্যাক করুন এবং ক্যাসকেডিং লিকুইডেশন এবং উচ্চ-প্রভাব মূল্য চলাচলে লাভের জন্য অ্যালগরিদম পজিশন করুন।

প্যাটার্ন ৪: মাল্টি-সিগন্যাল কনফার্মেশন

হোয়েল পজিশন, ফান্ডিং রেট, অন-চেইন মেট্রিক্স এবং আমাদের AI কনফার্মেশন স্কোরগুলিকে উচ্চ-কনভিকশন এন্ট্রি সিগন্যালের জন্য একত্রিত করুন।

শুরু করতে প্রস্তুত?

কনসোল থেকে আপনার API কী পান এবং আজই বিল্ডিং শুরু করুন। সমস্ত নতুন অ্যাকাউন্টে বিনামূল্যে টিয়ার অ্যাক্সেস পাবেন যেখানে প্রতিদিন 20টি রিকোয়েস্ট (BTC, ETH, SOL)। ট্রেডার বা প্রোতে আপগ্রেড করে সমস্ত সিম্বল এবং উন্নত ফিচারে সীমাহীন অ্যাক্সেস পান।

API কী পান

প্রো ফিচার আনলক করুন

হোয়েল পজিশন, কনফার্মেশন স্কোর, অন-চেইন ডেটা এবং 2000+ দৈনিক API রিকোয়েস্টে সম্পূর্ণ অ্যাক্সেস পান।

মূল্য দেখুন