Complete REST API Reference

Master the Smart Money API with our comprehensive REST reference. Learn all endpoints, parameters, authentication methods, and real-world integration patterns for crypto derivatives intelligence and whale tracking data.

Overview

The Smart Money API provides RESTful access to real-time cryptocurrency derivatives data across three major exchanges: Bybit, Binance, and Hyperliquid. Our API aggregates whale wallet positions, funding rates, open interest metrics, liquidation data, and on-chain signals into a single unified interface. Whether you're building trading algorithms, risk management systems, or market analysis tools, the REST API gives you direct programmatic access to all Smart Money intelligence.

With over 229 auto-discovered trading symbols and 600+ monitored whale wallets, the API provides comprehensive market intelligence. Real-time WebSocket connections deliver sub-second updates, while our REST endpoints handle batch queries, historical data retrieval, and portfolio analysis at scale.

All requests must include valid authentication credentials. Free tier users have 200 requests per day limited to BTC. Trader tier (1,000 requests/day) and Pro tier (5,000 requests/day) unlock all symbols and advanced features.

Authentication

The Smart Money API uses API key authentication. The primary method is the X-API-Key request header. You can generate API keys from your dashboard. A session JWT via Authorization: Bearer is accepted as a fallback for browser/dashboard sessions, but API clients should use X-API-Key.

API Key Authentication (primary)

Send your API key in the X-API-Key header on every request. Never put your key in a URL.

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 may pass a session JWT via Authorization: Bearer (valid for 24 hours). Programmatic clients should prefer 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

All API requests go to https://api.smartmoneyapi.com. The API is organized into logical resource categories with version prefixes. Current stable version is v1.

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

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

Response Format

All API responses are returned as JSON objects with a standard envelope format. Successful responses return HTTP 200-299 status codes with data in the response body. Error responses include detailed error messages and 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

Retrieve detailed positions from monitored whale wallets across all exchanges. This endpoint shows real-time leverage, entry prices, liquidation prices, and unrealized P&L for high-value positions.

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

Access real-time and historical funding rates across Bybit, Binance, and Hyperliquid. Funding rates are critical for arbitrage trading, swing strategies, and derivatives hedging. Our API aggregates rates with 15-minute granularity and provides 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

ตรวจสอบ Open Interest รวมของผู้ค้าเลเวอเรจทั้งหมด ความแตกต่างของ Open Interest จากแนวโน้มราคาสามารถบ่งชี้โอกาสการกลับตัวหรือต่อเนื่องของเทรนด์ ติดตามทั้งค่า Open Interest แบบสัมบูรณ์และอัตราการเปลี่ยนแปลง

GET /v1/open-interest TRADER

พารามิเตอร์	ประเภท	คำอธิบาย
symbol	string	คู่เทรด required
exchange	string	bybit, binance, หรือ hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, ค่าเริ่มต้น 15m optional

จุดสิ้นสุด Liquidations

ส่งกลับข้อมูลสองมุมมองสำหรับสัญลักษณ์: ระดับที่คาดการณ์จากเลเวอเรจ levels (ประมาณการตำแหน่งกลุ่ม liquidation) และ realized_heatmap — ความเข้มข้นของการ liquidation ที่เกิดขึ้นจริง (ราคา × เวลา) ที่รวมจากเว็บซ็อกเก็ตของ交易所สาธารณะ: Binance, OKX, Bybit, Bitget และ BitMEX heatmap จะแสดงเมื่อมีข้อมูลสำหรับสัญลักษณ์นั้น

GET /v1/liquidations TRADER

พารามิเตอร์	ประเภท	คำอธิบาย
symbol	string	สัญลักษณ์สินทรัพย์, ค่าเริ่มต้น BTC optional

Trader ส่งกลับความเสี่ยงแบบต่อเนื่อง, ระยะทางที่ใกล้ที่สุด, และผลรวม/ด้านที่เกิดขึ้นจริง Pro ส่งกลับระดับที่คาดการณ์ทั้งหมด levels รวมถึง realized_heatmap (เมทริกซ์, กลุ่มต่อราคา, นับต่อ交易所)

On-Chain DeFi Liquidations

การ liquidation จากโปรโตคอล DeFi ที่บันทึกจากโหนดเต็มของ BSC และ Avalanche ของเราเอง — ไม่ขึ้นกับบอทเทรด ครอบคลุม Venus/Cream และ Moolah บน BSC และ AAVE V3/V2, Benqi, BankerJoe, Granary และ Vinium บน Avalanche ต้องใช้คีย์ที่ตรวจสอบสิทธิ์ (Trader+); Pro ส่งกลับตำแหน่งที่มีความเสี่ยงที่ขึ้นกับบอทเพิ่มเติม

GET /v1/liquidations/onchain TRADER

พารามิเตอร์	ประเภท	คำอธิบาย
chain	string	bsc หรือ avax; ไม่ระบุสำหรับทั้งหมด optional
limit	integer	จำนวนแถวสูงสุด, ค่าเริ่มต้น 100, สูงสุด 500 (ใหม่สุดก่อน) optional

จุดสิ้นสุด Confirmation

จุดสิ้นสุด /v1/confirm ส่งกลับคะแนน confluence แบบหลายปัจจัยตามกฎ confluence ที่รวมข้อมูลอนุพันธ์, on-chain (Coin Metrics ฟรี: MVRV / exchange-flow / active-address) และตำแหน่งวอลเล็ตใหญ่ ค่า composite อยู่ระหว่าง -1.0 ถึง +1.0 (ไม่ใช่ 0–100) และทุกการตอบกลับรวมการแบ่ง factors อย่างโปร่งใส (คะแนนต่อส่วน × น้ำหนัก) adjustments, น้ำหนัก, และ coverage. เป็นเครื่องมือสนับสนุนการตัดสินใจ ไม่รับประกันอัตราชนะ สัญลักษณ์ที่ไม่มีข้อมูลจะส่งกลับผลลัพธ์ NO_DATA / ไม่รองรับ แทนที่จะเป็นค่า LOW ที่สร้างขึ้น

GET /v1/confirm TRADER

พารามิเตอร์: 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 เป็นตัวคูณขนาดตำแหน่งที่แนะนำ

จุดสิ้นสุดข้อมูล On-Chain

เข้าถึงเมตริก on-chain ของ Bitcoin และ 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

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

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:
        """รับอัตรา funding ปัจจุบันและย้อนหลัง"""
        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 เพื่อดึงข้อมูลทีละ 50-100 รายการ แทนที่จะดึงทั้งหมดพร้อมกัน

แคชผลลัพธ์: ตำแหน่งวาฬไม่เปลี่ยนแปลงทุกวินาที แคชผลลัพธ์ไว้ 30-60 วินาทีเพื่อลดการเรียก API และเพิ่มประสิทธิภาพ

กรองข้อมูลตั้งแต่ต้น: ใช้พารามิเตอร์คำถาม (symbol, exchange, direction) เพื่อกรองข้อมูลฝั่งเซิร์ฟเวอร์ แทนที่จะกรองในโค้ดแอปพลิเคชัน

จัดการการจำกัดอัตรา: ใช้ลอจิกการลองใหม่แบบ exponential backoff เมื่อเจอการจำกัดอัตรา (สถานะ 429) ให้รอแล้วลองใหม่

ใช้ WebSocket สำหรับข้อมูลเรียลไทม์: สำหรับข้อมูลสตรีมมิง ควรใช้การเชื่อมต่อ WebSocket แทนการ polling ผ่าน REST API จะช่วยประหยัด bandwidth และได้ latency ต่ำกว่าวินาที

ตรวจสอบเวลา: เวลาทั้งหมดเป็นรูปแบบ ISO 8601 UTC ควรแปลงเป็นเขตเวลาท้องถิ่นสำหรับการแสดงผล และเก็บไว้ใน UTC เสมอ

จัดการการตัดการเชื่อมต่อ: ใช้ลอจิกการเชื่อมต่อใหม่อัตโนมัติแบบ exponential backoff สำหรับการเชื่อมต่อ WebSocket

ตรวจสอบโควต้า: ตรวจสอบหัวข้อ X-Requests-Remaining ใน response วางแผนการใช้งาน API ให้อยู่ในขีดจำกัดระดับของคุณ

รูปแบบการเชื่อมต่อทั่วไป

รูปแบบที่ 1: แจ้งเตือนเมื่อวาฬสะสม

ตั้งการแจ้งเตือนเมื่อตำแหน่งวาฬเพิ่มเกินเกณฑ์ที่กำหนด ซึ่งอาจสัญญาณถึงการเริ่มต้นขาขึ้นหรือช่วงสะสม

รูปแบบที่ 2: การตรวจจับอาร์บิทราจอัตรา funding

ตรวจจับอัตโนมัติเมื่อความแตกต่างของอัตรา funding ระหว่าง exchange เกินเกณฑ์ที่ทำกำไรได้ เพื่อเปิดใช้งานอัลกอริทึมอาร์บิทราจข้าม exchange

รูปแบบที่ 3: การติดตามการล้างพอร์ตแบบต่อเนื่อง

ติดตามการล้างพอร์ตขนาดใหญ่ และตั้งอัลกอริทึมเพื่อใช้ประโยชน์จากการล้างพอร์ตต่อเนื่องและการเคลื่อนไหวของราคาที่มีผลกระทบสูง

รูปแบบที่ 4: การยืนยันด้วยหลายสัญญาณ

รวมตำแหน่งวาฬ อัตรา funding ข้อมูล on-chain และคะแนนยืนยันจาก AI ของเราเพื่อสัญญาณเข้าที่มีความมั่นใจสูง

พร้อมเริ่มต้นแล้วหรือยัง?

รับคีย์ API จากคอนโซลและเริ่มสร้างวันนี้ บัญชีใหม่ทุกบัญชีได้รับสิทธิ์ใช้งานระดับฟรี 20 คำขอต่อวัน (BTC, ETH, SOL) อัปเกรดเป็น Trader หรือ Pro เพื่อเข้าถึงสัญลักษณ์ทั้งหมดและฟีเจอร์ขั้นสูงแบบไม่จำกัด

รับคีย์ API

ปลดล็อกฟีเจอร์ระดับ Pro

เข้าถึงเต็มรูปแบบถึงตำแหน่งวาฬ คะแนนยืนยัน ข้อมูล on-chain และคำขอ API มากกว่า 2000 ครั้งต่อวัน

ดูราคา