Kumpletong REST API Reference

Master ang Smart Money API gamit ang aming komprehensibong REST reference. Alamin ang lahat ng endpoints, parameters, mga paraan ng pagpapatotoo, at mga pattern ng pagsasama sa totoong mundo para sa crypto derivatives intelligence at whale tracking data.

Pangkalahatang-ideya

Ang Smart Money API ay nagbibigay ng RESTful access sa real-time na cryptocurrency derivatives data sa tatlong pangunahing exchange: Bybit, Binance, at Hyperliquid. Ang aming API ay nag-aaggregate ng mga posisyon ng whale wallet, funding rates, open interest metrics, liquidation data, at on-chain signals sa isang pinag-isang interface. Kung nagtatayo ka ng mga trading algorithm, risk management system, o mga tool sa pagsusuri ng merkado, ang REST API ay nagbibigay sa iyo ng direktang programmatic access sa lahat ng Smart Money intelligence.

Sa higit sa 229 na auto-discovered na trading symbols at 600+ na minomonitor na whale wallets, ang API ay nagbibigay ng komprehensibong market intelligence. Ang real-time na WebSocket connections ay naghahatid ng sub-second updates, habang ang aming REST endpoints ay humahawak ng batch queries, historical data retrieval, at portfolio analysis sa scale.

Ang lahat ng mga kahilingan ay dapat magsama ng wastong mga kredensyal sa pagpapatotoo. Ang mga user ng libreng tier ay may 20 na kahilingan bawat araw na limitado sa BTC. Ang Trader tier (400 na kahilingan/araw) at Pro tier (4,000 na kahilingan/araw) ay nagbubukas ng lahat ng symbols at advanced features.

Pagpapatotoo

Ang Smart Money API ay gumagamit ng API key authentication. Ang pangunahing paraan ay ang X-API-Key request header. Maaari kang bumuo ng mga API key mula sa iyong dashboard. Ang isang session JWT sa pamamagitan ng Authorization: Bearer ay tinatanggap bilang fallback para sa browser/dashboard sessions, ngunit ang mga API client ay dapat gumamit ng X-API-Key.

API Key Authentication (pangunahin)

Ipadala ang iyong API key sa X-API-Key header sa bawat kahilingan. Huwag kailanman ilagay ang iyong key sa isang 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 (fallback)

Ang mga browser/dashboard sessions ay maaaring magpasa ng session JWT sa pamamagitan ng Authorization: Bearer (may bisa sa loob ng 24 na oras). Ang mga programmatic client ay dapat mas gusto ang X-API-Key.

Python

import requests
import json

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

# Gamitin ang JWT para sa mga kasunod na kahilingan
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Base URL & Endpoints

Ang lahat ng mga kahilingan sa API ay pupunta sa https://api.smartmoneyapi.com. Ang API ay organisado sa mga lohikal na kategorya ng resource na may mga version prefix. Ang kasalukuyang stable version ay v1.

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

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

Format ng Tugon

Ang lahat ng mga tugon sa API ay ibinalik bilang JSON objects na may standard envelope format. Ang mga matagumpay na tugon ay nagbabalik ng HTTP 200-299 status codes na may data sa response body. Ang mga error response ay kasama ang detalyadong mensahe ng error at mga mungkahi sa resolusyon.

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

Whale Positions Endpoint

Kunin ang detalyadong mga posisyon mula sa minomonitor na whale wallets sa lahat ng exchange. Ang endpoint na ito ay nagpapakita ng real-time leverage, entry prices, liquidation prices, at unrealized P&L para sa mga high-value positions.

GET /v1/whales/events PRO

Parameter	Uri	Paglalarawan
symbol	string	Trading pair (hal., BTCUSDT, ETHUSDT) opsyonal
exchange	string	Filter by exchange: bybit, binance, hyperliquid opsyonal
min_position_size	number	Minimum position size sa base asset opsyonal
direction	string	long o short positions lamang opsyonal
page	integer	Pagination page number, default 1 opsyonal
limit	integer	Mga resulta bawat pahina, max 100, default 50 opsyonal

Halimbawang Kahilingan:

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

Mag-access ng real-time at historical funding rates sa Bybit, Binance, at Hyperliquid. Ang mga funding rates ay kritikal para sa arbitrage trading, swing strategies, at derivatives hedging. Ang aming API ay nag-aaggregate ng mga rate na may 15-minute granularity at nagbibigay ng historical rate analysis.

GET /v1/funding-rates LIBRE

Parameter	Uri	Paglalarawan
symbol	string	Trading pair (hal., BTCUSDT) kailangan
exchange	string	Exchange: bybit, binance, hyperliquid opsyonal
interval	string	1h, 4h, 1d, default 1h opsyonal
limit	integer	Historical periods na ibabalik, max 500 opsyonal

Halimbawang Kahilingan:

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

Subaybayan ang kabuuang open interest sa lahat ng leverage traders. Ang pagkakaiba ng open interest sa galaw ng presyo ay nagpapahiwatig ng potensyal na pagbabalik at mga oportunidad sa pagpapatuloy ng trend. Subaybayan ang parehong absolute OI at OI change rates.

GET /v1/open-interest TRADER

Parameter	Uri	Paglalarawan
symbol	string	Pares ng pangangalakal required
exchange	string	bybit, binance, o hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, default 15m optional

Liquidations Endpoint

Nagbabalik ng dalawang komplementaryong view para sa isang symbol: leverage-projected levels (isang estima kung saan naka-cluster ang mga liquidation) at isang realized_heatmap — ang TUNAY na intensity ng forced-liquidation (presyo × oras) na naipon nang live mula sa mga public exchange WebSocket feeds: Binance, OKX, Bybit, Bitget, at BitMEX. Ang heatmap ay ipinapakita kapag may data ang stream para sa symbol.

GET /v1/liquidations TRADER

Parameter	Uri	Paglalarawan
symbol	string	Asset symbol, default BTC optional

Trader nagbabalik ng cascade risk, pinakamalapit na distansya, at realized totals/by-side. Pro nagbabalik ng buong projected levels kasama ang buong realized_heatmap (matrices, per-price clusters, per-exchange counts).

On-Chain DeFi Liquidations

Na-execute na DeFi lending-protocol liquidations na direktang kinuha mula sa aming sariling local BSC at Avalanche full nodes — hiwalay sa anumang trading bot. Sakop ang Venus/Cream at Moolah sa BSC, at AAVE V3/V2, Benqi, BankerJoe, Granary at Vinium sa Avalanche. Nangangailangan ng authenticated key (Trader+); Pro ay nagbabalik din ng bot-dependent na at-risk positions.

GET /v1/liquidations/onchain TRADER

Parameter	Uri	Paglalarawan
chain	string	bsc o avax; huwag isama para sa lahat optional
limit	integer	Max na row, default 100, max 500 (pinakabago-una) optional

Confirmation Endpoint

Ang /v1/confirm endpoint ay nagbabalik ng rule-based, multi-factor confluence score na pinagsasama ang derivatives, on-chain (libreng Coin Metrics: MVRV / exchange-flow / active-address), at whale positioning. Ang composite ay mula -1.0 hanggang +1.0 (hindi 0–100) at bawat response ay may transparent na factors breakdown (per-leg score × weight), adjustments, weights, at coverage. Ito ay decision support, hindi garantisadong win-rate. Ang hindi na-track na symbol ay nagbabalik ng tahasang NO_DATA / unsupported na resulta imbes na pekeng LOW.

GET /v1/confirm TRADER

Parameters: symbol (BTC/ETH/SOL) at direction (long/short). confidence ay isa sa HIGH / MEDIUM / LOW / VETO / NO_DATA; action ay isa sa CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult ay ang iminungkahing position-size multiplier.

On-Chain Data Endpoints

I-access ang Bitcoin at Ethereum on-chain metrics kasama ang exchange flows, whale wallet movements, MVRV ratio, NUPL, spending conditions, at realized volatility. Ang mga metric na ito ay nagpapakilala ng accumulation/distribution cycles at nagbibigay ng maagang signal para sa mga malalaking pagbabalik.

GET /v1/on-chain/metrics PRO

Parameter	Uri	Paglalarawan
asset	string	bitcoin o ethereum required
metrics	array	Tiyak na metrics: exchange_flows, mvrv, nupl, whale_moves optional
interval	string	1d (araw-araw), 1w (lingguhan), default 1d optional

Data Models Reference

Ang pag-unawa sa istruktura ng API responses ay mahalaga para sa integrasyon. Nasa ibaba ang kumpletong depinisyon ng data model na ginagamit sa lahat ng 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
  }
}

Mga Halimbawa ng Code

Nasa ibaba ang mga halimbawa ng code na handa nang gamitin para sa mga karaniwang pattern ng pagsasama.

Subaybayan ang mga Posisyon ng Whale sa 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:
        """Kunin ang mga posisyon ng whale na may opsyonal na filter ng simbolo"""
        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:
        """Kunin ang kasalukuyan at makasaysayang mga funding rate"""
        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):
        """Patuloy na subaybayan ang mga posisyon ng whale"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Whale {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Paggamit
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Kabuuang posisyon ng whale: {whales['data']['total']}")

Mga Pinakamahusay na Pamamaraan at Mga Tip sa Pagganap

Gumamit ng pagination: Laging paginate ang malalaking resulta. Gamitin ang limit at page parameter para kunin ang data sa 50-100 record na chunks, hindi lahat ng data nang sabay-sabay.

I-cache ang mga response: Hindi nagbabago ang mga posisyon ng whale kada segundo. I-cache ang mga resulta sa loob ng 30-60 segundo para mabawasan ang mga API call at mapabuti ang performance.

Mag-filter nang maaga: Gumamit ng query parameter (symbol, exchange, direction) para mag-filter ng data sa server-side, hindi sa iyong application code.

Hawakan ang mga rate limit: Magpatupad ng exponential backoff retry logic. Kapag naabot mo ang rate limits (429 status), maghintay at subukan muli.

Gumamit ng WebSocket para sa real-time: Para sa streaming data, mas mainam na gumamit ng WebSocket connection kaysa sa pag-poll ng REST endpoint. Makakatipid ka ng bandwidth at makakakuha ng sub-second latency.

I-validate ang mga timestamp: Lahat ng timestamp ay ISO 8601 UTC. Laging i-convert sa iyong lokal na timezone para sa display at laging i-store sa UTC.

Hawakan ang mga disconnection: Magpatupad ng automatic reconnection logic na may exponential backoff para sa WebSocket connection.

Subaybayan ang iyong quota: Suriin ang X-Requests-Remaining header sa mga response. Planuhin ang iyong paggamit ng API para manatili sa loob ng iyong tier limit.

Mga Karaniwang Pattern ng Pagsasama

Pattern 1: Alert sa Whale Accumulation

Mag-set up ng mga alert kapag tumaas ang mga posisyon ng whale lampas sa isang threshold, na nagpapahiwatig ng potensyal na bull run o accumulation phase.

Pattern 2: Pag-detect ng Funding Rate Arbitrage

Awtomatikong makita kapag lumampas ang funding rate spread sa mga profitable threshold sa iba't ibang exchange, na nagpapagana ng cross-exchange arbitrage algorithm.

Pattern 3: Pagsubaybay sa Liquidation Cascade

Subaybayan ang malalaking liquidation at iposisyon ang algorithm para samantalahin ang cascading liquidation at high-impact price move.

Pattern 4: Multi-Signal Confirmation

Pagsamahin ang mga posisyon ng whale, funding rate, on-chain metrics, at aming AI confirmation score para sa high-conviction entry signal.

Handa Nang Magsimula?

Kunin ang iyong API key mula sa console at magsimulang magtayo ngayon. Lahat ng bagong account ay makakakuha ng libreng tier access na may 100 request kada araw (BTC, ETH, SOL). Mag-upgrade sa Trader o Pro para sa walang limitasyong access sa lahat ng simbolo at advanced feature.

Kunin ang API Key

I-unlock ang Mga Pro Feature

Makakuha ng buong access sa mga posisyon ng whale, confirmation score, on-chain data, at 2000+ daily API request.

Tingnan ang Presyo