1Click / NEAR Intents
Справочник API (кратко)
Это выжимка для быстрой навигации. Полное описание всех полей — только в официальных источниках:
- OpenAPI-спецификация — единственный источник истины по формам запросов;
- API Reference на docs.near-intents.org.
Base URL: https://1click.chaindefuser.com. Авторизация: заголовок
X-API-Key: YOUR_JWT (см. Аутентификация).
Основные эндпоинты (доступны через прокси портала)#
| Метод | Путь | Назначение | Шаблон в песочнице |
|---|---|---|---|
| GET | /v0/tokens | Список поддерживаемых токенов | «01 — список токенов» |
| POST | /v0/quote | Котировка (dry: true — предпросмотр, dry: false — с депозитным адресом) | «02/03 — котировка» |
| GET | /v0/status?depositAddress= | Статус свопа по депозитному адресу | «04 — статус свопа» |
| POST | /v0/deposit/submit | Сообщить хеш транзакции депозита (ускоряет обработку) | «05 — хеш депозита» |
| GET | /v0/any-input/withdrawals?depositAddress= | Выводы по 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,
альтернативные исходы: INCOMPLETE_DEPOSIT, REFUNDED, FAILED.
Explorer API#
История всех свопов 1Click доступна через отдельный сервис
https://explorer.near-intents.org — см.
«История и Explorer API».