Користувачі втрачають до 10% на спреді при ручному пошуку по пулах. Інтеграція 1inch API (v6) вирішує це за 2–3 дні: протокол сплітує ордер по 200+ джерелах ліквідності та знаходить найкращий курс. Ми беремо на себе інтеграцію, налаштування slippage, обробку approve та тестування — ви отримуєте агрегатор з мінімальним часом виходу на ринок. Наш досвід: 5+ років у DeFi, 20+ проєктів з інтеграції DEX-агрегаторів.
Чому інтеграція критична для DeFi-продукту?
Користувачі очікують найкращий курс без ручного пошуку по пулах. Інтеграція через 1inch забезпечує швидкий роутинг: власна реалізація потребувала б тижнів, тоді як готове рішення — дні. Економія часу та коштів суттєва: ви отримуєте перевірений агрегатор без витрат на розробку та налагодження власного роутингу.
Застарілий quote та slippage при виконанні
GET /v6.0/1/quote повертає toAmount — очікувану кількість токенів на виході. Між моментом отримання quote та виконанням транзакції проходить час. На волатильному ринку за 10–30 секунд ціна може зміститися на 0.5–2%.
Якщо передавати в POST /v6.0/1/swap параметр slippage=1 (1%), при реальному русі ринку на 1.5% транзакція заревільється — користувач заплатив газ і нічого не отримав. Правильно: динамічно встановлювати slippage на основі волатильності пари: 0.5% для stable‑пар, 1–3% для волатильних.
Ще одна проблема: toAmount з /quote не збігається з toAmount з /swap. Це нормально — /swap будує фінальний calldata з урахуванням поточного стану пулів. Показувати користувачу цифру з /quote, а підписувати транзакцію з /swap — правильна практика.
Approve та permit: два патерни
1inch Aggregation Router v6 приймає tokens через стандартний ERC-20.approve. Але для кращого UX підтримується також permit (EIP-2612) — gasless approve через підпис. Якщо токен реалізує EIP-2612 (DAI, USDC на Ethereum, більшість сучасних ERC-20), потрібно використовувати /approve/transaction endpoint тільки як fallback.
Перевірка підтримки permit: викликати token.nonces(address) — якщо не reverting, permit підтримується.
Другий тип approve — 1inch Permit2 (аналог Uniswap Permit2). Якщо користувач вже дав approve в Permit2 для іншого протоколу, повторний approve не потрібен. Це покращує UX при частих свопах.
Як інтегрувати 1inch API в dApp?
Структура запитів
Базовий флоу для swap віджета:
-
GET /v6.0/{chainId}/tokens— кешуємо список підтримуваних токенів (раз на годину достатньо) -
GET /v6.0/{chainId}/quote?src=...&dst=...&amount=...— отримуємо quote, показуємо користувачу -
GET /v6.0/{chainId}/approve/allowance?tokenAddress=...&walletAddress=...— перевіряємо поточний allowance - Якщо allowance < amount:
GET /v6.0/{chainId}/approve/transaction→ підписуємо approve -
POST /v6.0/{chainId}/swap→ отримуємо calldata, відправляємо транзакцію
Для мультичейн підтримки використовуємо chainId в URL. 1inch API описує всі ендпоїнти.
Обробка помилок API
1inch v6 повертає HTTP 400 з JSON body при будь-якій помилці бізнес-логіки. Типові коди:
| Код | Опис |
|---|---|
Cannot estimate |
Недостатньо ліквідності для запитуваної суми |
Insufficient liquidity |
Те саме, явно |
fromTokenAddress cannot be equal to toTokenAddress |
UI баг |
| 429 | Rate limit. Free tier: 1 RPS, Growth: 10 RPS, Enterprise: без обмежень |
Rate limiting потрібно обробляти через exponential backoff, не надсилати запити повторно негайно.
Classic vs Fusion: що обрати?
| Характеристика | Classic REST API | Fusion (orderbook) |
|---|---|---|
| Спосіб виконання | Користувач платить газ | Resolver платить газ (gasless) |
| Комісія | Фіксована + мережеві збори | Включена в slippage |
| Складність інтеграції | Низька (REST + бібліотека) | Середня (потрібен Fusion SDK) |
| Рекомендований сценарій | Swap віджет, простий агрегатор | Просунутий UX, мінімізація комісії |
Для простої інтеграції (swap віджет, агрегатор в dApp) — Classic mode через REST API. Для просунутого UX з gasless transactions — Fusion.
Перевірка calldata
Перед відправкою транзакції користувачем — завжди симулювати через eth_call. Це дозволяє зловити revert до витрат газу. В wagmi/viem:
const { data } = await publicClient.call({ account: userAddress, to: swapData.tx.to, data: swapData.tx.data, value: BigInt(swapData.tx.value), }); Якщо call reverting — показуємо користувачу помилку, не транзакцію.
Що входить в інтеграцію
- Розробка API-шару з типізацією запитів
- React-хуки для стану swap (quote, approve, відправка)
- Обробка помилок та rate limiting
- Підтримка мультичейн (до 7 мереж)
- Тестування на тестнеті (Sepolia)
- Документація та приклади коду
- Гарантована підтримка після запуску (2 тижні)
Технічний стек
viem + wagmi для TypeScript/React додатків — нативна підтримка TypeScript, tree-shaking, хороша інтеграція з WalletConnect та MetaMask. Альтернатива — ethers.js v6 для Node.js бекенду. Для кешування quote даних — React Query з staleTime: 10_000 (10 секунд).
Процес роботи
Аналіз вимог (0.5 дня). Які чейни, які токени, Classic чи Fusion, чи потрібен власний UI або embed віджет.
Розробка (2–3 дні). API шар з типізацією, React хуки для quote/swap flow, обробка allowance, error handling.
Тестування (0.5–1 день). Тести на testnet, перевірка edge cases: немає ліквідності, insufficient balance, expired quote.
Орієнтири по термінах
Базова інтеграція swap функціональності в існуючий dApp: 2–3 дні. Повноцінний swap віджет з мультичейн підтримкою, історією транзакцій та Fusion mode: 1–1.5 тижні. Вартість розраховується індивідуально.
Зв'яжіться з нами для оцінки вашого проєкту. Отримайте консультацію — розкажіть про цілі, і ми запропонуємо оптимальний план інтеграції.