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 у стан inactive (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; її можна повторно активувати в будь-який час.
• Залишок замовлених циклів не переноситься — лічильник використаних циклів скидається під час зупинки.