Повний довідник REST API

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

Огляд

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

З понад 229 автоматично виявленими торговими символами та 600+ відстежуваними гаманцями китів, API забезпечує комплексну ринкову аналітику. З'єднання WebSocket у реальному часі надають оновлення з затримкою менше секунди, тоді як наші 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

URL WebSocket: 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"
}

Кінцева точка позицій китів

Отримайте детальні позиції з відстежуваних гаманців китів на всіх біржах. Ця кінцева точка показує реальний кредитний плече, ціни входу, ціни ліквідації та нереалізований P&L для високоцінних позицій.

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, так і темпи зміни OI.

GET /v1/open-interest TRADER

Параметр	Тип	Опис
symbol	string	Торгова пара required
exchange	string	bybit, binance, or hyperliquid optional
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, default 15m optional

Ендпоінт ліквідацій

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

GET /v1/liquidations TRADER

Параметр	Тип	Опис
symbol	string	Символ активу, за замовчуванням BTC optional

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

On-Chain DeFi Liquidations

Ліквідації в 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 or avax; omit for all optional
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"Whale {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"Total whale positions: {whales['data']['total']}")

Найкращі практики та поради щодо продуктивності

Використовуйте пагінацію: Завжди розбивайте великі набори результатів на сторінки. Використовуйте параметри limit та page для отримання даних порціями по 50-100 записів, а не всіх одразу.

Кешуйте відповіді: Позиції китів не змінюються щосекунди. Кешуйте результати на 30-60 секунд, щоб зменшити кількість запитів до API та покращити продуктивність.

Фільтруйте на ранньому етапі: Використовуйте параметри запиту (symbol, exchange, direction) для фільтрації даних на стороні сервера, а не у вашому коді.

Обробляйте обмеження частоти: Реалізуйте логіку повторних спроб з експоненційним відступом. При досягненні обмежень частоти (статус 429), зачекайте та повторіть спробу.

Використовуйте WebSocket для даних у реальному часі: Для потокових даних віддавайте перевагу WebSocket-з'єднанням перед опитуванням REST-ендпоінтів. Це зекономить пропускну здатність і забезпечить затримку менше секунди.

Перевіряйте часові мітки: Усі часові мітки мають формат ISO 8601 UTC. Завжди конвертуйте їх у ваш часовий пояс для відображення та зберігайте у UTC.

Обробляйте розриви з'єднання: Реалізуйте логіку автоматичного перепідключення з експоненційним відступом для WebSocket-з'єднань.

Слідкуйте за вашою квотою: Перевіряйте заголовок X-Requests-Remaining у відповідях. Плануйте використання API, щоб залишатися в межах вашої квоти.

Поширені шаблони інтеграції

Шаблон 1: Сповіщення про накопичення китів

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

Шаблон 2: Виявлення арбітражу за ставками фінансування

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

Шаблон 3: Моніторинг каскадних ліквідацій

Відстежуйте великі ліквідації та налаштовуйте алгоритм для використання каскадних ліквідацій та значних рухів цін.

Шаблон 4: Підтвердження за допомогою кількох сигналів

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

Готові почати?

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

Отримати API-ключ

Розблокуйте Pro-функції

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

Переглянути ціни