SwapSpace API против Changelly API: полное сравнение для разработчиков

Добавление функции обмена в кошелёк или Web3-продукт влияет гораздо сильнее, чем просто на пользовательский опыт. Выбранный API определяет, как backend запрашивает котировки, обрабатывает истёкшие курсы, отслеживает транзакции и отвечает, когда маршрут недоступен. Он также формирует нагрузку на поддержку, когда обмен задерживается, возвращается или приостанавливается для верификации.

Это сравнение Changelly API vs SwapSpace API рассматривает технические различия, важные для разработчиков, создающих кошельки, биржи и другие Web3-продукты.

Сравнение основано на публичной документации каждого провайдера и текущих B2B-страницах. Доступность активов, лимиты запросов, коммерческие условия и правила комплаенса могут меняться. Подтвердите их через live API и партнёрское соглашение перед запуском.

Что такое Changelly API?

Changelly API v2 — это white-label API криптовалютной биржи, которое предоставляет один сервис котировок и транзакций Changelly.

• Протокол: JSON-RPC 2.0 поверх подписанных POST-запросов.
• Аутентификация: X-Api-Key плюс RSA-SHA256 подпись, с партнёрским аккаунтом и регистрацией публичного ключа.
• Модели курсов: отдельные методы для фиксированного и плавающего курса.
• Покрытие активов: более 1 000 активов на публичной B2B-странице, при этом активный набор возвращается API.
• Связанные продукты: отдельные fiat API, виджет и checkout-сервисы.

API оставляет выбор провайдера за пределами приложения. Для фиксированных и плавающих оценок используются разные методы, а фиксированные котировки имеют короткий срок действия. Эти различия переходят в этап создания транзакции. Главное отличие в реализации — подпись запросов, а не ранжирование маршрутов.

Что такое SwapSpace API?

SwapSpace API v2 — это REST API, которое предоставляет предложения от нескольких обменных партнёров через одну интеграцию.

• Протокол: REST-эндпоинты, специфичные для ресурсов, для валют, партнёров, сумм, создания обмена и статуса.
• Аутентификация: API key в заголовке Authorization, с лимитами запросов, настроенными для каждого affiliate.
• Модели курсов: предложения с фиксированным и плавающим курсом, фильтры по партнёрам и опция Best Amount.
• Покрытие активов: более 3 600 активов в 675 сетях и более 40 источников ликвидности на публичной B2B-странице, при этом требуется live-проверка маршрута.
• Связанные продукты: exchange widget и private transfers, при этом доступ к private transfer подтверждается отдельно.

Каждое предложение содержит данные о партнёре и маршруте. Приложение может показывать несколько предложений, фильтровать их или использовать более простой метод выбора. ID предложений могут быть краткоживущими, а метаданные провайдера могут менять требования к адресу для возврата. Эти данные на уровне маршрута — главное архитектурное отличие от модели одного сервиса у Changelly.

Сравнение Changelly API и SwapSpace API вкратце

Это сравнение API для обмена фокусируется на поверхности интеграции, которую разработчик может проверить в публичной документации.

Архитектура ликвидности: API одного провайдера против агрегатора

Выбор котировки и прозрачность

Changelly может получать ликвидность через собственную инфраструктуру, но партнёрский API рассматривает Changelly как границу сервиса. Ваше приложение запрашивает оценку и получает один результат для запрошенного метода и пары. Это делает модель котировок компактной. Продукту не нужно ранжировать провайдеров или объяснять, почему два провайдера вернули разные лимиты.

SwapSpace напрямую предоставляет агрегацию ликвидности. Эндпоинт amounts может возвращать предложения от всех доступных партнёров или от выбранного списка партнёров. Ответ может включать фиксированные и плавающие маршруты для одной и той же пары. Это даёт кошельку или бирже больше контроля над сортировкой. Продукт может ранжировать по сумме на выходе, предполагаемой длительности, политике провайдера или собственным бизнес-правилам.

Если аудитории важен выбор провайдера или прозрачность маршрута, интеграция с SwapSpace может показывать несколько предложений и применять правила выбора, специфичные для продукта. Более простой продукт может отображать один выбранный маршрут. Идентичность провайдера, тип курса, лимиты и ожидаемая длительность остаются доступными, когда интерфейсу это нужно.

Доступность и fallback-поведение

В Changelly, если валюта отключена или оценка не проходит, API не предоставляет другого именованного провайдера через тот же контракт. Приложению нужна отдельная интеграция для выбора другого маршрута.

До создания обмена SwapSpace может вернуть предложения от других доступных партнёров. После создания обмена выбранный провайдер остаётся привязанным к этой транзакции. Поэтому Changelly концентрирует зависимость от маршрута в одном сервисе. SwapSpace предоставляет fallback до создания транзакции в рамках того же API.

Границы комплаенса и поддержки

Оба API могут отображать статусы, связанные с проверкой, но ответственность распределяется по-разному. 

Changelly документирует статус hold и направляет партнёра к своим специалистам по безопасности. 

SwapSpace предоставляет статус Verifying, при этом выбранный провайдер обмена может контролировать проверки. Поэтому идентичность провайдера и инструкции поддержки в агрегированной модели имеют большее значение.

Опыт разработчика

Доступ и аутентификация

Аутентификация — это наиболее очевидное различие реализации, и оно формирует первый этап интеграции крипто-свапа.

Changelly:

• Партнёрский аккаунт и регистрация публичного ключа.
• RSA-SHA256 подпись каждого тела JSON-RPC-запроса.
• Интеграция на стороне сервера для защиты приватного ключа.

SwapSpace:

• Affiliate-аккаунт и API key в заголовке Authorization.
• Лимиты запросов настраиваются для affiliate в процессе onboarding.
• Хранение API key на стороне сервера.

Changelly требует больше настройки и кода для подписи. SwapSpace использует более лёгкую модель учётных данных, при этом производственная пропускная способность зависит от конфигурации affiliate.

Документация и обработка ошибок

Changelly documentation:

• Схемы запросов на уровне методов и примеры ошибок.
• Примеры аутентификации на нескольких языках программирования.
• Заметки по миграции и подробный справочник по статусам.

SwapSpace documentation:

• Короткий REST-поток от валют и партнёров до статуса обмена.
• Правила валидации для сумм, rate ID, extra ID, IP пользователя и условных адресов возврата.

Changelly предоставляет более глубокую документацию по аутентификации и ошибкам. SwapSpace документирует более короткий поток с большим объёмом данных для выбора маршрута.

JSON-RPC-ответы Changelly содержат коды и сообщения, специфичные для метода. REST-поток SwapSpace документирует поля валидации, такие как network IDs, rate IDs, extra IDs, user IPs и условные адреса возврата. Переводите эти сбои upstream в стабильные внутренние категории до того, как они попадут в интерфейс. Сохраняйте исходный код ошибки и exchange ID в логах, чтобы поддержка могла отследить маршрут, не показывая пользователю сырые сообщения провайдера.

Производительность и масштабируемость

Changelly публикует стандартный лимит 10 запросов в секунду для релевантных методов. Условия для более высокой пропускной способности в публичном справочнике не указаны.

SwapSpace не публикует стандартный числовой потолок, потому что лимиты запросов настраиваются для каждого affiliate. Поэтому планирование мощности зависит от согласованной конфигурации партнёра, а не от публичного значения по умолчанию.

Оба публичных потока предоставляют status-эндпоинты на основе polling. В публичных материалах, рассмотренных для этого сравнения, не определён общий webhook-контракт, поэтому доступность webhooks остаётся частью onboarding партнёра.

Поведение polling также влияет на планирование мощности. Кэшируйте валюты и метаданные партнёров на заданный интервал, не обновляйте котировки, с которыми пользователь не может сейчас взаимодействовать, и снижайте частоту проверок статуса после того, как транзакция покинет времязависимые стадии. Нагрузочные тесты должны покрывать всплески котировок, истёкшие ID, отключённые пары и сбои на стороне провайдера. Измеряйте весь путь отказа, а не только одну задержку: продукт должен оставаться отзывчивым, когда маршруты исчезают или ответы upstream замедляются.

Поддержка и эскалация

Для API криптобиржи для разработчиков поддержка особенно важна, когда транзакция застревает или переходит в верификацию. 

Changelly направляет технические вопросы на email партнёра или к выделенному account manager. В документации описана модель эскалации, при которой партнёр обеспечивает первую линию поддержки и передаёт нерешённые кейсы во вторую линию Changelly через отдельный Slack-канал.

SwapSpace предоставляет email партнёра и B2B-форму контакта, а также поддержку пользователей 24/7. Пути эскалации и обязательства по ответам зависят от партнёрского соглашения.

Перед интеграцией любого из API подтвердите часы поддержки, уведомления об инцидентах, доступ к status page и данные, необходимые для расследования зависшего обмена.

Коммерческие условия и модель дохода

Ни один API криптобиржи не взимает публичную плату за интеграцию. Оба поддерживают монетизацию партнёров через дополнительную комиссию или модель revenue sharing.

Changelly позволяет API-партнёрам добавлять комиссию к обменному курсу. В его business FAQ указано, что типичный диапазон составляет 0,1%–5%, а текущая API-документация говорит, что комиссия настраивается через команду партнёров.

Эндпоинт создания обмена у SwapSpace включает необязательный параметр affiliateFee. Размер комиссии affiliate зависит от выбранного поставщика ликвидности и партнёрского соглашения.

Рабочий процесс интеграции

Шаги ниже сравнивают оба рабочих процесса API для крипто-свапа и объём инженерной работы, который требуется для каждой интеграции крипто-API.

Типичная интеграция Changelly

1. 1. Создайте партнёрский аккаунт Changelly и сгенерируйте публичный и приватный ключи.
2. 2. Зарегистрируйте публичный ключ в Changelly и храните приватный ключ в серверном хранилище секретов.
3. 3. Реализуйте сериализацию запросов JSON-RPC 2.0 и подпись RSA-SHA256.
4. 4. Получите данные по включённым валютам и сопоставьте тикеры, сети, поля memo и правила валидации.
5. 5. Запросите плавающую или фиксированную оценку, затем проверьте возвращённую сумму и лимиты.
6. 6. Создайте правильный тип транзакции до истечения срока котировки или окна оплаты.
7. 7. Сохраните ID транзакции и опрашивайте getStatus или getTransactions с backoff.
8. 8. Сопоставьте каждый конечный, возвратный, истёкший и проверочный статус с сообщением для пользователя и процедурой поддержки.

Changelly накладывает два протокольных ограничения: подпись должна совпадать с точно сериализованным телом, а оценки v2 должны оставаться связаны с методами транзакций v2.

💡 Важно! Фиксированные и плавающие потоки используют разные методы, поэтому их следует тестировать отдельно.

Типичная интеграция SwapSpace

1. 1. Создайте affiliate-аккаунт, получите API key и подтвердите допустимое число запросов для целевой среды.
2. 2. Получите список валют и сохраните отдельные идентификаторы актива и сети.
3. 3. Получите список партнёров и сохраните требования к маршруту, такие как правила адреса возврата.
4. 4. Запросите доступные суммы для пары, объёма, сетей и требуемых типов курса.
5. 5. Отранжируйте возвращённые предложения или запросите эндпоинт Best Amount в соответствии с политикой выбора продукта.
6. 6. Проверьте минимальные и максимальные значения, затем создайте обмен до истечения любого возвращённого rate ID.
7. 7. Сохраните SwapSpace exchange ID, выбранного провайдера и данные транзакции, видимые пользователю.
8. 8. Опросите status endpoint с backoff и обработайте статусы finished, failed, refunded, verifying и expired.

SwapSpace привязывает выбранное предложение к созданному обмену. Новая котировка или провайдер создают новый запрос на обмен.

💡 Важно! Если котировка истекает до создания обмена, пользователь должен подтвердить обновлённое предложение.

Какой API подходит для разных продуктов?

Команды, оценивающие crypto API для кошелька, должны сначала решить, нужен ли пользователям один обменный контур или видимый выбор провайдера.

Таблица рассматривает соответствие продукта как исходную гипотезу. Коммерческие условия, регионы, спрос на активы, трафик и внутренняя инженерная мощность могут изменить результат.

Когда API Changelly имеет смысл

API Changelly подходит продуктам, которые предпочитают один сервис обмена и компактный ответ котировки.

Подробные примеры подписи и документация по ошибкам на уровне методов помогают командам, которым важен чётко определённый слой аутентификации. Он также может подойти компаниям, которые планируют оценивать отдельные fiat- или checkout-продукты Changelly в рамках тех же B2B-отношений.

Компромисс — это видимость маршрута. API возвращает оценку Changelly, а не список именованных поставщиков обмена. Кроме того, интеграция требует регистрации публичного ключа во время onboarding.

Когда API SwapSpace имеет смысл

SwapSpace лучше подходит, когда сравнение провайдеров — часть продукта. Он предоставляет несколько предложений, варианты с фиксированным и плавающим курсом, фильтры по партнёрам и метаданные маршрутов через один REST API. На его B2B-странице указано более 40 источников ликвидности и 3 600+ активов в 675 сетях. Ценность — более широкое покрытие long-tail и кроссчейн-маршрутов через один контракт.

Если продукт получает несколько предложений и сам выбирает маршрут, интеграции могут понадобиться явные критерии выбора, обработка истечения котировки и данные обмена, зависящие от провайдера. Продукты, использующие Best Amount или более простой поток, могут вынести больше логики маршрутизации за пределы пользовательского интерфейса.

Итоговый вердикт

Универсального лучшего API для обмена не существует. 

Changelly использует JSON-RPC 2.0, подпись запросов RSA-SHA256 и модель котировок от одного провайдера. Он предлагает подробную документацию по методам и ошибкам, но не показывает конкурирующие маршруты провайдеров через тот же API. 

SwapSpace использует REST с аутентификацией по API key и возвращает предложения от нескольких обменных партнёров, давая продуктам больше контроля над выбором маршрута и более широкое покрытие активов.

Выбирайте Changelly для продуктов, которым важны отношения с одним провайдером, компактный поток котировок и подробная документация на уровне методов. Выбирайте SwapSpace для кошельков, бирж и Web3-продуктов, которым нужны сравнение провайдеров, агрегация ликвидности или более широкое покрытие long-tail маршрутов.

Начните интеграцию SwapSpace API

Отправьте форму на B2B-странице SwapSpace, чтобы обсудить доступ, лимиты запросов и требования к интеграции с командами продукта и business development. 

Часто задаваемые вопросы

В чём разница между SwapSpace API и Changelly API?

Changelly предоставляет white-label сервис обмена через JSON-RPC 2.0. Приложение получает оценки Changelly и создаёт транзакции Changelly. SwapSpace предоставляет предложения от нескольких партнёров через REST API, позволяя приложению сравнивать или фильтровать маршруты до создания обмена.

Агрегирует ли SwapSpace API несколько поставщиков ликвидности?

Да. Эндпоинт amounts может возвращать предложения от всех доступных партнёров или фильтровать по выбранным партнёрам. На публичной B2B-странице указано более 40 источников ликвидности. Доступность зависит от актива, сети, суммы, типа курса и текущих условий провайдера.

Какой API лучше для криптокошельков?

Это зависит от продуктового дизайна кошелька. Changelly подходит кошельку, который хочет одну котировку и отношения с одним провайдером. SwapSpace подходит кошельку, которому нужны сравнение провайдеров, более широкое покрытие маршрутов или собственная логика ранжирования предложений. Подходящесть также зависит от покрытия распространённых и long-tail пар у кошелька.

Можно ли интегрировать криптообмен без создания собственной биржи?

Да. Оба API позволяют продукту передать исполнение обмена внешнему сервису, сохраняя контроль над интерфейсом и оркестрацией backend. Валидация адресов, обработка статусов и поддержка остаются частью интеграции продукта.

Поддерживает ли SwapSpace API фиксированный и плавающий курс?

Да. Эндпоинт amounts принимает фильтры fixed и float и может возвращать оба типа в одном запросе. Поддержка зависит от партнёра и пары. Некоторые предложения содержат краткоживущий rate ID, который нужно использовать при создании обмена.

Сколько времени обычно занимает интеграция API?

Публичные маркетинговые оценки не являются надёжным планом проекта. Базовый proof of concept может занять дни, а сроки production зависят от утверждения ключей, security review, работы над интерфейсом, статусов комплаенса, аналитики и инструментов поддержки.

_______

Это сравнение носит информационный характер. Функции API, покрытие активов, лимиты, комиссии и требования комплаенса могут меняться. Перед внедрением production API для обмена криптовалюты ознакомьтесь с текущей документацией и договорными условиями.