Volledige REST API-referentie

Beheers de Smart Money API met onze uitgebreide REST-referentie. Leer alle eindpunten, parameters, authenticatiemethoden en praktische integratiepatronen voor crypto-derivatenintelligentie en walvistrackinggegevens.

Overzicht

De Smart Money API biedt RESTful toegang tot real-time cryptocurrency-derivatengegevens van drie grote beurzen: Bybit, Binance en Hyperliquid. Onze API aggregeert walvisportefeuilleposities, financieringspercentages, open interest-metrics, liquidatiegegevens en on-chain signalen in één uniforme interface. Of je nu handelsalgoritmen, risicobeheersystemen of marktanalysetools bouwt, de REST API geeft je directe programmatische toegang tot alle Smart Money-intelligentie.

Met meer dan 229 automatisch ontdekte handelssymbolen en 600+ gemonitorde walvisportefeuilles biedt de API uitgebreide marktintelligentie. Real-time WebSocket-verbindingen leveren updates in minder dan een seconde, terwijl onze REST-eindpunten batchquery's, historische gegevensopvraging en portefeuilleanalyse op schaal afhandelen.

Alle verzoeken moeten geldige authenticatiegegevens bevatten. Gebruikers van het gratis abonnement hebben 20 verzoeken per dag, beperkt tot BTC. Het Trader-abonnement (400 verzoeken/dag) en Pro-abonnement (4.000 verzoeken/dag) ontgrendelen alle symbolen en geavanceerde functies.

Authenticatie

De Smart Money API gebruikt API-sleutelauthenticatie. De primaire methode is de X-API-Key verzoekheader. Je kunt API-sleutels genereren vanuit je dashboard. Een sessie-JWT via Authorization: Bearer wordt geaccepteerd als fallback voor browser/dashboard-sessies, maar API-clients moeten X-API-Key.

API-sleutelauthenticatie (primair)

Stuur je API-sleutel in de X-API-Key header bij elk verzoek. Plaats je sleutel nooit in een URL.

HTTP

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

Sessie-JWT (fallback)

Browser/dashboard-sessies kunnen een sessie-JWT doorgeven via Authorization: Bearer (geldig voor 24 uur). Programmatische clients moeten de voorkeur geven aan 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())

Basis-URL & Eindpunten

Alle API-verzoeken gaan naar https://api.smartmoneyapi.com. De API is georganiseerd in logische resourcecategorieën met versievoorvoegsels. Huidige stabiele versie is v1.

Basis-URL: https://api.smartmoneyapi.com/api/v1

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

Antwoordformaat

Alle API-antwoorden worden geretourneerd als JSON-objecten met een standaard envelopformaat. Succesvolle antwoorden retourneren HTTP 200-299 statuscodes met gegevens in de antwoordbody. Foutantwoorden bevatten gedetailleerde foutmeldingen en oplossingssuggesties.

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

Walvisposities Eindpunt

Haal gedetailleerde posities op van gemonitorde walvisportefeuilles op alle beurzen. Dit eindpunt toont real-time leverage, instapprijzen, liquidatieprijzen en ongerealiseerde P&L voor hoogwaardige posities.

GET /v1/whales/events PRO

Parameter	Type	Beschrijving
symbol	string	Handelspaar (bijv. BTCUSDT, ETHUSDT) optioneel
exchange	string	Filter op beurs: bybit, binance, hyperliquid optioneel
min_position_size	number	Minimale positiegrootte in basisasset optioneel
direction	string	Alleen long of short posities optioneel
page	integer	Paginanummer, standaard 1 optioneel
limit	integer	Resultaten per pagina, max 100, standaard 50 optioneel

Voorbeeldverzoek:

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"

Financieringspercentages Eindpunt

Toegang tot real-time en historische financieringspercentages op Bybit, Binance en Hyperliquid. Financieringspercentages zijn cruciaal voor arbitragehandel, swingstrategieën en derivatenhedging. Onze API aggregeert percentages met een granulariteit van 15 minuten en biedt historische percentageanalyse.

GET /v1/funding-rates FREE

Parameter	Type	Beschrijving
symbol	string	Handelspaar (bijv. BTCUSDT) vereist
exchange	string	Beurs: bybit, binance, hyperliquid optioneel
interval	string	1h, 4h, 1d, standaard 1h optioneel
limit	integer	Historische periodes om terug te geven, max 500 optioneel

Voorbeeldverzoek:

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

Open Interest Endpoint

Monitor het totale open interest van alle leverage traders. Afwijkingen in open interest ten opzichte van prijsbewegingen signaleren potentiële omkeringen en trendvoortzettingsmogelijkheden. Volg zowel het absolute OI als de OI-veranderingspercentages.

GET /v1/open-interest TRADER

Parameter	Type	Beschrijving
symbol	string	Handelspaar vereist
exchange	string	bybit, binance, of hyperliquid optioneel
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, standaard 15m optioneel

Liquidations Endpoint

Retourneert twee complementaire views voor een symbool: leverage-projected levels (een schatting van waar liquidatieclusters zich bevinden) en een realized_heatmap — de ECHTE uitgevoerde gedwongen-liquidatie-intensiteit (prijs × tijd) live geaggregeerd uit publieke exchange WebSocket-feeds: Binance, OKX, Bybit, Bitget en BitMEX. De heatmap is aanwezig wanneer de stream gegevens heeft voor het symbool.

GET /v1/liquidations TRADER

Parameter	Type	Beschrijving
symbol	string	Assetsymbool, standaard BTC optioneel

Trader retourneert cascade risico, dichtstbijzijnde afstanden en gerealiseerde totalen/per kant. Pro retourneert volledige geprojecteerde levels plus de volledige realized_heatmap (matrices, per-prijs clusters, per-exchange tellingen).

On-Chain DeFi Liquidations

Uitgevoerde DeFi lending-protocol liquidaties rechtstreeks vastgelegd vanuit onze eigen lokale BSC en Avalanche full nodes — onafhankelijk van elke trading bot. Behandelt Venus/Cream en Moolah op BSC, en AAVE V3/V2, Benqi, BankerJoe, Granary en Vinium op Avalanche. Vereist een geauthenticeerde sleutel (Trader+); Pro retourneert daarnaast bot-afhankelijke risicovolle posities.

GET /v1/liquidations/onchain TRADER

Parameter	Type	Beschrijving
chain	string	bsc of avax; weglaten voor alles optioneel
limit	integer	Max rijen, standaard 100, max 500 (nieuwste eerst) optioneel

Confirmation Endpoint

De /v1/confirm endpoint retourneert een op regels gebaseerde, multi-factor confluence score die derivaten, on-chain (gratis Coin Metrics: MVRV / exchange-flow / active-address) en walvispositionering combineert. De composite loopt van -1.0 tot +1.0 (niet 0–100) en elk antwoord bevat een transparante factors breakdown (per-leg score × gewicht), adjustments, weights, en coverage. Het is beslissingsondersteuning, geen gegarandeerde winratio. Een niet-gevolgd symbool retourneert een expliciet NO_DATA / niet-ondersteund resultaat in plaats van een gefabriceerd LOW.

GET /v1/confirm TRADER

Parameters: symbol (BTC/ETH/SOL) en direction (long/short). confidence is één van HIGH / MEDIUM / LOW / VETO / NO_DATA; action is één van CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult is de voorgestelde positie-grootte multiplier.

On-Chain Data Endpoints

Toegang tot Bitcoin en Ethereum on-chain metrieken inclusief exchange flows, walvisportefeuillebewegingen, MVRV ratio, NUPL, uitgavencondities en gerealiseerde volatiliteit. Deze metrieken identificeren accumulatie/distributiecycli en bieden vroege signalen voor grote omkeringen.

GET /v1/on-chain/metrics PRO

Parameter	Type	Beschrijving
asset	string	bitcoin of ethereum vereist
metrics	array	Specifieke metrieken: exchange_flows, mvrv, nupl, whale_moves optioneel
interval	string	1d (dagelijks), 1w (wekelijks), standaard 1d optioneel

Data Models Reference

Het begrijpen van de structuur van API-responses is essentieel voor integratie. Hieronder staan de volledige datamodeldefinities die worden gebruikt voor alle endpoints.

WhalePosition Object

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 Object

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

Codevoorbeelden

Hieronder staan productieklaar codevoorbeelden voor veelvoorkomende integratiepatronen.

Monitor Walvisposities in 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:
        """Haal walvisposities op met optioneel symboolfilter"""
        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:
        """Haal huidige en historische funding rates op"""
        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):
        """Houd walvisposities continu in de gaten"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Walvis {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Gebruik
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Totaal walvisposities: {whales['data']['total']}")

Beste praktijken & Prestatietips

Gebruik paginering: Pagineer altijd grote resultatensets. Gebruik limit en page parameters om gegevens in blokken van 50-100 records op te halen, niet alles in één keer.

Cache responses: Walvisposities veranderen niet elke seconde. Cache resultaten voor 30-60 seconden om API-aanroepen te verminderen en prestaties te verbeteren.

Filter vroegtijdig: Gebruik queryparameters (symbol, exchange, direction) om gegevens server-side te filteren, niet in uw applicatiecode.

Hanteer ratelimits: Implementeer exponential backoff retry logica. Wanneer u ratelimits (429 status) bereikt, wacht en probeer het opnieuw.

Gebruik WebSocket voor real-time: Gebruik voor streamingdata bij voorkeur WebSocket-verbindingen in plaats van polling REST endpoints. Dit bespaart bandbreedte en biedt subseconde latentie.

Valideer timestamps: Alle timestamps zijn ISO 8601 UTC. Converteer altijd naar uw lokale tijdzone voor weergave en sla altijd op in UTC.

Hanteer verbindingsproblemen: Implementeer automatische herconnectielogica met exponential backoff voor WebSocket-verbindingen.

Monitor uw quota: Controleer de X-Requests-Remaining header in responses. Plan uw API-gebruik om binnen uw tierlimiet te blijven.

Veelvoorkomende integratiepatronen

Patroon 1: Waarschuwing bij walvisaccumulatie

Stel waarschuwingen in wanneer walvisposities een drempel overschrijden, wat wijst op mogelijke bull runs of accumulatiefases.

Patroon 2: Funding Rate Arbitrage Detectie

Detecteer automatisch wanneer funding rate spreads winstgevende drempels overschrijden tussen beurzen, wat cross-exchange arbitragealgoritmes mogelijk maakt.

Patroon 3: Monitoring van liquidatiecascades

Volg grote liquidaties en positioneer het algoritme om te profiteren van cascaderende liquidaties en prijsbewegingen met grote impact.

Patroon 4: Multi-Signaalbevestiging

Combineer walvisposities, funding rates, on-chain metrics en onze AI-bevestigingsscores voor hoogvertrouwen entry-signalen.

Klaar om te beginnen?

Haal uw API-sleutel uit de console en begin vandaag nog met bouwen. Alle nieuwe accounts krijgen gratis toegang met 20 aanvragen per dag (BTC, ETH, SOL). Upgrade naar Trader of Pro voor onbeperkte toegang tot alle symbolen en geavanceerde functies.

API-sleutel ophalen

Ontgrendel Pro-functies

Krijg volledige toegang tot walvisposities, bevestigingsscores, on-chain data en 2000+ dagelijkse API-aanvragen.

Bekijk prijzen