Полное руководство по REST API

Освойте Smart Money API с нашим подробным REST-руководством. Узнайте все о конечных точках, параметрах, методах аутентификации и реальных схемах интеграции для данных о криптодеривативах и отслеживании китов.

Обзор

Smart Money API предоставляет RESTful-доступ к данным криптовалютных деривативов в реальном времени с трех основных бирж: Bybit, Binance и Hyperliquid. Наш API объединяет позиции китов, ставки финансирования, метрики открытого интереса, данные о ликвидациях и сигналы блокчейна в единый интерфейс. Независимо от того, создаете ли вы торговые алгоритмы, системы управления рисками или инструменты анализа рынка, REST API дает вам прямой программный доступ ко всей информации Smart Money.

Более 229 автоматически обнаруживаемых торговых символов и 600+ отслеживаемых кошельков китов обеспечивают полную рыночную аналитику. Веб-сокет-соединения в реальном времени обеспечивают обновления менее чем за секунду, а наши REST-конечные точки обрабатывают пакетные запросы, получение исторических данных и анализ портфеля в масштабе.

Все запросы должны содержать действительные учетные данные аутентификации. Пользователи бесплатного тарифа имеют ограничение в 100 запросов в день только для BTC. Тарифы Trader (1,000 запросов/день) и Pro (5,000 запросов/день) открывают доступ ко всем символам и дополнительным функциям.

Аутентификация

Smart Money API использует аутентификацию по API-ключу. Основной метод — это X-API-Key заголовок запроса. Вы можете сгенерировать API-ключи в панели управления. JWT-токен сессии через Authorization: Bearer принимается как резервный вариант для сессий браузера/панели управления, но API-клиенты должны использовать X-API-Key.

Аутентификация по API-ключу (основной метод)

Отправляйте ваш API-ключ в заголовке X-API-Key в каждом запросе. Никогда не указывайте ключ в URL.

HTTP

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

JWT-токен сессии (резервный вариант)

Сессии браузера/панели управления могут передавать JWT-токен через Authorization: Bearer (действителен 24 часа). Программные клиенты должны предпочитать X-API-Key.

Python

import requests
import json

# Получить JWT-токен
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# Использовать JWT для последующих запросов
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

Базовый URL и конечные точки

Все запросы к API отправляются на https://api.smartmoneyapi.com. API организован по логическим категориям ресурсов с версионными префиксами. Текущая стабильная версия — v1.

Базовый URL: https://api.smartmoneyapi.com/api/v1

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

Формат ответа

Все ответы API возвращаются в виде JSON-объектов со стандартной структурой. Успешные ответы возвращают HTTP-коды 200-299 с данными в теле ответа. Ошибки содержат подробные сообщения и рекомендации по исправлению.

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

Конечная точка "Позиции китов"

Получайте детализированные позиции с отслеживаемых кошельков китов на всех биржах. Эта конечная точка показывает в реальном времени кредитное плечо, цены входа, цены ликвидации и нереализованную прибыль/убыток по крупным позициям.

GET /v1/whales/events PRO

Параметр	Тип	Описание
symbol	string	Торговая пара (напр., BTCUSDT, ETHUSDT) optional
exchange	string	Фильтр по бирже: bybit, binance, hyperliquid optional
min_position_size	number	Минимальный размер позиции в базовом активе optional
direction	string	Только лонг или шорт позиции optional
page	integer	Номер страницы пагинации, по умолчанию 1 optional
limit	integer	Результатов на странице, максимум 100, по умолчанию 50 optional

Пример запроса:

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"

Конечная точка "Ставки финансирования"

Получайте ставки финансирования в реальном времени и исторические данные по Bybit, Binance и Hyperliquid. Ставки финансирования критически важны для арбитражной торговли, свинговых стратегий и хеджирования деривативов. Наш API агрегирует ставки с детализацией 15 минут и предоставляет анализ исторических ставок.

GET /v1/funding-rates FREE

Параметр	Тип	Описание
symbol	string	Торговая пара (напр., BTCUSDT) required
exchange	string	Биржа: bybit, binance, hyperliquid optional
interval	string	1h, 4h, 1d, по умолчанию 1h optional
limit	integer	Количество возвращаемых исторических периодов, максимум 500 optional

Пример запроса:

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

Эндпоинт открытого интереса

Отслеживайте совокупный открытый интерес среди всех трейдеров с плечом. Расхождение открытого интереса с движением цены сигнализирует о потенциальных разворотах и возможностях продолжения тренда. Контролируйте как абсолютный OI, так и темпы его изменения.

GET /v1/open-interest TRADER

Параметр	Тип	Описание
symbol	string	Торговая пара обязательный
exchange	string	bybit, binance или hyperliquid опциональный
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, по умолчанию 15m опциональный

Эндпоинт ликвидаций

Возвращает два взаимодополняющих представления для символа: уровни, спрогнозированные с учетом плеча levels (оценка расположения кластеров ликвидаций) и realized_heatmap — фактическую интенсивность принудительных ликвидаций (цена × время), агрегированную в реальном времени из публичных WebSocket-каналов бирж: Binance, OKX, Bybit, Bitget и BitMEX. Тепловая карта отображается, если для символа есть данные в потоке.

GET /v1/liquidations TRADER

Параметр	Тип	Описание
symbol	string	Символ актива, по умолчанию BTC опциональный

Trader возвращает каскадный риск, ближайшие расстояния и фактические итоги/по сторонам. Pro возвращает полные прогнозируемые levels плюс полную realized_heatmap (матрицы, кластеры по ценам, количество по биржам).

Ончейн-ликвидации в DeFi

Фактические ликвидации в DeFi-протоколах кредитования, полученные напрямую с наших локальных полных нод BSC и Avalanche — независимо от торговых ботов. Охватывает Venus/Cream и Moolah на BSC, а также AAVE V3/V2, Benqi, BankerJoe, Granary и Vinium на Avalanche. Требуется аутентифицированный ключ (Trader+); Pro дополнительно возвращает зависящие от бота позиции в зоне риска.

GET /v1/liquidations/onchain TRADER

Параметр	Тип	Описание
chain	string	bsc или avax; пропустить для всех опциональный
limit	integer	Максимальное количество строк, по умолчанию 100, максимум 500 (новые первые) опционально

Конечная точка подтверждения

The /v1/confirm конечная точка возвращает основанный на правилах, многофакторный конфлюэнс оценка, объединяющая деривативы, ончейн-данные (бесплатные Coin Metrics: MVRV / обменные потоки / активные адреса) и позиции китов. композитный диапазон от -1.0 до +1.0 (не 0–100), и каждый ответ включает прозрачную факторы разбивку (оценка по позиции × вес), корректировки, веса, и покрытие. Это поддержка для принятия решений, а не гарантированный выигрыш. Неотслеживаемый символ возвращает явный результат NO_DATA / unsupported, а не сфабрикованный LOW.

GET /v1/confirm TRADER

Параметры: symbol (BTC/ETH/SOL) и direction (long/short). confidence может быть HIGH / MEDIUM / LOW / VETO / NO_DATA; action может быть CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP; size_mult это рекомендуемый множитель размера позиции.

Конечные точки ончейн-данных

Доступ к ончейн-метрикам Bitcoin и Ethereum, включая обменные потоки, движения кошельков китов, коэффициент MVRV, NUPL, условия расходования и реализованную волатильность. Эти метрики помогают выявить циклы накопления/распределения и дают ранние сигналы для крупных разворотов.

GET /v1/on-chain/metrics PRO

Параметр	Тип	Описание
asset	string	bitcoin или ethereum обязательно
metrics	array	Конкретные метрики: exchange_flows, mvrv, nupl, whale_moves опционально
interval	string	1d (ежедневно), 1w (еженедельно), по умолчанию 1d опционально

Справочник моделей данных

Понимание структуры ответов API необходимо для интеграции. Ниже приведены полные определения моделей данных, используемых во всех конечных точках.

Объект 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"
}

Объект 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
  }
}

Примеры кода

Ниже приведены готовые к использованию примеры кода для распространенных сценариев интеграции.

Мониторинг позиций китов на 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:
        """Получение позиций китов с возможностью фильтрации по символу"""
        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:
        """Получение текущих и исторических ставок финансирования"""
        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):
        """Непрерывный мониторинг позиций китов"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Кит {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Использование
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Всего позиций китов: {whales['data']['total']}")

Типовые сценарии интеграции

Сценарий 1: Оповещения о накоплении китами

Настройте оповещения, когда позиции китов превышают заданный порог, что может сигнализировать о потенциальном бычьем тренде или фазе накопления.

Сценарий 2: Обнаружение арбитража по ставкам финансирования

Автоматически выявляйте ситуации, когда разница в ставках финансирования между биржами превышает прибыльный порог, что позволяет реализовать арбитражные алгоритмы.

Сценарий 3: Мониторинг каскадных ликвидаций

Отслеживайте крупные ликвидации и настраивайте алгоритм для использования каскадных ликвидаций и значительных ценовых движений.

Сценарий 4: Подтверждение по множеству сигналов

Комбинируйте данные о позициях китов, ставках финансирования, ончейн-метриках и наших AI-оценках для получения высоконадежных сигналов на вход.

Готовы начать?

Получите API-ключ в консоли и начните разработку уже сегодня. Все новые аккаунты получают бесплатный доступ с 20 запросами в день (BTC, ETH, SOL). Перейдите на тариф Trader или Pro для неограниченного доступа ко всем символам и расширенным функциям.

Получить API-ключ

Разблокируйте Pro-функции

Получите полный доступ к данным о позициях китов, оценкам подтверждения, ончейн-данным и 2000+ API-запросам в день.

Посмотреть тарифы

Полное руководство по REST API

Обзор

Аутентификация

Аутентификация по API-ключу (основной метод)

JWT-токен сессии (резервный вариант)

Базовый URL и конечные точки

Формат ответа

Конечная точка "Позиции китов"

Конечная точка "Ставки финансирования"

Эндпоинт открытого интереса

Эндпоинт ликвидаций

Ончейн-ликвидации в DeFi

Конечная точка подтверждения

Конечные точки ончейн-данных

Справочник моделей данных

Объект WhalePosition

Объект FundingRateRecord

Примеры кода

Мониторинг позиций китов на Python

Рекомендации и оптимизация

Типовые сценарии интеграции

Сценарий 1: Оповещения о накоплении китами

Сценарий 2: Обнаружение арбитража по ставкам финансирования

Сценарий 3: Мониторинг каскадных ликвидаций

Сценарий 4: Подтверждение по множеству сигналов

Готовы начать?

Разблокируйте Pro-функции