Pełne odniesienie REST API

Opanuj Smart Money API dzięki naszemu kompleksowemu przewodnikowi REST. Poznaj wszystkie punkty końcowe, parametry, metody uwierzytelniania i wzorce integracji danych dotyczących inteligencji kryptowalutowych instrumentów pochodnych i śledzenia wielorybów.

Przegląd

Smart Money API zapewnia dostęp REST do danych kryptowalutowych instrumentów pochodnych w czasie rzeczywistym z trzech głównych giełd: Bybit, Binance i Hyperliquid. Nasze API agreguje pozycje portfeli wielorybów, stopy finansowania, metryki otwartego zainteresowania, dane likwidacyjne i sygnały on-chain w jeden ujednolicony interfejs. Niezależnie od tego, czy budujesz algorytmy handlowe, systemy zarządzania ryzykiem, czy narzędzia analizy rynkowej, REST API daje Ci bezpośredni programowy dostęp do wszystkich danych Smart Money.

Z ponad 229 automatycznie wykrytymi symbolami handlowymi i 600+ monitorowanymi portfelami wielorybów, API zapewnia kompleksową inteligencję rynkową. Połączenia WebSocket w czasie rzeczywistym dostarczają aktualizacje w czasie krótszym niż sekunda, podczas gdy nasze punkty końcowe REST obsługują zapytania zbiorcze, pobieranie danych historycznych i analizę portfela na dużą skalę.

Wszystkie żądania muszą zawierać prawidłowe dane uwierzytelniające. Użytkownicy darmowej wersji mają 20 zapytań dziennie ograniczonych do BTC. Wersja Trader (400 zapytań/dzień) i Pro (4000 zapytań/dzień) odblokowują wszystkie symbole i zaawansowane funkcje.

Uwierzytelnianie

Smart Money API wykorzystuje uwierzytelnianie za pomocą klucza API. Podstawową metodą jest X-API-Key nagłówek żądania. Klucze API można generować z poziomu panelu sterowania. JWT sesji poprzez Authorization: Bearer jest akceptowany jako zapasowy dla sesji przeglądarki/panelu sterowania, ale klienci API powinni używać X-API-Key.

Uwierzytelnianie kluczem API (podstawowe)

Wyślij swój klucz API w X-API-Key nagłówku każdego żądania. Nigdy nie umieszczaj klucza w URL.

HTTP

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

JWT sesji (zapasowy)

Sesje przeglądarki/panelu sterowania mogą przekazywać JWT sesji poprzez Authorization: Bearer (ważny przez 24 godziny). Klienci programistyczni powinni preferować X-API-Key.

Python

import requests
import json

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

# Użyj JWT do kolejnych żądań
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Podstawowy URL i punkty końcowe

Wszystkie żądania API są kierowane na https://api.smartmoneyapi.com. API jest zorganizowane w logiczne kategorie zasobów z prefiksami wersji. Obecna stabilna wersja to v1.

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

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

Format odpowiedzi

Wszystkie odpowiedzi API są zwracane jako obiekty JSON ze standardowym formatem koperty. Pomyślne odpowiedzi zwracają kody stanu HTTP 200-299 z danymi w treści odpowiedzi. Błędy zawierają szczegółowe komunikaty i sugestie rozwiązania.

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

Punkt końcowy pozycji wielorybów

Pobierz szczegółowe pozycje z monitorowanych portfeli wielorybów na wszystkich giełdach. Ten punkt końcowy pokazuje dźwignię w czasie rzeczywistym, ceny wejścia, ceny likwidacji i niezrealizowany P&L dla pozycji o wysokiej wartości.

GET /v1/whales/events PRO

Parametr	Typ	Opis
symbol	string	Para handlowa (np. BTCUSDT, ETHUSDT) opcjonalny
exchange	string	Filtruj według giełdy: bybit, binance, hyperliquid opcjonalny
min_position_size	number	Minimalny rozmiar pozycji w aktywie bazowym opcjonalny
direction	string	Tylko pozycje long lub short opcjonalny
page	integer	Numer strony paginacji, domyślnie 1 opcjonalny
limit	integer	Wyniki na stronę, maks. 100, domyślnie 50 opcjonalny

Przykładowe żądanie:

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"

Punkt końcowy stóp finansowania

Dostęp do stawek finansowania w czasie rzeczywistym i historycznych na Bybit, Binance i Hyperliquid. Stawki finansowania są kluczowe dla handlu arbitrażowego, strategii swingowych i zabezpieczania instrumentów pochodnych. Nasze API agreguje stawki z 15-minutową dokładnością i zapewnia analizę historycznych stawek.

GET /v1/funding-rates FREE

Parametr	Typ	Opis
symbol	string	Para handlowa (np. BTCUSDT) wymagany
exchange	string	Giełda: bybit, binance, hyperliquid opcjonalny
interval	string	1h, 4h, 1d, domyślnie 1h opcjonalny
limit	integer	Liczba historycznych okresów do zwrócenia, maks. 500 opcjonalny

Przykładowe żądanie:

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

Monitoruj łączne otwarte pozycje wszystkich traderów wykorzystujących dźwignię. Rozbieżność między otwartymi pozycjami a ruchami cenowymi sygnalizuje potencjalne odwrócenia trendu i możliwości kontynuacji. Śledź zarówno absolutną wartość OI, jak i tempo zmian OI.

GET /v1/open-interest TRADER

Parametr	Typ	Opis
symbol	string	Para walutowa wymagane
exchange	string	bybit, binance lub hyperliquid opcjonalne
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, domyślnie 15m opcjonalne

Endpoint Likwidacji

Zwraca dwa uzupełniające się widoki dla symbolu: przewidywane poziomy dźwigni poziomy (oszacowanie, gdzie znajdują się klastry likwidacji) oraz realized_heatmap — RZECZYWISTĄ intensywność wymuszonych likwidacji (cena × czas) agregowaną na żywo z publicznych strumieni WebSocket giełd: Binance, OKX, Bybit, Bitget i BitMEX. Heatmapa jest dostępna, gdy strumień zawiera dane dla symbolu.

GET /v1/liquidations TRADER

Parametr	Typ	Opis
symbol	string	Symbol aktywa, domyślnie BTC opcjonalne

Trader zwraca ryzyko kaskadowe, najbliższe odległości i zrealizowane sumy/według strony. Pro zwraca pełne przewidywane poziomy oraz pełną realized_heatmap (macierze, klastry cenowe, liczba według giełdy).

Likwidacje On-Chain DeFi

Zrealizowane likwidacje w protokołach DeFi przechwycone bezpośrednio z naszych lokalnych pełnych węzłów BSC i Avalanche — niezależnie od jakiegokolwiek bota handlowego. Obejmuje Venus/Cream i Moolah na BSC oraz AAVE V3/V2, Benqi, BankerJoe, Granary i Vinium na Avalanche. Wymaga uwierzytelnionego klucza (Trader+); Pro dodatkowo zwraca pozycje zagrożone, zależne od botów.

GET /v1/liquidations/onchain TRADER

Parametr	Typ	Opis
chain	string	bsc lub avax; pomiń dla wszystkich opcjonalne
limit	integer	Maksymalna liczba wierszy, domyślnie 100, maksymalnie 500 (najnowsze pierwsze) opcjonalne

Endpoint Potwierdzenia

Endpoint /v1/confirm zwraca oparty na regułach, wieloczynnikowy confluence łączący instrumenty pochodne, dane on-chain (darmowe Coin Metrics: MVRV / przepływy giełdowe / aktywne adresy) oraz pozycjonowanie wielorybów. Wynik composite wynosi od -1.0 do +1.0 (nie 0–100), a każda odpowiedź zawiera przejrzysty factors rozkład (wynik per-leg × waga), adjustments, wagioraz coverage. Jest to wsparcie decyzyjne, a nie gwarancja wygranej. Nieśledzony symbol zwraca wyraźny wynik NO_DATA / nieobsługiwany zamiast spreparowanego LOW.

GET /v1/confirm TRADER

Parametry: symbol (BTC/ETH/SOL) i direction (long/short). confidence to jedna z wartości: HIGH / MEDIUM / LOW / VETO / NO_DATA; action to jedna z wartości: CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult to sugerowany mnożnik wielkości pozycji.

Endpointy Danych On-Chain

Dostęp do metryk on-chain Bitcoin i Ethereum, w tym przepływów giełdowych, ruchów portfeli wielorybów, wskaźnika MVRV, NUPL, warunków wydatkowania i zrealizowanej zmienności. Te metryki identyfikują cykle akumulacji/dystrybucji i dostarczają wczesnych sygnałów do głównych odwróceń.

GET /v1/on-chain/metrics PRO

Parametr	Typ	Opis
asset	string	bitcoin lub ethereum wymagane
metrics	array	Konkretne metryki: exchange_flows, mvrv, nupl, whale_moves opcjonalne
interval	string	1d (dziennie), 1w (tygodniowo), domyślnie 1d opcjonalne

Referencja Modeli Danych

Zrozumienie struktury odpowiedzi API jest kluczowe dla integracji. Poniżej znajdują się pełne definicje modeli danych używanych we wszystkich endpointach.

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

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

Przykłady kodu

Poniżej znajdują się gotowe do użycia przykłady kodu dla typowych wzorców integracji.

Monitorowanie pozycji wielorybów w Pythonie

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:
        """Pobierz pozycje wielorybów z opcjonalnym filtrem 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:
        """Pobierz aktualne i historyczne stopy finansowania"""
        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):
        """Ciągłe monitorowanie pozycji wielorybów"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Wieloryb {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Użycie
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Łączna liczba pozycji wielorybów: {whales['data']['total']}")

Najlepsze praktyki i wskazówki dotyczące wydajności

Używaj paginacji: Zawsze stosuj paginację dla dużych zestawów wyników. Używaj parametrów limit i page, aby pobierać dane w porcjach po 50-100 rekordów, a nie wszystkie na raz.

Buforuj odpowiedzi: Pozycje wielorybów nie zmieniają się co sekundę. Buforuj wyniki przez 30-60 sekund, aby zmniejszyć liczbę wywołań API i poprawić wydajność.

Filtruj wcześnie: Używaj parametrów zapytania (symbol, giełda, kierunek), aby filtrować dane po stronie serwera, a nie w kodzie aplikacji.

Obsługuj limity szybkości: Zaimplementuj logikę ponawiania z wykładniczym wycofywaniem. Po osiągnięciu limitów szybkości (status 429), odczekaj i spróbuj ponownie.

Używaj WebSocket do danych w czasie rzeczywistym: Do przesyłania strumieniowego danych preferuj połączenia WebSocket zamiast sondowania endpointów REST. Zaoszczędzisz przepustowość i uzyskasz opóźnienie poniżej sekundy.

Weryfikuj znaczniki czasu: Wszystkie znaczniki czasu są w formacie ISO 8601 UTC. Zawsze konwertuj je na swoją strefę czasową do wyświetlania i zawsze przechowuj w UTC.

Obsługuj rozłączenia: Zaimplementuj automatyczną logikę ponownego łączenia z wykładniczym wycofywaniem dla połączeń WebSocket.

Monitoruj swój limit: Sprawdzaj nagłówek X-Requests-Remaining w odpowiedziach. Zaplanuj użycie API, aby pozostać w granicach swojego limitu.

Typowe wzorce integracji

Wzorzec 1: Alerty o akumulacji przez wieloryby

Ustaw alerty, gdy pozycje wielorybów przekroczą określony próg, sygnalizując potencjalne hossy lub fazy akumulacji.

Wzorzec 2: Wykrywanie arbitrażu stóp finansowania

Automatycznie wykrywaj, gdy różnice w stopach finansowania przekraczają progi opłacalności między giełdami, umożliwiając algorytmy arbitrażu między giełdami.

Wzorzec 3: Monitorowanie kaskad likwidacji

Śledź duże likwidacje i pozycjonuj algorytm, aby wykorzystać kaskadowe likwidacje i ruchy cenowe o dużym wpływie.

Wzorzec 4: Potwierdzenie wieloma sygnałami

Połącz pozycje wielorybów, stopy finansowania, metryki on-chain i nasze oceny potwierdzenia AI, aby uzyskać sygnały wejścia o wysokiej pewności.

Gotowy do startu?

Pobierz swój klucz API z konsoli i zacznij budować już dziś. Wszystkie nowe konta otrzymują dostęp do darmowego tieru z 20 żądaniami dziennie (BTC, ETH, SOL). Ulepsz do Trader lub Pro, aby uzyskać nieograniczony dostęp do wszystkich symboli i zaawansowanych funkcji.

Pobierz klucz API

Odblokuj funkcje Pro

Uzyskaj pełny dostęp do pozycji wielorybów, ocen potwierdzenia, danych on-chain i ponad 2000 żądań API dziennie.

Zobacz cennik