Komplett REST API-referens

Bemästra Smart Money API med vår omfattande REST-referens. Lär dig alla slutpunkter, parametrar, autentiseringsmetoder och verkliga integrationsmönster för kryptoderivatintelligens och valpspårningsdata.

Översikt

Smart Money API ger RESTful-åtkomst till realtidsdata för kryptoderivat över tre stora börser: Bybit, Binance och Hyperliquid. Vårt API sammanställer valpens plånbokspositioner, finansieringsräntor, öppet intresse-mått, likvidationsdata och on-chain-signaler i ett enhetligt gränssnitt. Oavsett om du bygger handelsalgoritmer, riskhanteringssystem eller marknadsanalysverktyg ger REST API dig direkt programmatisk åtkomst till all Smart Money-intelligens.

Med över 229 automatiskt upptäckta handelssymboler och 600+ övervakade valpens plånböcker ger API:n omfattande marknadsintelligens. Realtids WebSocket-anslutningar levererar uppdateringar på under en sekund, medan våra REST-slutpunkter hanterar batchfrågor, historisk datahämtning och portföljanalys i stor skala.

Alla förfrågningar måste innehålla giltiga autentiseringsuppgifter. Användare på fri nivå har 20 förfrågningar per dag begränsat till BTC. Handlarnivå (400 förfrågningar/dag) och Pro-nivå (4 000 förfrågningar/dag) låser upp alla symboler och avancerade funktioner.

Autentisering

Smart Money API använder API-nyckelautentisering. Den primära metoden är X-API-Key begärandehuvud. Du kan generera API-nycklar från din instrumentpanel. En sessions-JWT via Authorization: Bearer accepteras som reserv för webbläsar/instrumentpanelssessioner, men API-klienter bör använda X-API-Key.

API-nyckelautentisering (primär)

Skicka din API-nyckel i X-API-Key huvudet vid varje förfrågan. Lägg aldrig din nyckel i en URL.

HTTP

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

Sessions-JWT (reserv)

Webbläsar/instrumentpanelssessioner kan skicka en sessions-JWT via Authorization: Bearer (giltig i 24 timmar). Programmatiska klienter bör föredra X-API-Key.

Python

import requests
import json

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

# Använd JWT för efterföljande förfrågningar
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Bas-URL & Slutpunkter

Alla API-förfrågningar går till https://api.smartmoneyapi.com. API:n är organiserad i logiska resurskategorier med versionsprefix. Den nuvarande stabila versionen är v1.

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

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

Svarsformat

Alla API-svar returneras som JSON-objekt med ett standardkuvertformat. Lyckade svar returnerar HTTP 200-299-statuskoder med data i svarskroppen. Felsvar inkluderar detaljerade felmeddelanden och lösningsförslag.

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

Valpstorlekar Slutpunkt

Hämta detaljerade positioner från övervakade vallet plånböcker över alla börser. Denna slutpunkt visar realtids hävstång, ingångspriser, likvidationspriser och realiserad P&L för höga positioner.

GET /v1/whales/events PRO

Parameter	Typ	Beskrivning
symbol	string	Handelspar (t.ex., BTCUSDT, ETHUSDT) valfri
exchange	string	Filtrera efter börs: bybit, binance, hyperliquid valfri
min_position_size	number	Minsta positionsstorlek i basasset valfri
direction	string	endast långa eller korta positioner valfri
page	integer	Paginera sidnummer, standard 1 valfri
limit	integer	Resultat per sida, max 100, standard 50 valfri

Exempel på förfrågan:

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"

Funding Rates Endpoint

Få tillgång till realtids och historiska finansieringsräntor över Bybit, Binance och Hyperliquid. Finansieringsräntor är kritiska för arbitragehandel, swingstrategier och derivathäckning. Vår API sammanställer räntor med 15-minuters granularitet och tillhandahåller historisk ränteanalys.

GET /v1/funding-rates FREE

Parameter	Typ	Beskrivning
symbol	string	Handelspar (t.ex., BTCUSDT) obligatorisk
exchange	string	Börs: bybit, binance, hyperliquid valfri
interval	string	1h, 4h, 1d, standard 1h valfri
limit	integer	Historiska perioder att returnera, max 500 valfri

Exempel på förfrågan:

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

Övervak sammanlagd öppen ränta över alla hävstångshandlare. Avvikelse i öppen ränta från prisförändringar signalerar potentiella vändningar och trendfortsättningsmöjligheter. Spåra både absolut OI och OI-förändringshastigheter.

GET /v1/open-interest TRADER

Parameter	Typ	Beskrivning
symbol	string	Handelspar required
exchange	string	bybit, binance, eller hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, standard 15m optional

Likvidationsslutpunkt

Returnerar två kompletterande vyer för ett symbol: hävstångsprojicerade nivåer (en uppskattning av var likvidationskluster finns) och en realized_heatmap — den VERKLIGA utförda tvångslikvidationsintensiteten (pris × tid) aggregerad live från publika börsers WebSocket-flöden: Binance, OKX, Bybit, Bitget och BitMEX. Värmekartan visas när strömmen har data för symbolen.

GET /v1/liquidations TRADER

Parameter	Typ	Beskrivning
symbol	string	Tillgångssymbol, standard BTC optional

Trader returnerar kaskadrisk, närmaste avstånd och realiserade totaler/per sida. Pro returnerar fullständiga projicerade nivåer plus den fullständiga realized_heatmap (matriser, per-priskluster, per-börsantal).

On-Chain DeFi-likvidationer

Utförda DeFi-låneprotokollikvidationer hämtade direkt från våra egna lokala BSC- och Avalanche-fullnoder — oberoende av någon handelsbot. Täcker Venus/Cream och Moolah på BSC, och AAVE V3/V2, Benqi, BankerJoe, Granary och Vinium på Avalanche. Kräver en autentiserad nyckel (Trader+); Pro returnerar dessutom botberoende riskpositioner.

GET /v1/liquidations/onchain TRADER

Parameter	Typ	Beskrivning
chain	string	bsc eller avax; utelämna för alla optional
limit	integer	Max rader, standard 100, max 500 (nyaste-först) optional

Bekräftelseslutpunkt

Slutpunkten /v1/confirm returnerar en regelbaserad, multifaktor- konfluens poäng som kombinerar derivat, on-chain (gratis Coin Metrics: MVRV / exchange-flow / active-address) och valpositionering. Den sammanställda poängen sträcker sig från -1.0 till +1.0 (inte 0–100) och varje svar inkluderar en transparent faktorer uppdelning (per-delningspoäng × vikt), justeringar, vikter, och täckning. Det är beslutsstöd, inte en garanterad vinstprocent. En ospårad symbol returnerar ett explicit NO_DATA / inte stödd-resultat snarare än en fabricerad LOW.

GET /v1/confirm TRADER

Parametrar: symbol (BTC/ETH/SOL) och direction (long/short). confidence är en av HIGH / MEDIUM / LOW / VETO / NO_DATA; action är en av CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult är den föreslagna positionsstorleksmultiplikatorn.

On-Chain Data-slutpunkter

Få tillgång till Bitcoin- och Ethereum-on-chain-mått inklusive börsflöden, valplånboksrörelser, MVRV-kvot, NUPL, utgiftsvillkor och realiserad volatilitet. Dessa mått identifierar ackumulerings-/distributionscykler och ger tidiga signaler för större vändningar.

GET /v1/on-chain/metrics PRO

Parameter	Typ	Beskrivning
asset	string	bitcoin eller ethereum required
metrics	array	Specifika mått: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (daglig), 1w (veckovis), standard 1d optional

Datamodellreferens

Att förstå strukturen för API-svar är avgörande för integration. Nedan finns de fullständiga datamodelldefinitionerna som används i alla slutpunkter.

WhalePosition-objekt

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

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

Kodexempel

Här är produktionsklara kodexempel för vanliga integrationsmönster.

Övervaka valjepositioner i 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:
        """Hämta valjepositioner med valfritt symbolfilter"""
        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:
        """Hämta aktuella och historiska finansieringsräntor"""
        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):
        """Övervaka valjepositioner kontinuerligt"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Val {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Användning
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Totalt antal valjepositioner: {whales['data']['total']}")

Bästa praxis & prestandatips

Använd sidindelning: Sidindela alltid stora resultatmängder. Använd limit och page parametrar för att hämta data i 50-100 poster per gång, inte all data på en gång.

Cachelagra svar: Valjepositioner ändras inte varje sekund. Cachelagra resultat i 30-60 sekunder för att minska API-anrop och förbättra prestanda.

Filtrera tidigt: Använd frågeparametrar (symbol, exchange, direction) för att filtrera data på serversidan, inte i din applikationskod.

Hantera begränsningar: Implementera exponentiell backoff-logik för återförsök. När du träffar begränsningar (429-status), vänta och försök igen.

Använd WebSocket för realtid: För strömmande data, föredra WebSocket-anslutningar över polling av REST-slutpunkter. Du sparar bandbredd och får subsekund-latens.

Validera tidsstämplar: Alla tidsstämplar är ISO 8601 UTC. Konvertera alltid till din lokala tidszon för visning och lagra alltid i UTC.

Hantera frånkopplingar: Implementera automatisk återanslutningslogik med exponentiell backoff för WebSocket-anslutningar.

Övervaka din kvot: Kontrollera X-Requests-Remaining huvudet i svaren. Planera din API-användning för att hålla dig inom din gräns.

Vanliga integrationsmönster

Mönster 1: Varna vid valjeackumulering

Ställ in varningar när valjepositioner ökar över en tröskel, vilket signalerar potentiella bull runs eller ackumuleringsfaser.

Mönster 2: Identifiering av finansieringsräntearbitrage

Upptäck automatiskt när spridningen av finansieringsräntor överskrider lönsamma trösklar över börser, vilket möjliggör algoritmer för korsbörsarbitrage.

Mönster 3: Övervakning av likvidationskaskader

Spåra stora likvidationer och positionera algoritmen för att dra nytta av kaskaderande likvidationer och höginfluerande prisförändringar.

Mönster 4: Bekräftelse med flera signaler

Kombinera valjepositioner, finansieringsräntor, on-chain-mått och våra AI-bekräftelsepoäng för högsäkerhetsinträdessignaler.

Redo att börja?

Hämta din API-nyckel från konsolen och börja bygga idag. Alla nya konton får tillgång till fri nivå med 20 förfrågningar per dag (BTC, ETH, SOL). Uppgradera till Trader eller Pro för obegränsad tillgång till alla symboler och avancerade funktioner.

Hämta API-nyckel

Lås upp Pro-funktioner

Få full tillgång till valjepositioner, bekräftelsepoäng, on-chain-data och 2000+ API-förfrågningar per dag.

Visa priser