Комиссии и заработок

Официальные страницы: Fee Configuration и Fees

Из чего складывается цена свопа#

1. Платформенная комиссия 1Click — 0.2% для анонимных запросов; 0% с партнёрским JWT (поэтому токен обязателен для продакшена).
2. Спред маркет-мейкеров — заложен в котировку; виден как разница между USD-оценкой входа и выхода (страница «Котировка» показывает его).
3. Сетевые комиссии — газ на депозит и вывод; часть видна в полях refundFee / withdrawFee ответа котировки.
4. Ваша комиссия (appFees) — то, что зарабатываете вы как канал дистрибуции.

Как добавить свою комиссию#

В запрос котировки добавляется массив appFees:

{
  "appFees": [
    { "recipient": "your-fee-wallet.near", "fee": 50 }
  ]
}

• fee указывается в базисных пунктах: 50 = 0.5%, 100 = 1%. Максимум 500 (5%).
• recipient — NEAR-адрес (именованный аккаунт, implicit-аккаунт или EVM-подобный адрес), куда придёт комиссия.
• Комиссия удерживается из входного токена.
• Revenue share по умолчанию 50/50: половина fee идёт вам, половина — протоколу 1Click. Например, "fee": 10 — это 5 б.п. вам и 5 б.п. 1Click.

Как комиссия применяется по типам свопа:

Агрегация комиссий (ANY_INPUT)#

Если комиссии приходят во множестве разных токенов, тип свопа ANY_INPUT позволяет собирать их на один выделенный depositAddress и автоматически конвертировать в выбранный актив (вывод — при накоплении $1000):

1. Создаётся ANY_INPUT-котировка с originAsset: "1cs_v1:any" и amount: "0" (обязательно с JWT).
2. Полученный depositAddress указывается как appFees.recipient в обычных пользовательских котировках.
3. Выводы отслеживаются через GET /v0/any-input/withdrawals?depositAddress=....

Важно: у ANY_INPUT нет возвратов — неудачные свопы ретраятся каждые 5 минут; refundTo указывайте на подконтрольный вам адрес.

Практические советы#

• Всегда сравнивайте amountInUsd и amountOutUsd в котировке — это быстрый способ увидеть суммарные издержки для пользователя.
• Меняя appFees, прогоняйте dry-котировку и смотрите, как изменился amountOut.
• Комиссия — предмет продуктового решения: слишком высокая сделает ваши цены неконкурентными.