Complete REST API Reference

Smart Money API ရဲ့ အပြည့်အစုံ REST reference ဖြင့် ကျွမ်းကျင်စွာ အသုံးပြုနိုင်ပါသည်။ Crypto derivatives intelligence နှင့် whale tracking data အတွက် endpoints, parameters, authentication methods နှင့် real-world integration patterns အားလုံးကို လေ့လာပါ။

Overview

Smart Money API သည် Bybit, Binance နှင့် Hyperliquid အပါအဝင် အဓိက exchange သုံးခုမှ real-time cryptocurrency derivatives data ကို RESTful access ပေးပါသည်။ ကျွန်ုပ်တို့၏ API သည် whale wallet positions, funding rates, open interest metrics, liquidation data နှင့် on-chain signals များကို တစ်ခုတည်းသော unified interface တွင် စုစည်းပေးပါသည်။ Trading algorithms, risk management systems သို့မဟုတ် market analysis tools များကို တည်ဆောက်နေပါက၊ REST API သည် Smart Money intelligence အားလုံးကို programmatic access ဖြင့် ရရှိစေပါသည်။

Auto-discovered trading symbols 229 ကျော်နှင့် စောင့်ကြည့်ထားသော whale wallets 600+ ဖြင့်၊ API သည် ကျယ်ပြန့်သော market intelligence ကို ပေးပါသည်။ Real-time WebSocket connections များသည် sub-second updates များကို ပေးပြီး၊ ကျွန်ုပ်တို့၏ REST endpoints များသည် batch queries, historical data retrieval နှင့် portfolio analysis ကို scale တွင် ကိုင်တွယ်ပါသည်။

အသုံးပြုသူအားလုံးသည် မှန်ကန်သော authentication credentials များကို ထည့်သွင်းရန် လိုအပ်ပါသည်။ Free tier အသုံးပြုသူများသည် BTC အတွက် တစ်နေ့လျှင် request 20 ခုသာ ကန့်သတ်ထားပါသည်။ Trader tier (တစ်နေ့လျှင် request 400 ခု) နှင့် Pro tier (တစ်နေ့လျှင် request 4,000 ခု) တို့သည် symbols အားလုံးနှင့် advanced features များကို ဖွင့်ပေးပါသည်။

Authentication

Smart Money API သည် API key authentication ကို အသုံးပြုပါသည်။ အဓိက method မှာ X-API-Key request header ဖြစ်ပါသည်။ API keys များကို သင့် dashboard မှ generate လုပ်နိုင်ပါသည်။ Browser/dashboard sessions များအတွက် fallback အဖြစ် Authorization: Bearer မှတစ်ဆင့် session JWT ကို လက်ခံပါသည်၊ သို့သော် API clients များသည် X-API-Key.

API Key Authentication (primary)

သင့် API key ကို X-API-Key header တွင် request တိုင်းတွင် ပေးပို့ပါ။ URL တွင် သင့် key ကို ဘယ်တော့မှ မထည့်ပါနှင့်။

HTTP

GET /v1/whales/events HTTP/1.1
Host: api.smartmoneyapi.com
X-API-Key: sm_your_key
Content-Type: application/json

Session JWT (fallback)

Browser/dashboard sessions များသည် session JWT ကို Authorization: Bearer (24 နာရီအတွက် အကျုံးဝင်သည်) မှတစ်ဆင့် ပေးပို့နိုင်ပါသည်။ Programmatic clients များသည် 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())

Base URL & Endpoints

API requests အားလုံးသည် https://api.smartmoneyapi.comသို့ သွားပါသည်။ API ကို version prefixes များဖြင့် logical resource categories အဖြစ် စီစဉ်ထားပါသည်။ Current stable version မှာ v1.

Base URL: https://api.smartmoneyapi.com/api/v1

WebSocket URL: wss://ws.smartmoneyapi.com/stream

Response Format

API responses အားလုံးကို standard envelope format ဖြင့် JSON objects အဖြစ် return ပြန်ပါသည်။ Successful responses များသည် HTTP 200-299 status codes များနှင့် response body တွင် data ကို return ပြန်ပါသည်။ Error responses များတွင် detailed error messages နှင့် resolution suggestions များ ပါဝင်ပါသည်။

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

Whale Positions Endpoint

Exchange အားလုံးမှ စောင့်ကြည့်ထားသော whale wallets များမှ detailed positions များကို ရယူပါ။ ဤ endpoint သည် high-value positions များအတွက် real-time leverage, entry prices, liquidation prices နှင့် unrealized P&L ကို ပြသပါသည်။

GET /v1/whales/events PRO

Parameter	Type	Description
symbol	string	Trading pair (e.g., BTCUSDT, ETHUSDT) optional
exchange	string	Filter by exchange: bybit, binance, hyperliquid optional
min_position_size	number	Minimum position size in base asset optional
direction	string	long or short positions only optional
page	integer	Pagination page number, default 1 optional
limit	integer	Results per page, max 100, default 50 optional

Example Request:

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"

Funding Rates Endpoint

Bybit, Binance နှင့် Hyperliquid တို့မှ real-time နှင့် historical funding rates များကို ရယူပါ။ Funding rates များသည် arbitrage trading, swing strategies နှင့် derivatives hedging အတွက် အရေးကြီးပါသည်။ ကျွန်ုပ်တို့၏ API သည် rates များကို 15-minute granularity ဖြင့် စုစည်းပေးပြီး historical rate analysis ကို ပေးပါသည်။

GET /v1/funding-rates FREE

Parameter	Type	Description
symbol	string	Trading pair (e.g., BTCUSDT) required
exchange	string	Exchange: bybit, binance, hyperliquid optional
interval	string	1h, 4h, 1d, default 1h optional
limit	integer	Historical periods to return, max 500 optional

Example Request:

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

Monitor aggregate open interest across all leverage traders. Open interest divergence from price movement signals potential reversals and trend continuation opportunities. Track both absolute OI and OI change rates.

GET /v1/open-interest TRADER

Parameter	Type	Description
symbol	string	Trading pair 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
  }
}

ကုဒ်နမူနာများ

အောက်တွင် အသုံးများသော ပေါင်းစပ်မှုပုံစံများအတွက် အဆင်သင့်အသုံးပြုနိုင်သော ကုဒ်နမူနာများပါဝင်ပါသည်။

Python တွင် ဝေလငါးတည်နေရာများကို စောင့်ကြည့်ခြင်း

Python

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)

# အသုံးပြုပုံ
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Total whale positions: {whales['data']['total']}")

အကောင်းဆုံးအလေ့အကျင့်များနှင့် စွမ်းဆောင်ရည်အကြံပြုချက်များ

စာမျက်နှာခွဲခြင်းကို အသုံးပြုပါ: ရလဒ်အစုကြီးများကို အမြဲစာမျက်နှာခွဲပါ။ limit နှင့် page parameters များကို အသုံးပြု၍ အချက်အလက် 50-100 မှတ်တမ်းအပိုင်းအစများကို တစ်ကြိမ်တည်းမဟုတ်ဘဲ ရယူပါ။

တုံ့ပြန်ချက်များကို ကက်ရှ်လုပ်ပါ: ဝေလငါးတည်နေရာများသည် စက္ကန့်တိုင်းပြောင်းလဲမှုမရှိပါ။ API ခေါ်ဆိုမှုများကို လျှော့ချရန်နှင့် စွမ်းဆောင်ရည်တိုးတက်စေရန် ရလဒ်များကို 30-60 စက္ကန့်ကြာ ကက်ရှ်လုပ်ပါ။

စောစီးစွာ စစ်ထုတ်ပါ: သင့်အက်ပ်လီကေးရှင်းကုဒ်တွင် မဟုတ်ဘဲ ဆာဗာဘက်တွင် အချက်အလက်များကို စစ်ထုတ်ရန် query parameters (symbol, exchange, direction) များကို အသုံးပြုပါ။

နှုန်းကန့်သတ်ချက်များကို ကိုင်တွယ်ပါ: ထပ်တိုးနောက်ပြန်ဆုတ်မှု ယုတ္တိကို အကောင်အထည်ဖော်ပါ။ နှုန်းကန့်သတ်ချက်များကို ရောက်ရှိသောအခါ (429 status)၊ စောင့်ပြီး ပြန်လည်ကြိုးစားပါ။

Real-time အတွက် WebSocket ကို အသုံးပြုပါ: အချက်အလက်စီးဆင်းမှုအတွက်၊ polling REST endpoints များထက် WebSocket ချိတ်ဆက်မှုများကို ဦးစားပေးပါ။ Bandwidth ကို သက်သာစေပြီး စက္ကန့်အောက် latency ကို ရရှိမည်။

အချိန်မှတ်တမ်းများကို အတည်ပြုပါ: အချိန်မှတ်တမ်းအားလုံးသည် ISO 8601 UTC ဖြစ်သည်။ ပြသရန်အတွက် အမြဲသင့်ဒေသိယအချိန်ဇုန်သို့ ပြောင်းလဲပြီး အမြဲ UTC တွင် သိမ်းဆည်းပါ။

ချိတ်ဆက်မှုပြတ်တောက်မှုများကို ကိုင်တွယ်ပါ: WebSocket ချိတ်ဆက်မှုများအတွက် ထပ်တိုးနောက်ပြန်ဆုတ်မှုနှင့်အတူ အလိုအလျောက်ပြန်ချိတ်ဆက်မှုယုတ္တိကို အကောင်အထည်ဖော်ပါ။

သင့်အချိုးအစားကို စောင့်ကြည့်ပါ: တုံ့ပြန်ချက်များတွင် X-Requests-Remaining header ကို စစ်ဆေးပါ။ သင့်အဆင့်ကန့်သတ်ချက်အတွင်းတွင် ရှိနေစေရန် သင့် API အသုံးပြုမှုကို စီစဉ်ပါ။

အသုံးများသော ပေါင်းစပ်မှုပုံစံများ

ပုံစံ 1: ဝေလငါးစုဆောင်းမှုအပေါ် အချက်ပေးခြင်း

ဝေလငါးတည်နေရာများ အတိုင်းအတာတစ်ခုထက် ကျော်လွန်သောအခါ အချက်ပေးများကို သတ်မှတ်ပါ၊ ဤသည်မှာ ဈေးတက်မည့်အခြေအနေများ သို့မဟုတ် စုဆောင်းမှုအဆင့်များကို ညွှန်ပြနိုင်သည်။

ပုံစံ 2: ရန်ပုံငွေနှုန်းကွာခြားမှု ရှာဖွေခြင်း

ရန်ပုံငွေနှုန်းကွာခြားမှုများ အမြတ်အစွန်းရရှိမည့်အတိုင်းအတာထက် ကျော်လွန်သောအခါ အလိုအလျောက်ရှာဖွေပါ၊ ဤသည်မှာ ချိတ်ဆက်ဖလှယ်မှုများအကြား arbitrage algorithm များကို ဖြစ်နိုင်စေသည်။

ပုံစံ 3: အရည်အတွက်ဆက်တိုက်ဖြစ်မှု စောင့်ကြည့်ခြင်း

ကြီးမားသော အရည်အတွက်ဖြုန်းမှုများကို ခြေရာခံပြီး algorithm ကို ဆက်တိုက်ဖြစ်နေသော အရည်အတွက်ဖြုန်းမှုများနှင့် ကြီးမားသော ဈေးနှုန်းအပြောင်းအလဲများကို အခွင့်ကောင်းယူရန် နေရာချပါ။

ပုံစံ 4: အချက်ပြများအား အတည်ပြုခြင်း

ဝေလငါးတည်နေရာများ၊ ရန်ပုံငွေနှုန်းများ၊ on-chain metrics များနှင့် ကျွန်ုပ်တို့၏ AI အတည်ပြုအချက်များကို ပေါင်းစပ်ပြီး ယုံကြည်မှုမြင့်မားသော ဝင်ရောက်မှုအချက်ပြများအတွက် အသုံးပြုပါ။

စတင်ရန် အဆင်သင့်ဖြစ်ပြီလား?

သင့် API key ကို console မှ ရယူပြီး ယနေ့ပဲ စတင်တည်ဆောက်ပါ။ အသစ်ဖွင့်လှစ်ထားသော အကောင့်အားလုံးသည် တစ်နေ့လျှင် အခမဲ့ အသုံးပြုခွင့် 20 ကြိမ် (BTC, ETH, SOL) ရရှိမည်။ Trader သို့မဟုတ် Pro အဆင့်သို့ အဆင့်မြှင့်ပါက သင်္ကေတအားလုံးနှင့် အဆင့်မြင့်လုပ်ဆောင်ချက်များကို အကန့်အသတ်မရှိ အသုံးပြုနိုင်မည်။

API Key ရယူပါ

Pro Features များကို ဖွင့်ပါ

ဝေလငါးတည်နေရာများ၊ အတည်ပြုအချက်များ၊ on-chain data နှင့် တစ်နေ့လျှင် API ခေါ်ဆိုမှု 2000+ အပြည့်အဝ အသုံးပြုခွင့်ကို ရယူပါ။

စျေးနှုန်းကြည့်ပါ