POST /apiv2/time/stop

Остановить Host Mode для адреса TRON: закрыть его открытые заказы и деактивировать его. Адрес остаётся зарегистрированным в Host Mode и может быть повторно активирован позже.

URL эндпоинта

POST https://netts.io/apiv2/time/stop

Аутентификация

Укажите ваш API-ключ в теле запроса (api_key) или в заголовке X-API-KEY. IP-адрес запроса должен находиться в белом списке, настроенном для вашего API-ключа.

Тело запроса

{
    "api_key": "your_api_key",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	API-ключ (или заголовок X-API-KEY).
address	string	Да	TRON (TRC-20) адрес, ^T[1-9A-HJ-NP-Za-km-z]{33}$. Должен находиться в Host Mode и быть активным в данный момент.

Поведение

Остановка адреса:

• Закрывает все его открытые заказы.
• Переводит Host Mode в состояние неактивен (status = 0, cycle_set = 0).
• Сбрасывает счётчик использованных циклов для адреса.
• Новая Energy не делегируется до тех пор, пока вы не активируете его снова (с помощью /apiv2/time/order или /apiv2/time/infinitystart).

Сам адрес остаётся в Host Mode; чтобы удалить его полностью, используйте /apiv2/time/delete.

Примеры запросов

cURL

curl -X POST https://netts.io/apiv2/time/stop \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
  }'

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/stop",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Stopped. Orders closed:", result["data"]["orders_closed"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/stop', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Stopped. Orders closed:', result.data.orders_closed);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Ответ

Успешно (200 OK)

{
    "code": 0,
    "msg": "Host mode stopped successfully, closed 1 order(s)",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "orders_closed": 1,
        "status": "inactive",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Поля ответа

Поле	Тип	Описание
code	integer	0 = успех, отрицательное значение = ошибка
msg	string	Читаемое сообщение
data.address	string	Адрес, который был остановлен
data.orders_closed	integer	Количество закрытых открытых заказов
data.status	string	"inactive"
data.timestamp	string	Временная метка в формате ISO

Ответы с ошибками

code	msg	Причина
-1	API key required in X-API-KEY header or request body	API-ключ не предоставлен
-1	Invalid API key or IP not in whitelist	Ошибка аутентификации
-1	Invalid TRC-20 address format	Неверный формат адреса
-1	Database error stopping host mode	Временная ошибка на стороне сервера — повторите попытку
-1	Internal server error	Непредвиденная ошибка — повторите попытку или свяжитесь с поддержкой
-4	Address not found	Адрес не найден в Host Mode под вашим аккаунтом
-7	Host mode is already inactive	Адрес уже остановлен

{ "code": -7, "msg": "Host mode is already inactive", "data": null }

Коды состояния HTTP

Ошибки эндпоинта возвращаются с кодом HTTP 200 и отрицательным значением code — проверяйте code, а не HTTP-статус. Тела ошибок всегда содержат "data": null.

Некоторые ошибки возвращаются до того, как запрос достигнет эндпоинта. Они используют статус, отличный от 200, и другую структуру тела:

HTTP	Тело	Причина
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API-ключ заблокирован — свяжитесь с поддержкой
422	{"detail": [ … ]}	Тело запроса не прошло валидацию: обязательное поле отсутствует или имеет неверный тип. Обратите внимание, что в этом ответе отсутствует поле code

Остановка адреса всегда доступна независимо от баланса вашего аккаунта.

Остановка (Stop) или удаление (Delete)

	Остановка (Stop)	Удаление (Delete)
Регистрация в Host Mode	Сохраняется	Удаляется
Открытые заказы	Закрываются	Не должно быть
Повторная активация	order / infinitystart	Требуется снова выполнить add
Callback URL	Сохраняется	Удаляется

Связанные эндпоинты

• POST /apiv2/time/infinitystart — повторно активировать адрес (infinity)
• POST /apiv2/time/order — повторно активировать с фиксированным количеством циклов
• POST /apiv2/time/status — проверить статус
• POST /apiv2/time/delete — полностью удалить адрес

Примечания

• Остановка сохраняет адрес в Host Mode; его можно повторно активировать в любое время.
• Оставшиеся заказанные циклы не переносятся — счётчик использованных циклов сбрасывается при остановке.