Уявіть: ваш NFT-трекер показує лише статичний JPEG, а користувачі хочуть бачити, як floor price зріс з 0.05 до 12 ETH за три тижні. Без історії цін будь-який трекер — просто каталог. Ми перетворюємо його на аналітичний інструмент за 2–4 дні, використовуючи перевірені API та кешування. Reservoir API обробляє до 10 разів більше даних, ніж OpenSea на безкоштовному тарифі, а кешування скорочує навантаження на 70%.
Ми — команда мобільних розробників з п'ятирічним досвідом та 20+ завершеними NFT-проєктами. Наша архітектура витримує 600 запитів за хвилину без втрати даних. Середній час відповіді API — 200 мс, що забезпечує плавні графіки. Замовте інтеграцію та отримайте аналітичний інструмент за 2–4 дні.
Чому історія цін критична для NFT-трекера?
Цінова динаміка — це довіра користувача. Якщо ви не показуєте, як змінювалася ціна токена за тиждень або місяць, додаток програє конкурентам. Без історії ви не зможете аналізувати тренди, визначати найкращі моменти для продажу або оцінювати ліквідність колекції. Більш того, без історичних даних неможливо автоматизувати торгові стратегії.
Як API справляються із завантаженням історичних даних?
Блокчейн не зберігає історію цін як окрему сутність. Кожен продаж — це Transfer-подія в смарт-контракті ERC-721 плюс переказ ETH. Щоб побудувати price history, потрібно агрегувати ончейн-події. Ми використовуємо три підходи:
| API | Глибина історії | Rate limit | Маркетплейси |
|---|---|---|---|
| Reservoir API | Необмежено | 10 req/sec | OpenSea, Blur, X2Y2 та інші |
| OpenSea API v2 | 30 днів безкоштовно | 4 req/sec | OpenSea |
| Alchemy NFT API | Необмежено | 10 req/sec | OpenSea, LooksRare |
Reservoir дає найглибшу історію та працює без пагінації, але вимагає API-ключа. OpenSea підходить для швидкого прототипу, але глибше 30 днів — платний план. Alchemy зручний, якщо ви вже використовуєте його для інших запитів.
Звідки береться історія цін
Price history будується з Transfer-подій та логів транзакцій. Смарт-контракти ERC-721 емітять подію Transfer з from, to та tokenId. До неї прив'язується value з основної транзакції — це ціна в wei. Згідно зі специфікацією ERC-721, подія містить три індексованих параметри.
Типовий репозиторій на Flutter:
class NftSalesRepository { final Dio _dio; final String _reservoirKey; Future<List<NftSale>> getSalesHistory({ required String contractAddress, required String tokenId, DateTime? from, }) async { final params = { 'tokens': '$contractAddress:$tokenId', 'startTimestamp': from?.millisecondsSinceEpoch ~/ 1000, 'limit': 100, }; final resp = await _dio.get( 'https://api.reservoir.tools/sales/v6', queryParameters: params, options: Options(headers: {'x-api-key': _reservoirKey}), ); return (resp.data['sales'] as List) .map((e) => NftSale.fromJson(e)) .toList(); } } Ціна приходить в ETH, але користувачі очікують USD. Ми підтягуємо курс через CoinGecko API, кешуємо його 60 секунд та застосовуємо до кожної точки. Це гарантує точність без зайвих запитів.
Кешування: знижуємо навантаження на 70%
Кешування — ключ до продуктивності. Ми використовуємо SQLite з бібліотеками drift (Flutter) або Room (Android). Дані зберігаються з TTL 60 секунд для цін та 300 секунд для метаданих. Це дозволяє скоротити кількість запитів до API на 70% та забезпечити роботу при слабкому з'єднанні. Економія на API-запитах досягає 70%.
| Стратегія | TTL | Застосування |
|---|---|---|
| Дані продажів | 60 сек | Графіки цін |
| Зображення | 300 сек | Картки NFT |
| Курс ETH/USD | 60 сек | Конвертація |
Технічні деталі кешування
Використовуємо SQLite з бібліотеками drift (Flutter) або Room (Android). TTL налаштовується індивідуально: для цін — 60 секунд, для метаданих — 300 секунд. При відсутності мережі дані підвантажуються з кешу, що забезпечує стабільну роботу.Що входить в роботу
- Інтеграція API: Reservoir, OpenSea або Alchemy з повною пагінацією та обробкою помилок.
- Моделі даних: NftSale, PricePoint з конвертацією wei → ETH → USD.
- Кешування: SQLite (drift/floor) з TTL для даних та зображень, з можливістю примусового оновлення.
- Графік: вибір часового діапазону (7d / 30d / All), згладжування, фільтрація викидів.
- Обробка помилок: порожня історія, помилки мережі, ліміти API — все зі зрозумілим UI.
Процес роботи
- Аналітика: вивчення вашого стеку та дизайн-макетів. Визначаємо, які дані потрібні та як часто оновлюються.
- Проектування: вибір API, схеми кешування, архітектури запитів (наприклад, з використанням
GetItдля DI). - Реалізація: інтеграція API, рендеринг графіка, обробка wash-trade (фільтруємо продажі між пов'язаними гаманцями за аналізом кластерів).
- Тестування: unit-тести для репозиторіїв, widget-тести для графіка, нагрузочне тестування до 600 запитів на хвилину.
- Деплой: публікація в App Store / Google Play, налаштування push-сповіщень про великі зміни ціни.
Терміни орієнтовно
Базова інтеграція з графіком займає від 2 до 4 робочих днів. Складність впливає: додаткові фільтри, кастомні контракти або нестандартний дизайн можуть збільшити термін. Вартість розраховується індивідуально після аналізу ваших вимог.
Типові помилки та їх вирішення
- Некоректна конвертація часу: timestamp в блокчейні в секундах, а не мілісекундах — плутають, через що графік з'їжджає на 1970 рік. Ми використовуємо
DateTime.fromMillisecondsSinceEpoch(timestamp * 1000). - Wash-trading: продажі між гаманцями одного власника спотворюють медіанну ціну. Ми застосовуємо кластеризацію за ончейн-зв'язками та виключаємо такі транзакції.
- Застарілі дані: якщо кеш не оновлюється, користувач бачить ціни годинної давності. TTL 60 секунд — золота середина.
Зв'яжіться з нами, щоб обговорити ваш проєкт та отримати індивідуальну пропозицію. Ми гарантуємо стабільну роботу під навантаженням та прозору архітектуру.