Referensi REST API Lengkap

Kuasai Smart Money API dengan referensi REST komprehensif kami. Pelajari semua endpoint, parameter, metode autentikasi, dan pola integrasi dunia nyata untuk intelijen derivatif kripto dan data pelacakan whale.

Ikhtisar

Smart Money API menyediakan akses RESTful ke data derivatif kripto real-time di tiga bursa utama: Bybit, Binance, dan Hyperliquid. API kami mengagregasi posisi wallet whale, funding rates, metrik open interest, data likuidasi, dan sinyal on-chain ke dalam satu antarmuka terpadu. Baik Anda membangun algoritma trading, sistem manajemen risiko, atau alat analisis pasar, REST API memberi Anda akses programatik langsung ke semua intelijen Smart Money.

Dengan lebih dari 229 simbol trading yang ditemukan secara otomatis dan 600+ wallet whale yang dipantau, API ini menyediakan intelijen pasar yang komprehensif. Koneksi WebSocket real-time memberikan pembaruan dalam hitungan detik, sementara endpoint REST kami menangani kueri batch, pengambilan data historis, dan analisis portofolio dalam skala besar.

Semua permintaan harus menyertakan kredensial autentikasi yang valid. Pengguna tier gratis memiliki 100 permintaan per hari yang terbatas pada BTC. Tier trader (1,000 permintaan/hari) dan tier Pro (5.000 permintaan/hari) membuka semua simbol dan fitur canggih.

Autentikasi

Smart Money API menggunakan autentikasi kunci API. Metode utamanya adalah X-API-Key header permintaan. Anda dapat menghasilkan kunci API dari dashboard Anda. Sesi JWT melalui Authorization: Bearer diterima sebagai cadangan untuk sesi browser/dashboard, tetapi klien API harus menggunakan X-API-Key.

Autentikasi Kunci API (utama)

Kirim kunci API Anda di X-API-Key header pada setiap permintaan. Jangan pernah menaruh kunci Anda di URL.

HTTP

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

Sesi JWT (cadangan)

Sesi browser/dashboard dapat mengirimkan JWT sesi melalui Authorization: Bearer (valid selama 24 jam). Klien programatik sebaiknya menggunakan 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 Dasar & Endpoint

Semua permintaan API ditujukan ke https://api.smartmoneyapi.com. API diorganisir ke dalam kategori sumber daya logis dengan awalan versi. Versi stabil saat ini adalah v1.

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

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

Format Respons

Semua respons API dikembalikan sebagai objek JSON dengan format amplop standar. Respons yang berhasil mengembalikan kode status HTTP 200-299 dengan data di badan respons. Respons error mencakup pesan error detail dan saran resolusi.

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

Endpoint Posisi Whale

Ambil posisi detail dari wallet whale yang dipantau di semua bursa. Endpoint ini menunjukkan leverage real-time, harga masuk, harga likuidasi, dan P&L yang belum direalisasikan untuk posisi bernilai tinggi.

GET /v1/whales/events PRO

Parameter	Tipe	Deskripsi
symbol	string	Pasangan trading (contoh: BTCUSDT, ETHUSDT) opsional
exchange	string	Filter berdasarkan bursa: bybit, binance, hyperliquid opsional
min_position_size	number	Ukuran posisi minimum dalam aset dasar opsional
direction	string	Hanya posisi long atau short opsional
page	integer	Nomor halaman paginasi, default 1 opsional
limit	integer	Hasil per halaman, maks 100, default 50 opsional

Contoh Permintaan:

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"

Endpoint Funding Rates

Akses funding rates real-time dan historis di Bybit, Binance, dan Hyperliquid. Funding rates sangat penting untuk trading arbitrase, strategi swing, dan lindung nilai derivatif. API kami mengagregasi rates dengan granularitas 15 menit dan menyediakan analisis rates historis.

GET /v1/funding-rates FREE

Parameter	Tipe	Deskripsi
symbol	string	Pasangan trading (contoh: BTCUSDT) wajib
exchange	string	Bursa: bybit, binance, hyperliquid opsional
interval	string	1h, 4h, 1d, default 1h opsional
limit	integer	Periode historis yang dikembalikan, maks 500 opsional

Contoh Permintaan:

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

Endpoint Open Interest

Pantau total open interest dari semua trader leverage. Divergensi open interest dari pergerakan harga menandakan potensi pembalikan tren dan peluang kelanjutan tren. Lacak baik OI absolut maupun tingkat perubahan OI.

GET /v1/open-interest TRADER

Parameter	Tipe	Deskripsi
symbol	string	Pasangan trading wajib
exchange	string	bybit, binance, atau hyperliquid opsional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, default 15m opsional

Endpoint Likuidasi

Menampilkan dua pandangan komplementer untuk sebuah simbol: tingkat yang diproyeksikan leverage tingkat (perkiraan di mana kluster likuidasi berada) dan sebuah realized_heatmap — INTENSITAS likuidasi paksa yang BENAR-BENAR terjadi (harga × waktu) yang diagregasi secara langsung dari feed WebSocket bursa publik: Binance, OKX, Bybit, Bitget, dan BitMEX. Heatmap tersedia ketika stream memiliki data untuk simbol tersebut.

GET /v1/liquidations TRADER

Parameter	Tipe	Deskripsi
symbol	string	Simbol aset, default BTC opsional

Trader mengembalikan risiko kaskade, jarak terdekat, dan total/berdasarkan sisi yang direalisasikan. Pro mengembalikan proyeksi penuh level ditambah realized_heatmap (matriks, klaster per-harga, hitungan per-pertukaran).

On-Chain DeFi Liquidations

Eksekusi likuidasi protokol lending DeFi yang direkam langsung dari full node BSC dan Avalanche lokal kami — independen dari bot trading apa pun. Mencakup Venus/Cream dan Moolah di BSC, serta AAVE V3/V2, Benqi, BankerJoe, Granary, dan Vinium di Avalanche. Memerlukan kunci terautentikasi (Trader+); Pro juga mengembalikan posisi berisiko yang bergantung pada bot.

GET /v1/liquidations/onchain TRADER

Parameter	Tipe	Deskripsi
chain	string	bsc atau avax; kosongkan untuk semua opsional
limit	integer	Jumlah baris maksimum, default 100, maksimal 500 (terbaru-duluan) opsional

Endpoint Konfirmasi

The /v1/confirm endpoint mengembalikan skor konfluensi berbasis aturan dan multi-faktor konfluensi yang menggabungkan derivatif, on-chain (Coin Metrics gratis: MVRV / aliran pertukaran / alamat aktif), dan posisi paus. Skor komposit berkisar dari -1.0 hingga +1.0 (bukan 0–100) dan setiap respons mencakup rincian faktor yang transparan (skor per-leg × bobot), penyesuaian, bobot, dan cakupan. Ini adalah dukungan keputusan, bukan jaminan win-rate. Simbol yang tidak dilacak mengembalikan hasil NO_DATA / tidak didukung yang eksplisit, bukan LOW yang dibuat-buat.

GET /v1/confirm TRADER

Parameter: symbol (BTC/ETH/SOL) dan direction (long/short). confidence adalah HIGH / MEDIUM / LOW / VETO / NO_DATA; action adalah CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult adalah pengali ukuran posisi yang disarankan.

Endpoint Data On-Chain

Akses metrik on-chain Bitcoin dan Ethereum termasuk aliran pertukaran, pergerakan dompet paus, rasio MVRV, NUPL, kondisi pengeluaran, dan volatilitas terealisasi. Metrik ini mengidentifikasi siklus akumulasi/distribusi dan memberikan sinyal awal untuk pembalikan besar.

GET /v1/on-chain/metrics PRO

Parameter	Tipe	Deskripsi
asset	string	bitcoin atau ethereum wajib
metrics	array	Metrik spesifik: exchange_flows, mvrv, nupl, whale_moves opsional
interval	string	1d (harian), 1w (mingguan), default 1d opsional

Referensi Model Data

Memahami struktur respons API sangat penting untuk integrasi. Di bawah ini adalah definisi model data lengkap yang digunakan di semua endpoint.

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

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

Contoh Kode

Di bawah ini adalah contoh kode siap produksi untuk pola integrasi umum.

Pantau Posisi Whale dengan 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:
        """Ambil posisi whale dengan filter simbol opsional"""
        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:
        """Dapatkan tingkat funding saat ini dan historis"""
        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):
        """Pantau posisi whale secara terus-menerus"""
        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)

# Penggunaan
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Total posisi whale: {whales['data']['total']}")

Praktik Terbaik & Tips Performa

Gunakan paginasi: Selalu paginasi hasil yang besar. Gunakan parameter limit dan page untuk mengambil data dalam kelompok 50-100 record, bukan sekaligus.

Cache respons: Posisi whale tidak berubah setiap detik. Cache hasil selama 30-60 detik untuk mengurangi panggilan API dan meningkatkan performa.

Filter sejak awal: Gunakan parameter query (symbol, exchange, direction) untuk memfilter data di sisi server, bukan di kode aplikasi Anda.

Tangani batas rate: Terapkan logika retry dengan exponential backoff. Ketika mencapai batas rate (status 429), tunggu dan coba lagi.

Gunakan WebSocket untuk real-time: Untuk data streaming, lebih baik gunakan koneksi WebSocket daripada polling endpoint REST. Anda akan menghemat bandwidth dan mendapatkan latensi sub-detik.

Validasi timestamp: Semua timestamp dalam format ISO 8601 UTC. Selalu konversi ke zona waktu lokal Anda untuk tampilan dan simpan dalam UTC.

Tangani pemutusan koneksi: Terapkan logika reconnection otomatis dengan exponential backoff untuk koneksi WebSocket.

Pantau kuota Anda: Periksa header X-Requests-Remaining dalam respons. Rencanakan penggunaan API Anda untuk tetap dalam batas tier.

Pola Integrasi Umum

Pola 1: Alarm Akumulasi Whale

Siapkan alarm ketika posisi whale melebihi ambang batas, menandakan potensi bull run atau fase akumulasi.

Pola 2: Deteksi Arbitrase Tingkat Funding

Deteksi secara otomatis ketika selisih tingkat funding melebihi ambang batas yang menguntungkan di berbagai exchange, memungkinkan algoritma arbitrase lintas exchange.

Pola 3: Pemantauan Kaskade Likuidasi

Lacak likuidasi besar dan posisikan algoritma untuk memanfaatkan likuidasi beruntun dan pergerakan harga berdampak tinggi.

Pola 4: Konfirmasi Multi-Sinyal

Gabungkan posisi whale, tingkat funding, metrik on-chain, dan skor konfirmasi AI kami untuk sinyal masuk dengan keyakinan tinggi.

Siap Memulai?

Dapatkan kunci API Anda dari konsol dan mulai membangun hari ini. Semua akun baru mendapatkan akses tier gratis dengan 100 permintaan per hari (BTC, ETH, SOL). Tingkatkan ke Trader atau Pro untuk akses tak terbatas ke semua simbol dan fitur canggih.

Dapatkan Kunci API

Buka Fitur Pro

Dapatkan akses penuh ke posisi whale, skor konfirmasi, data on-chain, dan 2000+ permintaan API harian.

Lihat Harga