1Click / NEAR Intents
О 1Click API
1Click Swap API — это REST API для кросс-чейн свопов на базе протокола NEAR Intents. Он берёт на себя всю сложность: запрашивает цены у маркет-мейкеров (солверов), строит своп, отслеживает исполнение и обрабатывает возвраты.
Официальная страница: About 1Click API
Как это работает (упрощённо)#
- Вы запрашиваете котировку: «хочу обменять X токена A в сети 1 на токен B в сети 2».
- Маркет-мейкеры конкурируют между собой, 1Click возвращает лучшую цену и уникальный депозитный адрес.
- Пользователь переводит средства на депозитный адрес — этим он запускает своп.
- 1Click исполняет обмен и отправляет результат на адрес получателя. Если что-то пошло не так — средства возвращаются на адрес возврата.
Важно: 1Click не хранит средства (не кастодиальный сервис). Активы переходят на квото-специфичный депозитный адрес и рассчитываются он-чейн.
Ключевые факты#
| Что | Значение |
|---|---|
| Base URL | https://1click.chaindefuser.com |
| Формат | REST + JSON |
| Авторизация | Partner JWT в заголовке X-API-Key (или Authorization: Bearer) |
| Без авторизации | Работает, но добавляется платформенная комиссия 0.2% |
| Тестовая сеть | Нет. Проверяйте на маленьких суммах |
| Спецификация | openapi.yaml |
Зачем это нам#
- Один API вместо интеграции с десятками мостов и DEX по отдельности.
- Конкуренция маркет-мейкеров даёт рыночную цену.
- Встроенный механизм комиссий (
appFees) позволяет зарабатывать на каждом свопе — см. «Комиссии и заработок». - Статусы, ретраи и возвраты уже реализованы на стороне 1Click.