සම්පූර්ණ REST API යොමුව

Smart Money API හි සම්පූර්ණ REST යොමුව සමඟ ප්‍රගුණ කරන්න. ක්‍රිප්ටෝ ව්‍යුත්පන්න බුද්ධිය සහ තල් මසුන් ලුහුබැඳීමේ දත්ත සඳහා සියලුම අන්ත ලක්ෂ්‍ය, පරාමිතීන්, සත්‍යාපන ක්‍රම සහ තාත්වික අනුකලන රටා ඉගෙන ගන්න.

දළ විශ්ලේෂණය

Smart Money API ඔබට Bybit, Binance සහ Hyperliquid යන ප්‍රධාන විනිමය තුනක තුළ ක්‍රිප්ටෝ ව්‍යුත්පන්න දත්ත වලට RESTful ප්‍රවේශය ලබා දෙයි. අපගේ API තල් මසුන්ගේ බඩුතුගා දත්ත, අරමුදල් අනුපාත, විවෘත උනන්දු මිණුම්, ද්‍රව්‍යකරණ දත්ත සහ අනුලෝම සංඥා එක් ඒකාබද්ධ අතුරුමුහුණතකට එකතු කරයි. ඔබ වෙළඳ ඇල්ගොරිතම, අවදානම් කළමනාකරණ පද්ධති හෝ වෙළඳපොළ විශ්ලේෂණ මෙවලම් ගොඩනඟනවා වුවද, REST API ඔබට සියලුම Smart Money බුද්ධියට සෘජු වැඩසටහන්ගත ප්‍රවේශය ලබා දෙයි.

ස්වයං-සොයාගත් වෙළඳ සංකේත 229කට වැඩි සංඛ්‍යාවක් සහ අධීක්ෂණය කරන ලද තල් මසුන්ගේ බඩුතුගා 600කට වැඩි සංඛ්‍යාවක් සමඟ, API සම්පූර්ණ වෙළඳපොළ බුද්ධිය ලබා දෙයි. තත්පරයට උප යාවත්කාලීන තාත්වික WebSocket සම්බන්ධතා ලබා දෙන අතර, අපගේ REST අන්ත ලක්ෂ්‍ය සමූහ විමසුම්, ඓතිහාසික දත්ත ලබා ගැනීම සහ විශාල පරිමාණයෙන් තැන්පතු විශ්ලේෂණය සමඟ කටයුතු කරයි.

සියලුම ඉල්ලීම් වලංගු සත්‍යාපන අක්තපත්‍ර ඇතුළත් කළ යුතුය. නිදහස් තලයේ පරිශීලකයින්ට දිනකට ඉල්ලීම් 20ක් ඇත, එය BTC වෙත සීමා වේ. වෙළෙන්දා තලය (දිනකට ඉල්ලීම් 400) සහ Pro තලය (දිනකට ඉල්ලීම් 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();

Open Interest Endpoint

සියලුම ලෙවරේජ් වෙළඳුන්ගේ සමස්ත විවෘත උනන්දුව නිරීක්ෂණය කරන්න. මිල චලනයෙන් විවෘත උනන්දුව අපගමනය වීම අවසන් වීම් සහ ප්රවණතා ඉදිරියට යාමේ අවස්ථා සංඥා කරයි. නිරපේක්ෂ OI සහ OI වෙනස් වීමේ අනුපාත දෙකම අධීක්ෂණය කරන්න.

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

Liquidations Endpoint

Returns two complementary views for a symbol: leverage-projected levels (an estimate of where liquidation clusters sit) and a realized_heatmap — the REAL executed forced-liquidation intensity (price × time) aggregated live from public exchange WebSocket feeds: Binance, OKX, Bybit, Bitget, and BitMEX. The heatmap is present when the stream has data for the symbol.

GET /v1/liquidations TRADER

Parameter	Type	Description
symbol	string	Asset symbol, default BTC optional

Trader returns cascade risk, nearest distances, and realized totals/by-side. Pro returns full projected levels plus the full realized_heatmap (matrices, per-price clusters, per-exchange counts).

On-Chain DeFi Liquidations

Executed DeFi lending-protocol liquidations captured directly from our own local BSC and Avalanche full nodes — independent of any trading bot. Covers Venus/Cream and Moolah on BSC, and AAVE V3/V2, Benqi, BankerJoe, Granary and Vinium on Avalanche. Requires an authenticated key (Trader+); Pro additionally returns bot-dependent at-risk positions.

GET /v1/liquidations/onchain TRADER

Parameter	Type	Description
chain	string	bsc or avax; omit for all optional
limit	integer	Max rows, default 100, max 500 (newest-first) optional

Confirmation Endpoint

The /v1/confirm endpoint returns a rule-based, multi-factor confluence score combining derivatives, on-chain (free Coin Metrics: MVRV / exchange-flow / active-address), and whale positioning. The composite ranges from -1.0 to +1.0 (not 0–100) and every response includes a transparent factors breakdown (per-leg score × weight), adjustments, weights, and coverage. It is decision support, not a guaranteed win-rate. An untracked symbol returns an explicit NO_DATA / unsupported result rather than a fabricated LOW.

GET /v1/confirm TRADER

Parameters: symbol (BTC/ETH/SOL) and direction (long/short). confidence is one of HIGH / MEDIUM / LOW / VETO / NO_DATA; action is one of CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult is the suggested position-size multiplier.

On-Chain Data Endpoints

Access Bitcoin and Ethereum on-chain metrics including exchange flows, whale wallet movements, MVRV ratio, NUPL, spending conditions, and realized volatility. These metrics identify accumulation/distribution cycles and provide early signals for major reversals.

GET /v1/on-chain/metrics PRO

Parameter	Type	Description
asset	string	bitcoin or ethereum required
metrics	array	Specific metrics: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (daily), 1w (weekly), default 1d optional

Data Models Reference

Understanding the structure of API responses is essential for integration. Below are the complete data model definitions used across all endpoints.

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:
        """Fetch whale positions with optional symbol filter"""
        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:
        """Get current and historical funding rates"""
        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):
        """Continuously monitor whale positions"""
        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 තත්පරයක් කෑෂ් කරන්න.

ලබන සූරාකෑමෙන් පෙරහන් කරන්න: ඔබගේ යෙදුම් කේතයේ නොව සර්වර් පැත්තේ දත්ත පෙරහන් කිරීමට විමසුම් පරාමිතීන් (සංකේත, විනිමය, දිශාව) භාවිතා කරන්න.

අනුපාත සීමාවන් හසුරුවන්න: ඝාතීය ආපසු යැවීමේ යළි උත්සාහ තර්කය ක්‍රියාත්මක කරන්න. ඔබ අනුපාත සීමාවන් (429 තත්ත්වය) පහර දුන් විට, රැඳී සිටින්න සහ යළි උත්සාහ කරන්න.

තත්පරයට අඩු ප්‍රමාදය සඳහා WebSocket භාවිතා කරන්න: දහරා දත්ත සඳහා, REST අන්ත ලක්ෂ්‍ය පරීක්ෂා කිරීම වෙනුවට WebSocket සම්බන්ධතා වලට ප්‍රමුඛතාවය දෙන්න. ඔබ කලාප පළල ඉතිරි කර ගනිමින් තත්පරයට අඩු ප්‍රමාදය ලබා ගනී.

කාල සටහන් වලංගු කරන්න: සියලු කාල සටහන් ISO 8601 UTC වේ. සැමවිටම ඔබගේ දේශීය වේලා කලාපයට පරිවර්තනය කර ප්‍රදර්ශනය සඳහා සහ සැමවිටම UTC හි ගබඩා කරන්න.

සම්බන්ධතා බිඳ වැටීම් හසුරුවන්න: WebSocket සම්බන්ධතා සඳහා ඝාතීය ආපසු යැවීම සහිත ස්වයංක්‍රීය නැවත සම්බන්ධ වීමේ තර්කය ක්‍රියාත්මක කරන්න.

ඔබගේ කෝටාව නිරීක්ෂණය කරන්න: ප්‍රතිචාර වල X-Requests-Remaining ශීර්ෂය පරීක්ෂා කරන්න. ඔබගේ තරාතිරම් සීමාව තුළ රැඳී සිටීම සඳහා ඔබගේ API භාවිතය සැලසුම් කරන්න.

පොදු ඒකාබද්ධ කිරීම් රටා

රටා 1: වේල් සමුච්චය ගැන ඇඟවීම්

වේල් ස්ථාන ලාභදායී ධාවන හෝ සමුච්චය අවධි සංඥා කරන එක්තරා අගයක් ඉක්මවා යන විට ඇඟවීම් සකසන්න.

රටා 2: අරමුදල් අනුපාත අර්බුද අනාවරණය

අරමුදල් අනුපාත පැතිරීම් ලාභදායී අගයන් ඉක්මවා යන විට ස්වයංක්‍රීයව අනාවරණය කරන්න, එමඟින් විනිමය අතර අර්බුද ඇල්ගොරිතම සක්‍රීය කරන්න.

රටා 3: ද්‍රවීකරණ කැස්කඩ නිරීක්ෂණය

විශාල ද්‍රවීකරණ සහ කැස්කඩ තරංග අධීක්ෂණය කර ඇල්ගොරිතම ස්ථානගත කරන්න, එමඟින් කැස්කඩ ද්‍රවීකරණ සහ ඉහළ බලපෑම් මිල චලනයන් මත ප්‍රායෝගිකව ප්‍රතිලාභ ලබා ගන්න.

රටා 4: බහු-සංඥා තහවුරු කිරීම

ඉහළ විශ්වාසයෙන් යුත් ඇතුල් වීමේ සංඥා සඳහා වේල් ස්ථාන, අරමුදල් අනුපාත, චේන් මත දත්ත සහ අපගේ AI තහවුරු කිරීමේ ලකුණු ඒකාබද්ධ කරන්න.

ආරම්භ කිරීමට සූදානම්ද?

කොන්සෝලයෙන් ඔබගේ API යතුර ලබා ගෙන අදම ගොඩනැගීම ආරම්භ කරන්න. නව ගිණුම් සියල්ලටම නිදහස් තරාතිරම් ප්‍රවේශය ලබා ගත හැකිය (දිනකට ඉල්ලීම් 20, BTC, ETH, SOL). සියලු සංකේත සහ උසස් විශේෂාංග වලට අසීමිත ප්‍රවේශය සඳහා වෙළෙන්දා හෝ Pro වෙත උත්ශ්‍රේණි කරන්න.

API යතුර ලබා ගන්න

Pro විශේෂාංග අගුළු අරින්න

වේල් ස්ථාන, තහවුරු කිරීමේ ලකුණු, චේන් මත දත්ත සහ දිනකට API ඉල්ලීම් 2000+ වලට සම්පූර්ණ ප්‍රවේශය ලබා ගන්න.

මිල නැරඹීම