Обзор Orders API

POST Публичный API для интеграции с некастодиальными кошельками.

Базовый URL

https://api.tronzap.com

Все эндпоинты принимают и возвращают JSON.

Обязательные заголовки

Content-Type: application/json
Accept: application/json

Заголовки аутентификации не требуются. Orders API полностью публичен.

Ограничения частоты запросов

• 1 запрос в секунду с одного IP для всех эндпоинтов /v1/orders*.
• При превышении лимита возвращается HTTP 429 Too Many Requests.
• Нельзя создать второй активный заказ для той же пары address_from + address_to, пока предыдущий заказ находится в статусе new.

Оболочка ответа

Каждый успешный ответ оборачивает данные в единообразную оболочку:

{
  "code": 0,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {}
}

Поле	Тип	Описание
code	integer	0 при успехе, ненулевое значение при ошибке. Смотрите Коды ошибок.
request_id	string	Уникальный UUID запроса. Указывайте при сообщении о проблемах.
result	object	Данные, специфичные для эндпоинта.

Эндпоинты

Метод	Эндпоинт	Описание
POST	/v1/orders/calculate	Рассчитать цену без создания заказа
POST	/v1/orders	Создать заказ и получить депозитный адрес
POST	/v1/orders/check	Проверить статус заказа
POST	/v1/orders/cancel	Отменить заказ в статусе new

Поле referral_code

Зарабатывайте комиссии — всегда передавайте referral_code

Включайте referral_code в тело каждого запроса POST /v1/orders. Заказы без корректного реферального кода не привязываются ни к одному партнёрскому аккаунту и не приносят комиссию.

Смотрите Подключение партнёра для получения вашего кода.