Справочник API (кратко)
Это выжимка для быстрой навигации. Полное описание всех полей — только в официальных источниках:
- OpenAPI-спецификация — единственный источник истины по формам запросов;
- API Reference на docs.near-intents.org.
Base URL: https://1click.chaindefuser.com. Авторизация: заголовок
X-API-Key: YOUR_JWT (см. Аутентификация).
Основные эндпоинты (доступны через прокси портала)#
| Метод | Путь | Назначение | Шаблон в песочнице |
|---|---|---|---|
| GET | /v0/tokens | Список поддерживаемых токенов | шаг 1 — «список токенов» |
| POST | /v0/quote | Котировка (dry: true — предпросмотр, dry: false — с депозитным адресом) | шаг 2 — котировки EXACT_INPUT / EXACT_OUTPUT / FLEX_INPUT (dry) и реальная; шаг 5 — appFees и ANY_INPUT |
| POST | /v0/deposit/submit | Сообщить хеш транзакции депозита (ускоряет обработку) | шаг 3 — «хеш депозита» |
| GET | /v0/status?depositAddress= | Статус свопа по депозитному адресу | шаг 4 — «статус свопа» |
| GET | /v0/any-input/withdrawals?depositAddress= | Выводы по ANY_INPUT-квоте (агрегация комиссий) | шаг 5 — «выплаты ANY_INPUT» |
Прочие эндпоинты (справочно, через прокси не открыты)#
| Метод | Путь | Назначение |
|---|---|---|
| POST | /v0/auth/authenticate | Выпуск User-Session токена по подписи кошелька |
| POST | /v0/auth/refresh | Обновление User-Session токена |
| GET | /v0/account/balances | Приватные балансы пользователя (нужен User-Session токен) |
| GET | /v0/account/history | История транзакций аккаунта (invite-only) |
| POST | /v0/generate-intent | Сформировать intent для подписи (свопы по подписи вместо депозита) |
| POST | /v0/submit-intent | Отправить подписанный intent |
| POST/GET | /v0/orders, /v0/orders/{id}, /v0/orders/{id}/cancel | Лимитные ордера |
Если такой эндпоинт понадобится в песочнице — добавьте его в allowlist прокси
(app/api/proxy/1click/[...path]/route.ts) и создайте шаблон в
providers/1click-near-intents/templates/, сверив форму запроса со
спецификацией.
Статусы свопа#
Типичный успешный путь: PENDING_DEPOSIT → KNOWN_DEPOSIT_TX → PROCESSING → SUCCESS.
Альтернативы — неполная сумма, возврат или ошибка.
| Статус | Значение |
|---|---|
PENDING_DEPOSIT | Ждём поступления депозита на адрес из котировки |
KNOWN_DEPOSIT_TX | Хеш депозита получен, ждём подтверждения сети |
INCOMPLETE_DEPOSIT | Поступила не вся сумма — дослать до deadline или ждать возврата |
PROCESSING | Идёт обмен |
SUCCESS | Готово: средства отправлены получателю |
REFUNDED | Своп не исполнился, средства ушли на refundTo |
FAILED | Ошибка исполнения — см. «Проблемы и FAQ» |
Explorer API#
История всех свопов 1Click доступна через отдельный сервис
https://explorer.near-intents.org — см.
«История и Explorer API».