Tài liệu tham khảo REST API đầy đủ

Làm chủ Smart Money API với tài liệu tham khảo REST toàn diện của chúng tôi. Tìm hiểu tất cả các điểm cuối, tham số, phương pháp xác thực và các mẫu tích hợp thực tế để thu thập thông tin phái sinh tiền điện tử và dữ liệu theo dõi cá voi.

Tổng quan

Smart Money API cung cấp quyền truy cập RESTful vào dữ liệu phái sinh tiền điện tử thời gian thực trên ba sàn giao dịch lớn: Bybit, Binance và Hyperliquid. API của chúng tôi tổng hợp các vị thế ví cá voi, tỷ lệ tài trợ, số liệu lãi mở, dữ liệu thanh lý và các tín hiệu trên chuỗi vào một giao diện thống nhất duy nhất. Cho dù bạn đang xây dựng các thuật toán giao dịch, hệ thống quản lý rủi ro hay công cụ phân tích thị trường, REST API cung cấp cho bạn quyền truy cập lập trình trực tiếp vào tất cả thông tin thông minh của Smart Money.

Với hơn 229 ký hiệu giao dịch được tự động phát hiện và hơn 600 ví cá voi được theo dõi, API cung cấp thông tin thị trường toàn diện. Kết nối WebSocket thời gian thực cung cấp cập nhật trong vòng chưa đầy một giây, trong khi các điểm cuối REST của chúng tôi xử lý các truy vấn hàng loạt, truy xuất dữ liệu lịch sử và phân tích danh mục đầu tư ở quy mô lớn.

Tất cả các yêu cầu phải bao gồm thông tin xác thực hợp lệ. Người dùng miễn phí có 20 yêu cầu mỗi ngày giới hạn ở BTC. Cấp Trader (400 yêu cầu/ngày) và cấp Pro (4.000 yêu cầu/ngày) mở khóa tất cả các ký hiệu và các tính năng nâng cao.

Xác thực

Smart Money API sử dụng xác thực bằng khóa API. Phương pháp chính là X-API-Key tiêu đề yêu cầu. Bạn có thể tạo khóa API từ bảng điều khiển của mình. Một JWT phiên qua Authorization: Bearer được chấp nhận như một phương án dự phòng cho các phiên trình duyệt/bảng điều khiển, nhưng các ứng dụng API nên sử dụng X-API-Key.

Xác thực bằng khóa API (chính)

Gửi khóa API của bạn trong X-API-Key tiêu đề trên mỗi yêu cầu. Không bao giờ đặt khóa của bạn trong URL.

HTTP

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

JWT phiên (dự phòng)

Các phiên trình duyệt/bảng điều khiển có thể truyền một JWT phiên qua Authorization: Bearer (có hiệu lực trong 24 giờ). Các ứng dụng lập trình nên ưu tiên sử dụng X-API-Key.

Python

import requests
import json

# Lấy token JWT
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# Sử dụng JWT cho các yêu cầu tiếp theo
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

URL cơ sở & Điểm cuối

Tất cả các yêu cầu API được gửi đến https://api.smartmoneyapi.com. API được tổ chức thành các danh mục tài nguyên hợp lý với tiền tố phiên bản. Phiên bản ổn định hiện tại là v1.

URL cơ sở: https://api.smartmoneyapi.com/api/v1

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

Định dạng phản hồi

Tất cả các phản hồi API được trả về dưới dạng đối tượng JSON với định dạng phong bì tiêu chuẩn. Các phản hồi thành công trả về mã trạng thái HTTP 200-299 với dữ liệu trong phần thân phản hồi. Các phản hồi lỗi bao gồm thông báo lỗi chi tiết và các gợi ý giải quyết.

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

Điểm cuối Vị thế Cá voi

Truy xuất các vị thế chi tiết từ các ví cá voi được theo dõi trên tất cả các sàn giao dịch. Điểm cuối này hiển thị đòn bẩy thời gian thực, giá vào lệnh, giá thanh lý và lãi/lỗ chưa thực hiện cho các vị thế có giá trị cao.

GET /v1/whales/events PRO

Tham số	Loại	Mô tả
symbol	chuỗi	Cặp giao dịch (ví dụ: BTCUSDT, ETHUSDT) tùy chọn
exchange	chuỗi	Lọc theo sàn giao dịch: bybit, binance, hyperliquid tùy chọn
min_position_size	số	Kích thước vị thế tối thiểu bằng tài sản cơ sở tùy chọn
direction	chuỗi	Chỉ các vị thế long hoặc short tùy chọn
page	số nguyên	Số trang phân trang, mặc định là 1 tùy chọn
limit	số nguyên	Kết quả mỗi trang, tối đa 100, mặc định là 50 tùy chọn

Ví dụ yêu cầu:

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"

Điểm cuối Tỷ lệ Tài trợ

Truy cập tỷ lệ tài trợ thời gian thực và lịch sử trên Bybit, Binance và Hyperliquid. Tỷ lệ tài trợ rất quan trọng cho giao dịch chênh lệch giá, chiến lược swing và phòng ngừa rủi ro phái sinh. API của chúng tôi tổng hợp các tỷ lệ với độ chi tiết 15 phút và cung cấp phân tích tỷ lệ lịch sử.

GET /v1/funding-rates MIỄN PHÍ

Tham số	Loại	Mô tả
symbol	chuỗi	Cặp giao dịch (ví dụ: BTCUSDT) bắt buộc
exchange	chuỗi	Sàn giao dịch: bybit, binance, hyperliquid tùy chọn
interval	chuỗi	1h, 4h, 1d, mặc định là 1h tùy chọn
limit	số nguyên	Các khoảng thời gian lịch sử để trả về, tối đa 500 tùy chọn

Ví dụ yêu cầu:

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

Điểm cuối Lãi suất Tài trợ

Theo dõi tổng lãi suất tài trợ trên tất cả các nhà giao dịch đòn bẩy. Sự phân kỳ lãi suất tài trợ so với biến động giá báo hiệu các cơ hội đảo chiều và tiếp tục xu hướng. Theo dõi cả lãi suất tài trợ tuyệt đối và tỷ lệ thay đổi lãi suất tài trợ.

GET /v1/funding-rates TRADER

Tham số	Loại	Mô tả
symbol	string	Cặp giao dịch bắt buộc
exchange	string	bybit, binance, hoặc hyperliquid tùy chọn
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, mặc định 15m tùy chọn

Điểm cuối Thanh lý

Trả về hai góc nhìn bổ sung cho một cặp giao dịch: mức dự đoán đòn bẩy mức (ước tính vị trí các cụm thanh lý) và một realized_heatmap — CƯỜNG ĐỘ thanh lý bắt buộc THỰC TẾ (giá × thời gian) được tổng hợp trực tiếp từ các luồng WebSocket công khai của các sàn giao dịch: Binance, OKX, Bybit, Bitget, và BitMEX. Biểu đồ nhiệt sẽ hiển thị khi luồng có dữ liệu cho cặp giao dịch.

GET /v1/liquidations TRADER

Tham số	Loại	Mô tả
symbol	string	Ký hiệu tài sản, mặc định BTC tùy chọn

Trader trả về rủi ro dây chuyền, khoảng cách gần nhất và tổng số/ theo phía. Pro trả về đầy đủ các mức dự đoán mức cộng với toàn bộ realized_heatmap (ma trận, các cụm theo giá, số lượng theo sàn).

Thanh lý On-Chain DeFi

Các khoản thanh lý giao thức cho vay DeFi được thực hiện trực tiếp từ các nút đầy đủ BSC và Avalanche của chúng tôi — độc lập với bất kỳ bot giao dịch nào. Bao gồm Venus/Cream và Moolah trên BSC, và AAVE V3/V2, Benqi, BankerJoe, Granary và Vinium trên Avalanche. Yêu cầu một khóa xác thực (Trader+); Pro thêm vào đó trả về các vị thế có rủi ro phụ thuộc vào bot.

GET /v1/liquidations/onchain TRADER

Tham số	Loại	Mô tả
chain	string	bsc hoặc avax; bỏ qua để chọn tất cả tùy chọn
limit	integer	Số hàng tối đa, mặc định 100, tối đa 500 (mới nhất trước) tùy chọn

Điểm cuối Xác nhận

Điểm cuối /v1/confirm trả về một điểm số đa yếu tố dựa trên quy tắc confluence kết hợp các công cụ phái sinh, on-chain (Coin Metrics miễn phí: MVRV / dòng chảy sàn giao dịch / địa chỉ hoạt động), và vị thế cá voi. Điểm số composite dao động từ -1.0 đến +1.0 (không phải 0–100) và mỗi phản hồi bao gồm một factors phân tích rõ ràng (điểm số từng yếu tố × trọng số), adjustments, trọng số, và coverage. Đây là hỗ trợ quyết định, không phải một tỷ lệ thắng đảm bảo. Một cặp giao dịch không được theo dõi sẽ trả về kết quả NO_DATA / không hỗ trợ rõ ràng thay vì một giá trị LOW giả tạo.

GET /v1/confirm TRADER

Các tham số: symbol (BTC/ETH/SOL) và direction (long/short). confidence là một trong các giá trị HIGH / MEDIUM / LOW / VETO / NO_DATA; action là một trong các giá trị CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult là hệ số nhân kích thước vị thế được đề xuất.

Các Điểm cuối Dữ liệu On-Chain

Truy cập các chỉ số on-chain của Bitcoin và Ethereum bao gồm dòng chảy sàn giao dịch, di chuyển ví cá voi, tỷ lệ MVRV, NUPL, điều kiện chi tiêu và biến động thực tế. Các chỉ số này xác định các chu kỳ tích lũy/phân phối và cung cấp các tín hiệu sớm cho các đảo chiều lớn.

GET /v1/on-chain/metrics PRO

Tham số	Loại	Mô tả
asset	string	bitcoin hoặc ethereum bắt buộc
metrics	array	Các chỉ số cụ thể: exchange_flows, mvrv, nupl, whale_moves tùy chọn
interval	string	1d (hàng ngày), 1w (hàng tuần), mặc định 1d tùy chọn

Tham khảo Mô hình Dữ liệu

Hiểu cấu trúc của các phản hồi API là điều cần thiết để tích hợp. Dưới đây là các định nghĩa mô hình dữ liệu hoàn chỉnh được sử dụng trên tất cả các điểm cuối.

Đối tượng 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"
}

Đối tượng 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
  }
}

Ví dụ mã

Dưới đây là các ví dụ mã sẵn sàng cho sản xuất cho các mẫu tích hợp phổ biến.

Giám sát Vị thế Cá voi bằng 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:
        """Lấy vị thế cá voi với bộ lọc ký hiệu tùy chọn"""
        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:
        """Lấy tỷ lệ tài trợ hiện tại và lịch sử"""
        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):
        """Liên tục giám sát vị thế cá voi"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Cá voi {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Cách sử dụng
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Tổng vị thế cá voi: {whales['data']['total']}")

Thực hành Tốt nhất & Mẹo Hiệu suất

Sử dụng phân trang: Luôn phân trang các tập kết quả lớn. Sử dụng tham số limit và page để lấy dữ liệu theo từng phần 50-100 bản ghi, không phải tất cả dữ liệu cùng một lúc.

Lưu trữ phản hồi: Vị thế cá voi không thay đổi mỗi giây. Lưu trữ kết quả trong 30-60 giây để giảm số lần gọi API và cải thiện hiệu suất.

Lọc sớm: Sử dụng các tham số truy vấn (symbol, exchange, direction) để lọc dữ liệu phía máy chủ, không phải trong mã ứng dụng của bạn.

Xử lý giới hạn tốc độ: Triển khai logic thử lại với thời gian chờ tăng dần. Khi bạn chạm giới hạn tốc độ (trạng thái 429), hãy chờ và thử lại.

Sử dụng WebSocket cho thời gian thực: Đối với dữ liệu truyền trực tuyến, ưu tiên kết nối WebSocket hơn là các điểm cuối REST. Bạn sẽ tiết kiệm băng thông và có độ trễ dưới một giây.

Xác thực dấu thời gian: Tất cả dấu thời gian đều theo chuẩn ISO 8601 UTC. Luôn chuyển đổi sang múi giờ địa phương để hiển thị và luôn lưu trữ ở UTC.

Xử lý ngắt kết nối: Triển khai logic kết nối lại tự động với thời gian chờ tăng dần cho các kết nối WebSocket.

Giám sát hạn ngạch của bạn: Kiểm tra tiêu đề X-Requests-Remaining trong phản hồi. Lập kế hoạch sử dụng API của bạn để duy trì trong giới hạn cấp độ của bạn.

Các Mẫu Tích hợp Phổ biến

Mẫu 1: Cảnh báo khi Cá voi Tích lũy

Thiết lập cảnh báo khi vị thế cá voi tăng vượt ngưỡng, báo hiệu các đợt tăng giá tiềm năng hoặc giai đoạn tích lũy.

Mẫu 2: Phát hiện Chênh lệch Tỷ lệ Tài trợ

Tự động phát hiện khi chênh lệch tỷ lệ tài trợ vượt ngưỡng có lợi nhuận trên các sàn giao dịch, cho phép các thuật toán arbitrage liên sàn.

Mẫu 3: Giám sát Hiệu ứng Domino Thanh lý

Theo dõi các lệnh thanh lý lớn và định vị thuật toán để tận dụng các đợt thanh lý dây chuyền và các biến động giá có tác động lớn.

Mẫu 4: Xác nhận Đa Tín hiệu

Kết hợp vị thế cá voi, tỷ lệ tài trợ, số liệu on-chain và điểm xác nhận AI của chúng tôi cho các tín hiệu vào lệnh có độ tin cậy cao.

Sẵn sàng Bắt đầu?

Lấy khóa API từ bảng điều khiển và bắt đầu xây dựng ngay hôm nay. Tất cả tài khoản mới được miễn phí truy cập với 20 yêu cầu mỗi ngày (BTC, ETH, SOL). Nâng cấp lên Trader hoặc Pro để truy cập không giới hạn vào tất cả các ký hiệu và tính năng nâng cao.

Lấy Khóa API

Mở Khóa Tính năng Pro

Truy cập đầy đủ vào vị thế cá voi, điểm xác nhận, dữ liệu on-chain và 2000+ yêu cầu API mỗi ngày.

Xem Giá