BURNSWAP PARTNER API · V1

Добавьте криптообмен в свой продукт

Каталог направлений, точная котировка, идемпотентное создание заявки и полный жизненный цикл через один server-to-server API.

Получить доступ Быстрый старт

Изоляция партнёров

Ключ видит только собственные котировки и заявки.

Безопасные повторы

Idempotency-Key защищает от двойного создания.

Честный контракт

Статусы, действия и ошибки возвращаются машинно-читаемо.

Авторизация

Передавайте ключ только с вашего сервера. Никогда не помещайте его во frontend, мобильное приложение или публичный репозиторий.

Authorization: Bearer bs_live_<prefix>_<secret>

Ограничения ключа

В кабинете можно разрешить только нужные операции и ограничить запросы списком IPv4, IPv6 или CIDR. Проверка выполняется до обращения к API обмена.

catalog:readquotes:writeorders:readorders:write

Каталог направлений

GET /api/partner/v1/catalog возвращает монеты, сети, лимиты и доступные направления. Для каждого направления поле minimumUsd равно 100.

Получить котировку

Минимальная сумма — эквивалент 100 USDT. Правило действует и для обратных направлений. Суммы с пробелами и запятой нормализуются. Котировка имеет короткий срок жизни и принадлежит только вашему аккаунту.

curl https://burnswap.online/api/partner/v1/quotes \
  -H "Authorization: Bearer bs_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "directionId": 11006,
    "amount": "1 000,50",
    "side": "from"
  }'

Создать заявку

Передайте адрес кошелька отправителя в senderAddress и адрес выплаты в recipientAddress. Адрес отправителя проверяется AML после обнаружения депозита. Для каждой логической попытки используйте один UUID в Idempotency-Key.

curl https://burnswap.online/api/partner/v1/orders \
  -H "Authorization: Bearer bs_live_..." \
  -H "Idempotency-Key: 70e52cb0-538f-4c4f-ae67-84ae81f47991" \
  -H "Content-Type: application/json" \
  -d '{
    "quoteId": "pq_...",
    "senderAddress": "T...",
    "recipientAddress": "0x...",
    "customerReference": "user-1842",
    "customer": { "name": "Alex", "telegram": "alex" }
  }'

Статус и действия

GET /orders/:idPOST /orders/:id/paidPOST /orders/:id/cancelPOST /orders/:id/requote

Поле actions всегда показывает разрешённые операции в текущем статусе.

Ошибки

Ошибки имеют единый формат. Rate limit возвращает 429, валидация — 422, конфликт идемпотентности — 409. {"error":{"code":"...","message":"..."}}

Спред

Настройка хранится отдельно от шаблона направления. МК возвращает единый базовый курс, партнёрская pricing policy фиксируется в подписанной котировке, а доход начисляется после завершения сделки.