Kompletní REST API Reference

Ovládněte Smart Money API s naší komplexní REST referencí. Naučte se všechny endpointy, parametry, metody autentizace a reálné integrační vzorce pro krypto derivátovou inteligenci a data sledování velryb.

Přehled

Smart Money API poskytuje RESTful přístup k datům krypto derivátů v reálném čase napříč třemi hlavními burzami: Bybit, Binance a Hyperliquid. Naše API agreguje pozice peněženek velryb, funding rates, metriky open interest, data o likvidacích a on-chain signály do jednoho sjednoceného rozhraní. Ať už stavíte obchodní algoritmy, systémy řízení rizik nebo nástroje pro analýzu trhu, REST API vám poskytuje přímý programový přístup ke všem Smart Money datům.

S více než 229 automaticky detekovanými obchodními symboly a 600+ monitorovanými peněženkami velryb poskytuje API komplexní tržní inteligenci. WebSocket spojení v reálném čase poskytují aktualizace v submili sekundách, zatímco naše REST endpointy zvládají dávkové dotazy, načítání historických dat a analýzu portfolia ve velkém měřítku.

Všechny požadavky musí obsahovat platné autentizační údaje. Uživatelé zdarma mají 20 dotazů denně omezených na BTC. Trader tier (400 dotazů/den) a Pro tier (4 000 dotazů/den) odemykají všechny symboly a pokročilé funkce.

Autentizace

Smart Money API používá autentizaci pomocí API klíče. Hlavní metoda je X-API-Key hlavička požadavku. API klíče můžete generovat ve svém dashboardu. Session JWT přes Authorization: Bearer je přijímán jako záložní řešení pro prohlížeč/dashboard session, ale API klienti by měli používat X-API-Key.

Autentizace API klíčem (primární)

Posílejte svůj API klíč v X-API-Key hlavičce u každého požadavku. Nikdy nedávejte svůj klíč do 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 (záložní)

Session prohlížeče/dashboardu může předat session JWT přes Authorization: Bearer (platný 24 hodin). Programoví klienti by měli preferovat X-API-Key.

Python

import requests
import json

# Získání JWT tokenu
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# Použití JWT pro následující požadavky
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Základní URL & Endpointy

Všechny API požadavky směřují na https://api.smartmoneyapi.com. API je organizováno do logických kategorií zdrojů s verzovými prefixy. Aktuální stabilní verze je v1.

Základní URL: https://api.smartmoneyapi.com/api/v1

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

Formát odpovědi

Všechny API odpovědi jsou vráceny jako JSON objekty se standardním obálkovým formátem. Úspěšné odpovědi vrací HTTP status kódy 200-299 s daty v těle odpovědi. Chybové odpovědi obsahují podrobné chybové zprávy a návrhy řešení.

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 Whale Positions

Získání detailních pozic z monitorovaných peněženek velryb napříč všemi burzami. Tento endpoint ukazuje aktuální leverage, vstupní ceny, ceny likvidace a nerealizovaný P&L pro vysoce hodnotné pozice.

GET /v1/whales/events PRO

Parametr	Typ	Popis
symbol	string	Obchodovaný pár (např. BTCUSDT, ETHUSDT) volitelné
exchange	string	Filtrovat podle burzy: bybit, binance, hyperliquid volitelné
min_position_size	number	Minimální velikost pozice v základním aktivu volitelné
direction	string	Pouze long nebo short pozice volitelné
page	integer	Číslo stránky pro paginaci, výchozí 1 volitelné
limit	integer	Výsledků na stránku, max 100, výchozí 50 volitelné

Příklad požadavku:

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

Přístup k aktuálním a historickým funding rates napříč Bybit, Binance a Hyperliquid. Funding rates jsou klíčové pro arbitrážní obchodování, swing strategie a hedging derivátů. Naše API agreguje rates s 15minutovou granularitou a poskytuje analýzu historických rates.

GET /v1/funding-rates FREE

Parametr	Typ	Popis
symbol	string	Obchodovaný pár (např. BTCUSDT) povinné
exchange	string	Burza: bybit, binance, hyperliquid volitelné
interval	string	1h, 4h, 1d, výchozí 1h volitelné
limit	integer	Počet vrácených historických období, max 500 volitelné

Příklad požadavku:

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

Sledujte celkový otevřený zájem napříč všemi obchodníky s pákou. Odchylka otevřeného zájmu od pohybu ceny signalizuje potenciální obraty a příležitosti pro pokračování trendu. Sledujte jak absolutní OI, tak míru změny OI.

GET /v1/open-interest TRADER

Parametr	Typ	Popis
symbol	string	Obchodní pár povinný
exchange	string	bybit, binance, nebo hyperliquid volitelný
granularita	string	1m, 5m, 15m, 1h, 4h, 1d, výchozí 15m volitelný

Endpoint Likvidace

Vrací dva doplňující pohledy pro symbol: leverage-projected úrovně (odhad, kde se nacházejí shluky likvidací) a realized_heatmap — SKUTEČNÁ intenzita provedených nucených likvidací (cena × čas) agregovaná živě z veřejných WebSocket feedů burz: Binance, OKX, Bybit, Bitget a BitMEX. Heatmapa je přítomna, když stream obsahuje data pro symbol.

GET /v1/liquidations TRADER

Parametr	Typ	Popis
symbol	string	Symbol aktiva, výchozí BTC volitelný

Trader vrací kaskádové riziko, nejbližší vzdálenosti a realizované celky/podle strany. Pro vrací plné projected úrovně plus plnou realized_heatmap (matice, shluky podle ceny, počty podle burzy).

On-Chain DeFi Likvidace

Provedené likvidace DeFi půjčovacích protokolů zachycené přímo z našich vlastních lokálních full nodů BSC a Avalanche — nezávisle na jakémkoli trading botu. Zahrnuje Venus/Cream a Moolah na BSC a AAVE V3/V2, Benqi, BankerJoe, Granary a Vinium na Avalanche. Vyžaduje autentizovaný klíč (Trader+); Pro navíc vrací pozice v riziku závislé na botovi.

GET /v1/liquidations/onchain TRADER

Parametr	Typ	Popis
chain	string	bsc nebo avax; vynechte pro všechny volitelný
limit	integer	Maximální počet řádků, výchozí 100, maximum 500 (nejnovější první) volitelný

Endpoint Potvrzení

Endpoint /v1/confirm vrací skóre založené na pravidlech, kombinující více faktorů konfluence které kombinují deriváty, on-chain (volné Coin Metrics: MVRV / exchange-flow / active-address) a pozice velryb. kompozitní skóre se pohybuje od -1.0 do +1.0 (ne 0–100) a každá odpověď zahrnuje transparentní faktory rozbor (skóre × váha pro každou složku), úpravy, váhya pokrytí. Jde o podporu rozhodování, nikoli o zaručenou výherní míru. Nesledovaný symbol vrátí explicitní výsledek NO_DATA / unsupported namísto vymyšleného LOW.

GET /v1/confirm TRADER

Parametry: symbol (BTC/ETH/SOL) a směr (long/short). confidence je jedna z hodnot HIGH / MEDIUM / LOW / VETO / NO_DATA; action je jedna z hodnot CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult je navrhovaný multiplikátor velikosti pozice.

On-Chain Data Endpoints

Přístup k on-chain metrikám Bitcoinu a Etherea včetně toků na burzách, pohybů peněženek velryb, poměru MVRV, NUPL, podmínek utrácení a realizované volatility. Tyto metriky identifikují cykly akumulace/distribuce a poskytují časné signály pro hlavní obraty.

GET /v1/on-chain/metrics PRO

Parametr	Typ	Popis
asset	string	bitcoin nebo ethereum povinný
metrics	array	Specifické metriky: exchange_flows, mvrv, nupl, whale_moves volitelný
interval	string	1d (denní), 1w (týdenní), výchozí 1d volitelný

Reference datových modelů

Pro integraci je zásadní porozumět struktuře odpovědí API. Níže jsou uvedeny kompletní definice datových modelů používaných napříč všemi endpointy.

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

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

Příklady kódu

Níže najdete připravené příklady kódu pro běžné integrační vzory.

Sledování velkých pozic v Pythonu

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:
        """Získání velkých pozic s volitelným filtrem podle symbolu"""
        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:
        """Získání aktuálních a historických funding rates"""
        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):
        """Průběžné sledování velkých pozic"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Velká pozice {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Použití
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Celkový počet velkých pozic: {whales['data']['total']}")

Doporučené postupy & Tipy pro výkon

Používejte stránkování: Vždy používejte stránkování pro velké výsledky. Použijte parametry limit a page pro načítání dat po 50-100 záznamech, ne všechna data najednou.

Ukládejte odpovědi do mezipaměti: Velké pozice se nemění každou sekundu. Ukládejte výsledky do mezipaměti na 30-60 sekund, abyste snížili počet volání API a zlepšili výkon.

Filtrujte brzy: Používejte parametry dotazu (symbol, exchange, direction) k filtrování dat na straně serveru, ne ve vašem kódu aplikace.

Ošetřete limity rychlosti: Implementujte logiku opakování s exponenciálním backoffem. Když narazíte na limity rychlosti (status 429), počkejte a zkuste to znovu.

Používejte WebSocket pro reálný čas: Pro streamování dat preferujte WebSocket připojení před dotazováním REST endpointů. Ušetříte šířku pásma a získáte submilisekundovou latenci.

Ověřujte časová razítka: Všechna časová razítka jsou v ISO 8601 UTC. Vždy je převeďte na vaše místní časové pásmo pro zobrazení a ukládejte je v UTC.

Ošetřete odpojení: Implementujte automatickou logiku opětovného připojení s exponenciálním backoffem pro WebSocket připojení.

Sledujte svůj limit: Kontrolujte hlavičku X-Requests-Remaining v odpovědích. Plánujte své použití API tak, abyste zůstali v rámci limitu vaší úrovně.

Běžné integrační vzory

Vzor 1: Upozornění na akumulaci velkých pozic

Nastavte upozornění, když velké pozice překročí určitou hranici, což signalizuje potenciální býčí trh nebo fázi akumulace.

Vzor 2: Detekce arbitráže funding rate

Automaticky detekujte, když rozdíly ve funding rate překročí výnosné hranice napříč burzami, což umožní algoritmům cross-exchange arbitráže.

Vzor 3: Sledování kaskádových likvidací

Sledujte velké likvidace a nastavte algoritmus tak, aby využil kaskádové likvidace a výrazných cenových pohybů.

Vzor 4: Potvrzení více signálů

Kombinujte velké pozice, funding rates, on-chain metriky a naše AI potvrzovací skóre pro signály vstupu s vysokou mírou přesvědčení.

Připraveni začít?

Získejte svůj API klíč z konzole a začněte stavět ještě dnes. Všechny nové účty získají přístup k bezplatné úrovni s 20 požadavky denně (BTC, ETH, SOL). Upgradujte na Trader nebo Pro pro neomezený přístup ke všem symbolům a pokročilým funkcím.

Získat API klíč

Odemkněte Pro funkce

Získejte plný přístup k velkým pozicím, potvrzovacím skóre, on-chain datům a 2000+ denním API požadavkům.

Zobrazit ceny