Rujukan API REST Lengkap

Kuasa Smart Money API dengan rujukan REST komprehensif kami. Pelajari semua titik akhir, parameter, kaedah pengesahan, dan corak integrasi dunia sebenar untuk data kecerdasan derivatif kripto dan penjejakan paus.

Gambaran Keseluruhan

Smart Money API menyediakan akses RESTful kepada data derivatif kripto masa nyata merentasi tiga pertukaran utama: Bybit, Binance, dan Hyperliquid. API kami menggabungkan posisi dompet paus, kadar pembiayaan, metrik minat terbuka, data pencairan, dan isyarat on-chain ke dalam satu antara muka bersepadu. Sama ada anda membina algoritma perdagangan, sistem pengurusan risiko, atau alat analisis pasaran, API REST memberi anda akses pengaturcaraan langsung kepada semua kecerdasan Smart Money.

Dengan lebih daripada 229 simbol perdagangan yang ditemui secara automatik dan 600+ dompet paus yang dipantau, API menyediakan kecerdasan pasaran yang komprehensif. Sambungan WebSocket masa nyata memberikan kemas kini sub-saat, manakala titik akhir REST kami mengendalikan pertanyaan kelompok, pengambilan data sejarah, dan analisis portfolio pada skala.

Semua permintaan mesti termasuk kelayakan pengesahan yang sah. Pengguna peringkat percuma mempunyai 100 permintaan sehari terhad kepada BTC. Peringkat peniaga (1,000 permintaan/hari) dan peringkat Pro (5,000 permintaan/hari) membuka kunci semua simbol dan ciri lanjutan.

Pengesahan

Smart Money API menggunakan pengesahan kunci API. Kaedah utama ialah X-API-Key header permintaan. Anda boleh menjana kunci API dari papan pemuka anda. Sesi JWT melalui Authorization: Bearer diterima sebagai sandaran untuk sesi pelayar/papan pemuka, tetapi klien API harus menggunakan X-API-Key.

Pengesahan Kunci API (utama)

Hantar kunci API anda dalam X-API-Key header pada setiap permintaan. Jangan letakkan kunci anda dalam 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 (sandaran)

Sesi pelayar/papan pemuka boleh menghantar JWT sesi melalui Authorization: Bearer (sah selama 24 jam). Klien pengaturcaraan harus lebih suka X-API-Key.

Python

import requests
import json

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

# Gunakan JWT untuk permintaan seterusnya
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

URL Asas & Titik Akhir

Semua permintaan API pergi ke https://api.smartmoneyapi.com. API disusun ke dalam kategori sumber logik dengan awalan versi. Versi stabil semasa ialah v1.

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

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

Format Respons

Semua respons API dikembalikan sebagai objek JSON dengan format sampul standard. Respons berjaya mengembalikan kod status HTTP 200-299 dengan data dalam badan respons. Respons ralat termasuk mesej ralat terperinci dan cadangan penyelesaian.

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

Titik Akhir Posisi Paus

Dapatkan posisi terperinci dari dompet paus yang dipantau merentasi semua pertukaran. Titik akhir ini menunjukkan leverage masa nyata, harga kemasukan, harga pencairan, dan P&L tidak direalisasikan untuk posisi bernilai tinggi.

GET /v1/whales/events PRO

Parameter	Jenis	Penerangan
symbol	string	Pasangan dagangan (cth., BTCUSDT, ETHUSDT) optional
exchange	string	Tapis mengikut pertukaran: bybit, binance, hyperliquid optional
min_position_size	number	Saiz posisi minimum dalam aset asas optional
direction	string	Posisi long atau short sahaja optional
page	integer	Nombor halaman penomboran, lalai 1 optional
limit	integer	Keputusan setiap halaman, maks 100, lalai 50 optional

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"

Titik Akhir Kadar Pembiayaan

Akses kadar pembiayaan masa nyata dan sejarah merentasi Bybit, Binance, dan Hyperliquid. Kadar pembiayaan adalah kritikal untuk perdagangan arbitraj, strategi swing, dan lindung nilai derivatif. API kami menggabungkan kadar dengan granulariti 15 minit dan menyediakan analisis kadar sejarah.

GET /v1/funding-rates FREE

Parameter	Jenis	Penerangan
symbol	string	Pasangan dagangan (cth., BTCUSDT) required
exchange	string	Pertukaran: bybit, binance, hyperliquid optional
interval	string	1h, 4h, 1d, lalai 1h optional
limit	integer	Tempoh sejarah untuk dikembalikan, maks 500 optional

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 Minat Terbuka

Pantau minat terbuka agregat merentasi semua peniaga leverage. Percanggahan minat terbuka daripada pergerakan harga menandakan potensi pembalikan dan peluang kesinambungan trend. Jejaki kedua-dua OI mutlak dan kadar perubahan OI.

GET /v1/open-interest PEDAGANG

Parameter	Jenis	Penerangan
symbol	string	Pasangan dagangan wajib
exchange	string	bybit, binance, atau hyperliquid pilihan
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, lalai 15m pilihan

Endpoint Pelaksanaan

Mengembalikan dua pandangan pelengkap untuk simbol: tahap unjuran-leverage tahap (anggaran di mana kelompok pelaksanaan berada) dan realized_heatmap — intensiti pelaksanaan paksa SEBENAR (harga × masa) yang dikumpulkan secara langsung daripada suapan WebSocket awam pertukaran: Binance, OKX, Bybit, Bitget, dan BitMEX. Heatmap hadir apabila strim mempunyai data untuk simbol tersebut.

GET /v1/liquidations PEDAGANG

Parameter	Jenis	Penerangan
symbol	string	Simbol aset, lalai BTC pilihan

Pedagang mengembalikan risiko lata, jarak terdekat, dan jumlah/demi sisi yang direalisasikan. Pro mengembalikan unjuran penuh tahap tambah penuh realized_heatmap (matriks, per-kluster harga, kiraan per-pertukaran).

Pelaksanaan On-Chain DeFi

Pelaksanaan protokol pinjaman DeFi yang dilaksanakan diambil terus daripada nod penuh BSC dan Avalanche tempatan kami — bebas daripada sebarang bot dagangan. Meliputi Venus/Cream dan Moolah di BSC, dan AAVE V3/V2, Benqi, BankerJoe, Granary dan Vinium di Avalanche. Memerlukan kunci pengesahan (Pedagang+); Pro tambahan mengembalikan posisi berisiko bergantung pada bot.

GET /v1/liquidations/onchain PEDAGANG

Parameter	Jenis	Penerangan
chain	string	bsc atau avax; abaikan untuk semua pilihan
had	integer	Maksimum baris, lalai 100, maksimum 500 (terbaru-dahulu) pilihan

Endpoint Pengesahan

The /v1/confirm endpoint mengembalikan skor berdasarkan peraturan, multi-faktor konfluens yang menggabungkan derivatif, on-chain (percuma Coin Metrics: MVRV / aliran pertukaran / alamat aktif), dan posisi ikan paus. The komposit berkisar dari -1.0 hingga +1.0 (bukan 0–100) dan setiap respons termasuk faktor pemecahan (skor per-leg × berat), pelarasan, berat, dan liputan. Ia adalah sokongan keputusan, bukan kadar kemenangan yang dijamin. Simbol yang tidak dikesan mengembalikan hasil NO_DATA / tidak disokong yang eksplisit dan bukannya LOW yang direka.

GET /v1/confirm TRADER

Parameter: symbol (BTC/ETH/SOL) dan direction (long/short). confidence adalah salah satu daripada HIGH / MEDIUM / LOW / VETO / NO_DATA; action adalah salah satu daripada CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult adalah pengganda saiz posisi yang dicadangkan.

Endpoint Data On-Chain

Akses metrik on-chain Bitcoin dan Ethereum termasuk aliran pertukaran, pergerakan dompet ikan paus, nisbah MVRV, NUPL, keadaan perbelanjaan, dan turun naik yang direalisasikan. Metrik ini mengenal pasti kitaran pengumpulan/pengagihan dan memberikan isyarat awal untuk pembalikan utama.

GET /v1/on-chain/metrics PRO

Parameter	Type	Description
asset	string	bitcoin atau ethereum required
metrics	array	Metrik khusus: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (harian), 1w (mingguan), lalai 1d optional

Rujukan Model Data

Memahami struktur respons API adalah penting untuk integrasi. Di bawah 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 Kod

Di bawah adalah contoh kod siap pengeluaran untuk corak integrasi biasa.

Pantau Posisi Paus dalam 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:
        """Dapatkan posisi paus dengan penapis simbol pilihan"""
        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 kadar pembiayaan semasa dan sejarah"""
        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 paus secara berterusan"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Paus {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"Jumlah posisi paus: {whales['data']['total']}")

Amalan Terbaik & Tip Prestasi

Gunakan penomboran halaman: Sentiasa nomborkan halaman set hasil yang besar. Gunakan parameter limit dan page untuk mengambil data dalam kelompok 50-100 rekod, bukan semua data sekaligus.

Simpan respons dalam cache: Posisi paus tidak berubah setiap saat. Simpan hasil dalam cache selama 30-60 saat untuk mengurangkan panggilan API dan meningkatkan prestasi.

Tapis awal: Gunakan parameter pertanyaan (symbol, exchange, direction) untuk menapis data di sebelah pelayan, bukan dalam kod aplikasi anda.

Urus had kadar: Laksanakan logik percubaan semula dengan pelemahan eksponen. Apabila mencapai had kadar (status 429), tunggu dan cuba semula.

Gunakan WebSocket untuk masa nyata: Untuk data strim, lebihkan sambungan WebSocket berbanding pengundian titik akhir REST. Anda akan menjimatkan lebar jalur dan mendapat latensi sub-saat.

Sahkan cap masa: Semua cap masa adalah ISO 8601 UTC. Sentiasa tukar ke zon waktu tempatan untuk paparan dan sentiasa simpan dalam UTC.

Urus putus sambungan: Laksanakan logik penyambungan semula automatik dengan pelemahan eksponen untuk sambungan WebSocket.

Pantau kuota anda: Periksa pengepala X-Requests-Remaining dalam respons. Rancang penggunaan API anda untuk kekal dalam had tahap anda.

Corak Integrasi Biasa

Pola 1: Amaran pada Pengumpulan Paus

Tetapkan amaran apabila posisi paus meningkat melebihi ambang, menandakan potensi kenaikan harga atau fasa pengumpulan.

Pola 2: Pengesanan Arbitraj Kadar Pembiayaan

Mengesan secara automatik apabila perbezaan kadar pembiayaan melebihi ambang yang menguntungkan merentasi pertukaran, membolehkan algoritma arbitraj merentasi pertukaran.

Pola 3: Pemantauan Kaskad Pelunasan

Mengesan pelunasan besar dan memposisikan algoritma untuk mengambil kesempatan daripada pelunasan berturutan dan pergerakan harga berimpak tinggi.

Pola 4: Pengesahan Isyarat Berganda

Gabungkan posisi paus, kadar pembiayaan, metrik on-chain, dan skor pengesahan AI kami untuk isyarat kemasukan dengan keyakinan tinggi.

Sedia untuk Bermula?

Dapatkan kunci API anda dari konsol dan mula membina hari ini. Semua akaun baru mendapat akses peringkat percuma dengan 100 permintaan sehari (BTC, ETH, SOL). Naik taraf ke Trader atau Pro untuk akses tanpa had kepada semua simbol dan ciri lanjutan.

Dapatkan Kunci API

Buka Kunci Ciri Pro

Dapatkan akses penuh kepada posisi paus, skor pengesahan, data on-chain, dan 2000+ permintaan API harian.

Lihat Harga