API v1 · REST, JSON

API для партнёров

Покупайте энергию TRON для своих пользователей автоматически: проверка цены, заказ на адрес, отслеживание статуса. Цена фиксируется при заказе и списывается с предоплаченного баланса.

Базовый URL https://cryptosales.io

Авторизация

Каждый запрос передаёт API-ключ партнёра в заголовке X-API-Key (или Authorization: Bearer …). Ключ выпускается в личном кабинете или в Telegram-боте; храните его на сервере и не публикуйте в клиентском коде.

curl https://cryptosales.io/api/v1/balance \
  -H "X-API-Key: cs_live_…"

Суммы и баланс

Все суммы — строки в TRX с 6 знаками после запятой, например "3.640000". Заказы оплачиваются с предоплаченного баланса: при создании заказа его цена удерживается, а если заказ не выполнен — автоматически возвращается.

Баланс

GET/api/v1/balance

{ "balance": "96.360000", "name": "Your company" }

Цена

Текущая цена для вашего аккаунта. Удобно показывать пользователю перед заказом; итоговая цена фиксируется при создании заказа.

GET/api/v1/price?energy=65000&duration=1h

Параметр	Тип	Описание
energy	integer	Объём энергии. 65 000 — перевод USDT, 131 000 — перевод на адрес без USDT.
duration	string	`15m`, `1h`, `3h`, `6h`, `1d`, `3d`, `7d`, `14d`, `30d`. По умолчанию `1h`.

{
  "energy": 65000, "duration": "1h", "available": true,
  "price": "3.640000", "priceUsd": 1.2,
  "burn": "6.500000", "savingsPct": 44
}

GET /api/v1/prices?energy=65000 вернёт цены сразу на все доступные сроки: {"prices": [ … ]}.

Создать заказ

POST/api/v1/orders

Поле	Тип	Описание
receiveAddress	string	TRON-адрес, на который делегируется энергия. Обязательно.
energy	integer	Объём энергии. Обязательно.
duration	string	Срок аренды, по умолчанию `1h`.
clientRef	string	Ваш уникальный ID заказа (до 128 символов). Рекомендуется.

Идемпотентность. Повтор запроса с тем же clientRef вернёт уже созданный заказ и не спишет деньги повторно. Всегда передавайте clientRef и повторяйте запрос при сетевых ошибках.

curl -X POST https://cryptosales.io/api/v1/orders \
  -H "X-API-Key: cs_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "receiveAddress": "TXk8…",
    "energy": 65000,
    "duration": "1h",
    "clientRef": "withdraw-1842"
  }'

// 201 Created
{
  "id": "cs_8f2a91c04be7d3a1e2f0",
  "clientRef": "withdraw-1842",
  "receiveAddress": "TXk8…",
  "energy": 65000,
  "duration": "1h",
  "price": "3.640000",
  "status": "success",
  "refunded": false,
  "createdAt": "2026-10-26T18:30:12Z"
}

Обычно энергия поступает за несколько секунд и статус сразу success. Если статус pending — проверяйте заказ методом ниже раз в 10–30 секунд.

Статус заказа

GET/api/v1/orders/{id}

В качестве {id} можно передать наш ID заказа или ваш clientRef. Ответ — объект заказа, как при создании.

Список заказов

GET/api/v1/orders?limit=20&offset=0

{ "orders": [ … ], "total": 128 }

Статусы заказа

Статус		Значение
processing		Заказ принят и исполняется.
pending		Ожидаем подтверждения делегирования в сети.
success		Энергия делегирована на адрес.
failed		Заказ не выполнен, цена возвращена на баланс (`refunded: true`).
refunded		Средства возвращены вручную после проверки.

Ошибки и лимиты

Ошибки возвращаются с HTTP-кодом и телом {"error": "описание"}.

Код		Причина
400		Некорректные параметры: адрес, объём, срок.
401		Неверный API-ключ.
402		Недостаточно средств на балансе.
403		Доступ партнёра приостановлен.
404		Заказ не найден.
429		Превышен лимит — 300 запросов в минуту.
503		Нет доступных предложений или заказ не выполнен (средства возвращены).

Нужен ключ или персональные условия? Напишите нам.