Teljes REST API Referencia

Ismerje meg a Smart Money API-t átfogó REST referenciánkkal. Ismerje meg az összes végpontot, paramétert, hitelesítési módszereket és valós integrációs mintákat a kriptó derivatív intelligenciához és bálna követési adatokhoz.

Áttekintés

A Smart Money API RESTful hozzáférést biztosít valós idejű kriptovaluta derivatív adatokhoz három nagy tőzsdén: Bybit, Binance és Hyperliquid. API-nk összesíti a bálna tárca pozíciókat, finanszírozási rátákat, nyitott kamat metrikákat, likvidációs adatokat és on-chain jeleket egy egységes felületre. Legyen szó kereskedési algoritmusok, kockázatkezelési rendszerek vagy piaci elemző eszközök fejlesztéséről, a REST API közvetlen programozott hozzáférést biztosít az összes Smart Money intelligenciához.

Több mint 229 automatikusan felismert kereskedési szimbólummal és 600+ figyelt bálna tárca mellett az API átfogó piaci intelligenciát nyújt. Valós idejű WebSocket kapcsolatok másodperc alatti frissítéseket biztosítanak, míg REST végpontjaink tömeges lekérdezéseket, történelmi adatlekéréseket és portfólió elemzéseket kezelnek nagy léptékben.

Minden kérés tartalmaznia kell érvényes hitelesítési hitelesítő adatokat. Az ingyenes szintű felhasználók napi 20 kéréssel rendelkeznek, amelyek BTC-re korlátozottak. A Trader szint (400 kérés/nap) és a Pro szint (4000 kérés/nap) feloldja az összes szimbólumot és fejlett funkciókat.

Hitelesítés

A Smart Money API API kulcs hitelesítést használ. Az elsődleges módszer a X-API-Key kérés fejléc. API kulcsokat generálhat az irányítópultjáról. Egy session JWT a Authorization: Bearer keresztül elfogadott tartalék megoldásként böngésző/irányítópult munkamenetekhez, de API klienseknek a X-API-Key.

API kulcs hitelesítés (elsődleges)

Küldje el API kulcsát a X-API-Key fejlécben minden kérésnél. Soha ne tegye a kulcsát URL-be.

HTTP

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

Session JWT (tartalék)

Böngésző/irányítópult munkamenetek átadhatnak egy session JWT-t a Authorization: Bearer keresztül (24 óráig érvényes). Programozott klienseknek előnyben részesíteniük kell a 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())

Alap URL & Végpontok

Minden API kérés a https://api.smartmoneyapi.comcímre megy. Az API logikai erőforrás kategóriákba van szervezve verzió előtagokkal. Az aktuális stabil verzió a v1.

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

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

Válasz formátum

Minden API válasz JSON objektumként tér vissza szabványos boríték formátumban. Sikeres válaszok HTTP 200-299 státusz kódokat adnak vissza az adatokkal a válasz törzsében. Hibás válaszok részletes hibaüzeneteket és megoldási javaslatokat tartalmaznak.

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

Bálnák pozíciói végpont

Kérje le a részletes pozíciókat a figyelt bálna tárca pozíciókból minden tőzsdén. Ez a végpont valós idejű tőkeáttételt, belépési árakat, likvidációs árakat és realizálatlan P&L-t mutat nagy értékű pozíciókhoz.

GET /v1/whales/events PRO

Paraméter	Típus	Leírás
symbol	string	Kereskedési pár (pl. BTCUSDT, ETHUSDT) opcionális
exchange	string	Szűrés tőzsde szerint: bybit, binance, hyperliquid opcionális
min_position_size	number	Minimális pozíció méret alap eszközben opcionális
direction	string	Csak hosszú vagy rövid pozíciók opcionális
page	integer	Oldalszámozás oldalszáma, alapértelmezett 1 opcionális
limit	integer	Eredmények oldalanként, maximum 100, alapértelmezett 50 opcionális

Példa kérés:

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"

Finanszírozási ráta végpont

Érjen el valós idejű és történelmi finanszírozási rátákat a Bybit, Binance és Hyperliquid tőzsdéken. A finanszírozási ráták kritikusak az arbitrázs kereskedéshez, swing stratégiákhoz és derivatív fedezethez. API-nk 15 perces részletességgel összesíti a rátákat és történelmi ráták elemzését biztosít.

GET /v1/funding-rates INGYENES

Paraméter	Típus	Leírás
symbol	string	Kereskedési pár (pl. BTCUSDT) kötelező
exchange	string	Tőzsde: bybit, binance, hyperliquid opcionális
interval	string	1h, 4h, 1d, alapértelmezett 1h opcionális
limit	integer	Történelmi időszakok visszaadása, maximum 500 opcionális

Példa kérés:

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

Nyitott pozíciók végpont

Figyelje meg az összes tőkeáttételes kereskedő nyitott pozícióinak összesítését. A nyitott pozíciók eltérése az ármozgástól potenciális fordulópontokat és trendfolytatási lehetőségeket jelezhet. Kövesse nyomon mind az abszolút nyitott pozíciókat, mind a nyitott pozíciók változási ütemét.

GET /v1/open-interest TRADER

Paraméter	Típus	Leírás
symbol	string	Kereskedési pár kötelező
exchange	string	bybit, binance, vagy hyperliquid opcionális
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, alapértelmezett 15m opcionális

Likvidációk végpont

Két kiegészítő nézetet ad vissza egy szimbólumra: tőkeáttétel-projektált szintek (becslés a likvidációs klaszterek helyéről) és egy realized_heatmap — a VALÓS kényszerlikvidációs intenzitás (ár × idő), amelyet nyilvános tőzsdei WebSocket adatfolyamokból aggregálunk élőben: Binance, OKX, Bybit, Bitget és BitMEX. A hőtérkép akkor jelenik meg, ha az adatfolyam rendelkezik adattal a szimbólumhoz.

GET /v1/liquidations TRADER

Paraméter	Típus	Leírás
symbol	string	Eszköz szimbólum, alapértelmezett BTC opcionális

Trader visszaadja a kaszkád kockázatot, legközelebbi távolságokat és a realizált összesítéseket/oldalanként. Pro visszaadja a teljes projektált szinteket plusz a teljes realized_heatmap (mátrixok, ár-klaszterenként, tőzsdénkénti számok).

On-Chain DeFi Likvidációk

Végrehajtott DeFi hitelprotokoll-likvidációk, amelyeket közvetlenül saját helyi BSC és Avalanche teljes csomópontjainkról rögzítünk — függetlenül bármely kereskedő bottól. Lehetőséget biztosít a Venus/Cream és Moolah figyelésére a BSC-n, valamint az AAVE V3/V2, Benqi, BankerJoe, Granary és Vinium figyelésére az Avalanche-on. Hitelesített kulcs szükséges (Trader+); a Pro emellett a botfüggő kockázatos pozíciókat is visszaadja.

GET /v1/liquidations/onchain TRADER

Paraméter	Típus	Leírás
chain	string	bsc vagy avax; hagyd üresen az összeshez opcionális
limit	integer	Maximális sorok száma, alapértelmezett 100, maximum 500 (legújabbak előre) opcionális

Megerősítés végpont

A /v1/confirm végpont egy szabályalapú, többtényezős konfluencia pontszámot ad vissza, amely kombinálja a derivatívákat, on-chain adatokat (ingyenes Coin Metrics: MVRV / exchange-flow / active-address) és bálna-pozicionálást. A kompozit érték -1.0 és +1.0 között mozog (nem 0–100), és minden válasz tartalmaz egy átlátható tényezők bontást (részpontszám × súly), kiigazításokat, súlyok, és lefedettséget. Ez döntéstámogatás, nem garantált nyerési arány. Egy nem követett szimbólum explicit NO_DATA / nem támogatott eredményt ad vissza egy gyártott LOW helyett.

GET /v1/confirm TRADER

Paraméterek: symbol (BTC/ETH/SOL) és direction (long/short). confidence a következők egyike: HIGH / MEDIUM / LOW / VETO / NO_DATA; action a következők egyike: CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult az ajánlott pozícióméret-szorzó.

On-Chain Adatvégpontok

Hozzáférés Bitcoin és Ethereum on-chain metrikákhoz, beleértve a tőzsdei áramlásokat, bálna pénztárca-mozgásokat, MVRV arányt, NUPL-t, kiadási feltételeket és realizált volatilitást. Ezek a metrikák az akkumulációs/elosztási ciklusokat azonosítják és korai jeleket adnak a nagyobb fordulópontokhoz.

GET /v1/on-chain/metrics PRO

Paraméter	Típus	Leírás
asset	string	bitcoin vagy ethereum kötelező
metrics	array	Specifikus metrikák: exchange_flows, mvrv, nupl, whale_moves opcionális
interval	string	1d (napi), 1w (heti), alapértelmezett 1d opcionális

Adatmodellek referenciája

Az API válaszok szerkezetének megértése elengedhetetlen az integrációhoz. Az alábbiakban találhatóak az összes végponton használt adatmodell-definíciók.

WhalePosition Objektum

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 Objektum

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

Kódpéldák

Az alábbiakban gyakori integrációs mintákhoz kész termelési kódpéldák találhatók.

Cetpozíciók monitorozása Pythonban

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:
        """Cetpozíciók lekérése opcionális szimbólumszűrővel"""
        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:
        """Jelenlegi és történelmi finanszírozási ráta lekérése"""
        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):
        """Cetpozíciók folyamatos monitorozása"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Cet {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Használat
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Összes cetpozíció: {whales['data']['total']}")

Ajánlott eljárások és teljesítménytippek

Használj oldalazást: Mindig oldalazd a nagy eredményhalmazokat. Használd a limit és page paramétereket, hogy 50-100 rekordos adagokban kérj le adatokat, ne egyszerre mindent.

Gyorsítótárazd a válaszokat: A cetpozíciók nem változnak másodpercenként. Gyorsítótárazd az eredményeket 30-60 másodpercre, hogy csökkentsd az API hívások számát és javítsd a teljesítményt.

Szűrj korán: Használj lekérdezési paramétereket (symbol, exchange, direction) a szerveroldali szűréshez, ne az alkalmazáskódodban.

Kezeld a sávszélesség-korlátokat: Implementálj exponenciális visszalépéses újrapróbálkozási logikát. Ha eléred a sávszélesség-korlátot (429 státusz), várj és próbáld újra.

Használj WebSocket-ot valós idejű adatokhoz: Az adatfolyamokhoz inkább WebSocket kapcsolatot használj, mint REST végpontok lekérdezését. Így sávszélességet takaríthatsz meg és szubszekundumos késleltetést érhetsz el.

Érvényesítsd az időbélyegeket: Minden időbélyeg ISO 8601 UTC formátumú. Mindig konvertáld a helyi időzónádba megjelenítéshez és mindig UTC-ben tárold.

Kezeld a kapcsolatbontásokat: Implementálj automatikus újrakapcsolódási logikát exponenciális visszalépéssel WebSocket kapcsolatokhoz.

Figyeld a kvótádat: Ellenőrizd a X-Requests-Remaining fejlécet a válaszokban. Tervezd meg az API használatodat, hogy a csomagod keretein belül maradj.

Gyakori integrációs minták

1. minta: Figyelmeztetés cetfelhalmozásra

Állítsd be a figyelmeztetéseket, ha a cetpozíciók meghaladnak egy küszöbértéket, ami potenciális bull piacot vagy felhalmozási fázist jelezhet.

2. minta: Finanszírozási ráta arbitrázs észlelése

Automatikusan észleld, ha a finanszírozási ráta különbségek meghaladják a nyereséges küszöbértékeket tőzsdék között, lehetővé téve a kereszt-tőzsdei arbitrázs algoritmusokat.

3. minta: Likvidációs kaszkád monitorozás

Kövesd a nagy likvidációkat és állítsd be az algoritmust, hogy kihasználja a kaszkádoló likvidációkat és a nagy hatású ármozgásokat.

4. minta: Többszörös jel megerősítés

Kombináld a cetpozíciókat, finanszírozási rátákat, on-chain metrikákat és az AI megerősítési pontjainkat, hogy magabiztos belépési jeleket kapj.

Készen állsz a kezdésre?

Szerezd meg az API kulcsod a konzolból és kezdj el építeni még ma. Minden új fiók ingyenes hozzáférést kap 20 napi kérésre (BTC, ETH, SOL). Frissíts Trader vagy Pro csomagra a korlátlan hozzáférésért minden szimbólumhoz és haladó funkciókhoz.

API kulcs kérése

Pro funkciók feloldása

Teljes hozzáférés a cetpozíciókhoz, megerősítési pontszámokhoz, on-chain adatokhoz és 2000+ napi API kéréshez.

Árak megtekintése