Crypto swap API позволяет кошельку или платёжному приложению рассчитать курс, создать заявку и довести её до выплаты, не принимая средства пользователя на себя. Провайдеры расходятся в трёх вещах: сколько вы заработаете, сколько живёт расчёт курса и что их документация говорит про сбои. Ниже — таблица и чеклист из 12 пунктов.
Партнёрский API Fswap документирует оба типа курса — rateType: "MARKET" (плавающий) и "FIXED" — и начисляет ваш процент по ключу только по заявкам, дошедшим до статуса FINISH, считая его от USDT-стоимости выплаты (документация API Fswap, октябрь 2026).
SimpleSwap ставит каждому API-ключу комиссию 0,4% по умолчанию и разрешает партнёру поднять её; выплаты в USDT открываются после 300 USDT накоплений (гайд по публичному API SimpleSwap).
StealthEX даёт партнёру задать комиссию в диапазоне от 0 до 0,5% и описывает интеграцию как бесплатную: «никаких ежемесячных платежей, платных планов и лимитов на вызовы» (StealthEX, 2026).
ChangeNOW публикует конкретные лимиты — 1 800 вызовов в минуту и 30 в секунду — при 1 300+ монетах в 100+ сетях (ChangeNOW для партнёров).
Ончейн-маршрут не платит вам, а берёт с вас: у 0x план Standard стоит $1 000, плюс комиссия 0,15% с транзакции и лимит 5 запросов в секунду (тарифы 0x).
Риск провайдера — не теория. LetsExchange остановил обменные операции 1 октября 2026 года, поддержка работает только до 30 ноября (уведомление LetsExchange). Один жёстко прописанный провайдер — одна точка отказа.
API обмена для кошелька заменяет четыре экрана четырьмя запросами: получить список монет, рассчитать курс по паре, создать заявку и опрашивать её статус до выплаты. Средства пользователя не проходят через ваши серверы — они уходят на депозитный адрес, который выдаёт провайдер, а выплата идёт прямо на адрес, введённый пользователем.
За этой одинаковой схемой стоят две разные архитектуры, и ведут себя они не одинаково:
Офчейн-API мгновенных свопов направляют каждую заявку поставщику ликвидности или бирже. Они покрывают монеты из несвязанных сетей — Monero, Bitcoin, Tron, TON — и умеют давать фиксированный курс, потому что ценовой риск берёт на себя провайдер. API Fswap, например, запрашивает курс сразу у нескольких поставщиков (их может быть до девяти) и возвращает тот, который готов исполнить.
Ончейн-API агрегаторов собирают транзакцию, которую пользователь подписывает своим кошельком. Они дают доступ к миллионам токенов, но только внутри поддерживаемых сетей, рассчитываются в одном блоке и никогда не фиксируют курс — расчёт остаётся оценкой до момента подтверждения.
На практике разделение такое: офчейн-API закрывает кроссчейн-пары и даёт цифру, которую не страшно показать пользователю. Ончейн-API закрывает длинный хвост токенов в одной сети и перекладывает риск исполнения на пользователя. Если это различение для вас новое, механику разбирали в материале про модели P2P, DEX и DeFi-обменов.
Решающая колонка — предпоследняя. Всё остальное у провайдеров примерно сопоставимо; а вот сколько вам реально платят и готов ли провайдер назвать цифру — нет.
Провайдер | Заявленное покрытие | Фиксированный курс | Аккаунт для пользователя | Ваша комиссия | Документация и лимиты |
|---|---|---|---|---|---|
API Fswap | Живой список через | Да — | Не нужен для свопа; действует AML-политика | Фиксированный процент на API-ключ ( | Публичная документация + OpenAPI JSON; описаны все коды ошибок, правила повторов и тестовые ID заявок |
2 800+ криптовалют | Да — параметр | Не нужен — «регистрация не требуется» | 0,4% на ключ по умолчанию, партнёр может поднять; выплата в USDT от 300 USDT | API v3, заголовок | |
2 000+ криптовалют, 100+ фиатных | Да — плавающий или фиксированный | Не нужен для свопа | Партнёр задаёт 0–0,5% | Публичная документация + Postman; заявлено отсутствие лимитов на вызовы | |
1 300+ монет, 100+ сетей | Да — отдельные методы для фиксированного курса | Не нужен для свопа; проверки при срабатывании AML | Партнёрские ставки «от 0,4%» | Документация в Postman, | |
10 млн+ токенов, 150+ источников ликвидности | Нет — ончейн-расчёт, истекает | Аккаунт не нужен; подписывает сам пользователь | Вы задаёте | Полный справочник + ключ в дашборде; 5 запросов/сек на Standard | |
1 000+ криптоактивов | Да — «фиксированный и плавающий курс на выбор» | Не нужен для свопа; проверки при срабатывании AML | «До 50% revenue share»; базовая комиссия не опубликована | Ключи по запросу; с бизнес-страницы нет ссылки на документацию | |
3 600+ монет, 675 сетей, 40+ подключённых партнёров | На B2B-странице не указано | Не нужен для свопа | «Встроенный rev share» — цифра не опубликована | Публичная документация; ключ после регистрации |
Порядок — по тому, насколько точно публичная документация провайдера определяет вашу выплату: от конкретного процента на ключ с описанной базой расчёта и правилом начисления до заявления про revenue share без базовой цифры. Числа по покрытию — собственные данные провайдеров на 9 октября 2026 года: они self-reported, считаются по-разному (монеты, токены, сети) и не проверены независимо. Fswap не публикует в документации API цифру каталога, поэтому вместо неё указан живой эндпоинт.
Офчейн, кроссчейн, строго crypto-to-crypto. Расчёт возвращает rateCalcId, который живёт два часа на плавающем курсе и пять минут на фиксированном; окно на депозит — соответственно 120 и 15 минут. В документации прямо сказано, что у claims/create нет ключа идемпотентности, что недействительный API-ключ обрабатывается молча и без привязки к вам, а чтение заявки не проверяет владельца — такие детали большинство провайдеров оставляет выяснять уже в продакшене.
REST API v3 с десятью типами запросов, ключ в заголовке x-api-key. Комиссия на ключ стартует с 0,4%, её можно поднять — с прямой оговоркой, что это изменит курс, который увидит пользователь. Для фиатных обменов 0,4% не меняется. Выплаты открываются после 300 USDT.
Покрытие 2 000+ криптовалют и 100+ фиатных, комиссию партнёр задаёт сам в диапазоне 0–0,5%. Публичная документация плюс коллекция Postman, без платных тарифов и квот на запросы — разумный вариант по умолчанию для небольшого кошелька, которому нужна предсказуемая стоимость.
1 300+ монет в 100+ сетях и более 2 250 000 пар; фиксированный курс реализован отдельными эндпоинтами, а не флагом. Единственный в подборке, кто публикует конкретную пропускную способность: 1 800 вызовов в минуту, 30 в секунду. Партнёрские ставки — от 0,4% и обсуждаются индивидуально.
Ликвидность из 150+ источников и доступ к 10 млн+ токенов, монетизация встроена через swapFeeBps и swapFeeRecipient (лимит по умолчанию 1 000 базисных пунктов, то есть 10%). Платите за это стоимостью и охватом: план Standard заявлен за $1 000 плюс 0,15% с транзакции и 5 запросов в секунду, а любой своп остаётся внутри сетей, которые поддерживает 0x.
1 000+ активов, оба типа курса и обещание «до 50% revenue share», плюс модели CPA, CPI и гибрид. База, к которой применяются эти 50%, не опубликована, а с бизнес-страницы нет ссылки на справочник API — ключи и условия вы получаете в переписке.
Это агрегатор, а не одна площадка: 3 600+ монет в 675 сетях из 40+ подключённых партнёров, среди них CEX, DEX и офчейн-ликвидность. В такой широте и смысл — но она же означает, что заявка пользователя может уйти к любому из партнёров, у каждого свои правила возврата. Про rev share сказано без цифры.
Исходить нужно из того, что ваши пользователи реально обменивают, а не из самого большого числа монет. Решают пять вопросов:
Кроссчейн или одна сеть? Если нужны BTC → Monero или TON → USDT, ончейн-агрегатор не поможет вовсе. Если нужен редкий ERC-20, его, скорее всего, нет в списке офчейн-API.
Нужно ли показать гарантированную сумму? Платёжным и счётным сценариям — нужно. Это отсекает ончейн-расчёты и делает фиксированный курс обязательным, вместе с более коротким окном на депозит.
Ваша комиссия — опубликованная цифра или предмет переговоров? Описанный процент на ключ, который можно сверить, лучше заголовка «до 50%», который невозможно посчитать.
Кто держит средства? Некастодиальная маршрутизация избавляет вас от хранения денег пользователей, а это полностью меняет операционную и комплаенс-картину. Разницу разбирали в материале про кастодиальные и некастодиальные обмены.
Что будет, когда что-то сломается? Читайте таблицу ошибок раньше списка фич. Провайдер, который описал возвраты, истечение срока и правила повторов, тем самым говорит, что уже сталкивался с этими случаями.
Если нужен кроссчейн без аккаунтов, с обоими типами курса и сверяемой выплатой, API Fswap подходит напрямую: один API-ключ в заголовке x-user-api-key, фиксированная комиссия на ключ уже внутри расчёта, начисление в USDT в течение нескольких минут после перехода заявки в FINISH и описанный эндпоинт здоровья для мониторинга. Покрытие пар можно посмотреть на странице популярных пар ещё до первой строчки кода, а те же рельсы закрывают бизнес-сценарии из нашего разбора крипторасчётов в B2B.
Это те сценарии отказа, которые превращаются в обращения в поддержку, а не в строки в логах. Каждый пункт опирается на поведение, описанное провайдерами выше.
Отправляйте один и тот же ключ на расчёт и на создание заявки. Fswap отклонит заявку, если ключ отличается от того, с которым считали курс, и не начислит ничего, если ключа нет в одном из двух вызовов.
Соблюдайте срок жизни расчёта. Два часа для плавающего курса, пять минут для фиксированного. Истёкший идентификатор не повторяют — курс пересчитывают заново.
Ставьте HTTP-таймаут не меньше 15 секунд. Расчёт опрашивает нескольких поставщиков в реальном времени и занимает до ~10 секунд. Параллельные дубликаты одного запроса отправлять не нужно.
Никогда не повторяйте создание заявки слепо. Ключа идемпотентности нет, поэтому повтор после таймаута может создать вторую заявку. Максимум один повтор, дальше — поиск заявки.
Сохраняйте ID заявки до того, как что-то отрисуете. В неавторизованном вызове это единственная ручка к заявке: потеряли — через публичный API её не достать.
Относитесь к этому ID как к секрету. Эндпоинт чтения заявки у Fswap не проверяет владельца, так что любой, у кого есть ID, увидит адреса, хеши и суммы.
Собирайте memo или destination tag, если монета их требует. Список монет это помечает; extra ID передаётся без валидации, и без него выплата может потеряться.
Сначала проверяйте адрес выплаты по сети получения. Используйте эндпоинт валидации и считайте ответ true как «не отклонён», а не как гарантию.
Обрабатывайте не-OK статусы, которые приходят с HTTP 200. «Сумма ниже минимума» и «курс недоступен» — это статусы, а не ошибки: показывайте пользователю вернувшиеся лимиты, а не общий сбой.
Выводите дедлайн депозита и число подтверждений. И то и другое приходит в расчёте. Большинство обращений «мой своп застрял» — это неподтверждённый депозит, об этом есть материал почему своп висит в ожидании.
Держите ключ только на сервере. Партнёрский ключ с доступом к аккаунту позволяет вывести баланс и прочитать другие ключи. В веб- и мобильном клиенте ему не место.
Тестируйте на фикстурах и следите за эндпоинтом здоровья. Fswap отвечает на зарезервированные тестовые ID заявок каждым из статусов из фикстуры и отдаёт health-check, который безопасно опрашивать. Подключите оба до запуска и держите настроенного запасного провайдера.
Интерфейс, который позволяет приложению программно рассчитать и выполнить обмен криптовалюты на криптовалюту. Приложение вызывает четыре эндпоинта — список монет, курс, создание заявки, статус заявки — а провайдер берёт на себя ликвидность, депозитный адрес и выплату.
Для подключения нужен только аккаунт у провайдера и API-ключ; ни один из офчейн-провайдеров выше не требует от ваших пользователей регистрации для свопа. Ваши собственные обязанности зависят от юрисдикции и от того, что делает ваш продукт, а AML-скрининг есть у каждого провайдера, и по подозрительному переводу он может запросить верификацию.
Фиксированный расчёт закрепляет сумму, которую получит пользователь, в обмен на более короткое окно депозита — у Fswap это 15 минут против 120 на плавающем. Плавающий пересчитывается в момент исполнения, поэтому пользователь может получить больше или меньше оценки.
Типичная партнёрская комиссия — от 0 до 0,5% от объёма свопов. В собственном примере SimpleSwap объём около 80 000 USDT в месяц даёт 320 USDT при ставке 0,4% по умолчанию и 480 USDT при 0,6%. Чем выше ваша маржа, тем больше доход со свопа и тем хуже курс для пользователя.
Нет. Партнёрский API-ключ обычно даёт доступ к аккаунту, а не только к расчёту курса, поэтому он должен оставаться на бэкенде. Проксируйте вызовы через свой сервер и не зашивайте ключ в клиент.
Заявка истечёт или уйдёт в возврат — зависит от провайдера и от того, пришёл ли депозит. Фиксированные заявки часто требуют адрес возврата именно поэтому: собирайте его при создании заявки, а не после того, как что-то пошло не так.
Среди офчейн-решений самое широкое покрытие заявляет SwapSpace — 3 600+ монет в 675 сетях, потому что он агрегирует 40+ других провайдеров. В ончейне 0x дотягивается до 10 млн+ токенов, но только внутри поддерживаемых сетей и без фиксированного курса.
Сначала выбирайте архитектуру — кроссчейн с предсказуемой суммой или одна сеть и ончейн-исполнение. Потом решайте по двум вещам, которые потом тяжело поменять: называет ли провайдер выплату цифрой, которую можно сверить, и говорит ли его документация, что происходит при сбое свопа. Число монет — это маркетинг, таблица ошибок — это инженерия.
Готовы интегрировать? Партнёрский API Fswap описывает оба типа курса, все коды ошибок и зарезервированные тестовые ID заявок — начните со справочника API и запросите ключ.
Елена возглавляет отдел маркетинга в Fswap и пишет о криптовалютных биржах: как работают обменники, как сравнивать курсы и комиссии, а также как обеспечить безопасность средств без ненужной процедуры KYC.
