Документація API
Дані часових рядів та запити історичного аналізу
Отримайте доступ до повних даних часових рядів для бектестингу, досліджень та історичного аналізу. Запитуйте свічки OHLCV, історичні фандингові ставки, часові рамки руху китів та агреговані знімки ринку для різних часових інтервалів.
Опубліковано 21 березня 2026
•
15 хв читання
•
Дослідження
Огляд історичних даних
Smart Money API надає 24 місяці історичних даних для всебічних досліджень, бектестингу та аналізу за часом. Усі історичні дані нормалізовані, очищені від дублікатів та доступні на різних рівнях агрегації.
Доступні історичні дані включають:
- Свічки OHLCV — Open, High, Low, Close, Volume для всіх торгуваних пар
- Рух китів — Історичні дані про накопичення/розподіл з щоденною та погодинною деталізацією
- Фандингові ставки — Історичні знімки фандингових ставок для всіх перпетуальних пар
- Відкритий інтерес — Історичні дані OI для всіх бірж та часових інтервалів
- Ліквідації — Історичні каскади ліквідацій та точки тиску
Зберігання даних: Повні тикові дані зберігаються протягом 90 днів. Агреговані погодинні/щоденні дані зберігаються протягом 24 місяців. Сирі архіви доступні для завантаження.
Дані свічок OHLCV
Дані Open-High-Low-Close-Volume для технічного аналізу та побудови графіків. Доступні для всіх криптовалютних пар у часових інтервалах від 1 хвилини до 1 місяця.
Структура даних OHLCV
{
"timestamp": 1709980800000,
"symbol": "BTCUSDT",
"timeframe": "1h",
"open": 71250.50,
"high": 72500.00,
"low": 71000.25,
"close": 72250.75,
"volume_base": 1234.5,
"volume_quote": 89234500,
"trades": 45678
}
Запит даних OHLCV
// Отримати 1-годинні свічки за останні 30 днів
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
lookback=30d&
limit=720
Отримайте API-ключ за 30 секунд
Готові будувати? Отримайте безкоштовний API-ключ (100 запитів/день, без картки) та почніть отримувати дані про китів, фандинг та ончейн-дані.
Отримайте API-ключ →Доступні часові інтервали
Опції часових інтервалів
| Часовий інтервал |
Тривалість |
Випадок використання |
Максимальний період |
| 1m |
1 хвилина |
Високочастотний трейдинг, скальпінг |
30 днів |
| 5m |
5 хвилин |
Внутрішньоденний трейдинг, свінг-трейдинг |
90 днів |
| 15m |
15 хвилин |
Денний трейдинг, виявлення сигналів |
180 днів |
| 1h |
1 година |
Середньостроковий трейдинг, аналіз |
365 днів |
| 4h |
4 години |
Свінг-трейдинг, аналіз трендів |
24 місяці |
| 1d |
1 день |
Довгострокове позиціонування, дослідження |
24 місяці |
| 1w |
1 тиждень |
Макроаналіз, багаторічні тренди |
24 місяці |
| 1M |
1 місяць |
Стратегічне позиціонування |
24 місяці |
Комбінації часових інтервалів
Запитуйте кілька часових інтервалів одночасно:
GET /v1/historical/ohlcv/multi?
symbol=BTCUSDT&
timeframes=1h,4h,1d&
timestamp=1709980800000
// Повертає останню свічку для кожного часового інтервалу
Шаблони історичних запитів
Часові запити
// Запит конкретного часового діапазону
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1h&
start_time=1709894400000&
end_time=1709980800000
// Або використовуйте відносний період
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1d&
lookback=90d
Пагінація для великих наборів даних
// Перша сторінка: 1000 свічок
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
limit=1000&
start_time=1709980800000
// Наступна сторінка з використанням курсору
GET /v1/historical/ohlcv?
symbol=BTCUSDT&
timeframe=1m&
cursor=1709981000000&
limit=1000
Інтервали агрегації
Фіксована часова агрегація
Агрегуйте дані з фіксованими інтервалами (щогодини, щодня, щотижня):
// Щоденні знімки за 1 місяць
GET /v1/historical/snapshots?
metrics=whale_net_flow,funding_rate,oi&
interval=1d&
lookback=30d
Користувацька агрегація
Агрегуйте за власними часовими вікнами:
// Агрегуйте 1-хвилинні свічки в 15-хвилинні
GET /v1/historical/ohlcv/resample?
symbol=BTCUSDT&
source_timeframe=1m&
target_timeframe=15m&
lookback=7d
Історія руху китів
Історичне відстеження китів
// Історичні моделі накопичення китів
GET /v1/historical/whales?
asset=BTC&
metric=net_accumulation&
interval=1d&
lookback=365d
// Історичний рух навколо рівнів цін
GET /v1/historical/whales/price-correlation?
asset=ETH&
lookback=90d
Структура даних китів
{
"timestamp": 1709980800000,
"asset": "BTC",
"metric": "net_accumulation",
"value": 50000,
"whale_count": 847,
"exchange_inflow": -12000,
"exchange_outflow": 62000
}
Історія ставок фінансування
Історичні знімки ставок фінансування
// Отримайте щогодинні знімки ставок фінансування
GET /v1/historical/derivatives/funding-heatmap?
symbol=BTCUSDT&
exchange=binance&
interval=1h&
lookback=30d
// Порівняйте історичні ставки на різних біржах
GET /v1/historical/derivatives/funding-heatmap/comparative?
symbol=ETHUSDT&
exchanges=bybit,binance,hyperliquid&
interval=4h&
lookback=90d
Статистика ставок фінансування
Запит агрегованої статистики ставок фінансування:
GET /v1/historical/derivatives/funding-stats?
symbol=BTCUSDT&
lookback=365d&
metrics=mean,median,std_dev,min,max
// Відповідь включає:
// - Річну середню ставку фінансування
// - Розподіл (стандартне відхилення)
// - Історичні екстремуми
// - Процентильні ранги
Доступ до даних для бектестингу
Формат запиту для бектестингу
Оптимізовано для фреймворків бектестингу, таких як Backtrader, VectorBT та власних двигунів:
// Отримайте всі дані для 1-річного бектестингу
GET /v1/backtest/data?
symbols=BTCUSDT,ETHUSDT&
timeframe=1h&
start=2024-01-01&
end=2025-01-01&
fields=ohlcv,funding_rate,oi,whale_flow
Формати експорту
Завантажте історичні дані для офлайн-аналізу:
- CSV — Стандартний стовпцевий формат для електронних таблиць
- JSON — Структурований формат з усією метадатою
- Parquet — Стиснений стовпцевий формат для науки про дані
- HDF5 — Оптимізований формат для часових рядів
// Експортуйте як CSV
GET /v1/backtest/export?
symbols=BTCUSDT&
timeframe=1d&
lookback=365d&
format=csv
Практичні приклади
Приклад 1: Дослідження бичачого ринку 2024 року
// Корелюйте рух китів з ціновими діями
GET /v1/historical/correlated-data?
asset=BTC&
start_time=2024-01-01&
end_time=2024-12-31&
include=ohlcv,whale_accumulation,funding_rates&
interval=1d
Приклад 2: Бектестинг стратегії фандинг-рейтів
// Отримайте дані для стратегії реверсії до середнього фандинг-рейту
GET /v1/backtest/data?
symbols=BTCUSDT,ETHUSDT,BNBUSDT&
timeframe=4h&
start=2023-01-01&
end=2025-01-01&
exchange=binance&
fields=funding_rate,open_interest,liquidations
Найкращі практики роботи з історичними даними
1. Виберіть відповідний часовий інтервал
Використовуйте найменший часовий інтервал, необхідний для вашого аналізу. Дані за 1 хвилину дорожчі, ніж годинні дані.
2. Вкажіть часові діапазони
Завжди використовуйте параметри start_time/end_time або lookback. Відкриті запити неефективні.
3. Кешуйте історичні запити
Історичні дані незмінні. Кешуйте агресивно (TTL 30 днів для місячних даних).
4. Використовуйте пагінацію для великих результатів
Дані за 1 хвилину за 1 рік = 525,600 свічок. Використовуйте пагінацію та потокове передавання для великих наборів даних.
5. Перевіряйте повноту даних
Перевіряйте метадані відповіді на наявність прогалин або відсутніх бірж перед використанням даних у аналізі.
Доступ до історичних даних для досліджень
24 місяці даних OHLCV, руху китів та фандинг-рейтів. Ідеально підходить для бектестингу, досліджень та розробки стратегій.
Переглянути плани
Безкоштовний рівень: 30d історії. Pro: 24 місяці. Enterprise: Повний доступ до архіву.