POST /apiv2/time/delete

Полностью удаляет TRON-адрес из Host Mode. По умолчанию адрес уже должен быть неактивен (остановлен) и не иметь открытых заказов; передайте "stop": true, чтобы остановить и удалить его за один вызов.

URL эндпоинта

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

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

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

Тело запроса

json

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

Параметры

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

Поведение

Без stop адрес должен быть неактивным — сначала остановите его с помощью /apiv2/time/stop, если он активен, — и не иметь открытых заказов. В противном случае запрос отклоняется с указанными ниже ошибками, и ничего не изменяется.
При успешном выполнении адрес удаляется из Host Mode, а его зарегистрированный callback URL (если был) удаляется.
Этот же адрес можно снова добавить позже с помощью /apiv2/time/add.

stop

При значении "stop": true активный адрес останавливается и удаляется за один вызов — тот же результат, что и при вызове /apiv2/time/stop, а затем /apiv2/time/delete, и точно такие же действия: закрываются все открытые заказы по адресу, отключается Host Mode, сбрасывается счетчик циклов, а факт остановки записывается в историю действий. Только после этого адрес удаляется.

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

Флаг имеет значение только тогда, когда есть что останавливать. Для адреса, который уже неактивен и не имеет открытых заказов, он ничего не меняет — вызов работает точно так же, как и без него, а в ответ возвращается стандартный ответ на удаление.

Биллинг не затрагивается: остановка ничего не возмещает, а удаление не списывает средств. Уже делегированные циклы остаются оплаченными, а Energy, делегированная на адрес в данный момент, отзывается по обычному расписанию. См. раздел Host Mode → Циклы и тарификация.

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

cURL

bash

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

Остановка и удаление за один вызов:

bash

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

Python

python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/delete",
    json={
        "api_key": "YOUR_API_KEY_HERE",
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        # "stop": True,  # optional: stop Host Mode on the address instead of failing
    },
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Deleted:", result["data"]["address"])
else:
    print("Error:", result["msg"])

Node.js

javascript

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/delete', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    // stop: true, // optional: stop Host Mode on the address instead of failing
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Deleted:', result.data.address);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Ответ

Успешно (200 OK)

json

{
    "code": 0,
    "msg": "Address deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Успешно, если адрес был предварительно остановлен (`"stop": true`)

json

{
    "code": 0,
    "msg": "Address stopped and deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "stopped": true,
        "orders_closed": 1,
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Поля ответа

Поле	Тип	Описание
code	integer	`0` = успех, отрицательное значение = ошибка
msg	string	Читаемое сообщение. `Address stopped and deleted from Host Mode successfully`, если адрес был остановлен в рамках этого вызова
data.address	string	Удаленный адрес
data.stopped	boolean	Присутствует только тогда, когда Host Mode был остановлен в рамках этого вызова. Отсутствует при обычном удалении
data.orders_closed	integer	Количество открытых заказов, закрытых этой остановкой. Присутствует только вместе с `stopped`
data.timestamp	string	Временная метка ISO

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

Все ошибки возвращают code = -1:

msg	Причина
`API key required in X-API-KEY header or request body`	API-ключ не предоставлен
`Invalid API key or IP not in whitelist`	Ошибка аутентификации
`Invalid TRC-20 address format`	Неверный формат адреса
`Address not found or does not belong to you`	Адрес не зарегистрирован в вашем аккаунте
`Cannot delete an active address. Stop Host mode first`	Адрес активен и параметр `stop` не был передан — сначала вызовите `/apiv2/time/stop` или повторите с `"stop": true`
`Cannot delete address with active orders`	У адреса все еще есть открытые заказы и параметр `stop` не был передан — повторите с `"stop": true`
`Failed to delete address`	Не удалось удалить адрес — повторите попытку
`Database error deleting address`	Временная ошибка на стороне сервера — повторите попытку
`Internal server error`	Непредвиденная ошибка — повторите попытку или обратитесь в поддержку

json

{ "code": -1, "msg": "Cannot delete an active address. Stop Host mode first", "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`

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

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

POST /apiv2/time/stop — остановить адрес перед удалением
POST /apiv2/time/status — проверить статус и открытые заказы
POST /apiv2/time/add — снова добавить адрес позже

Примечания

При удалении также удаляется callback URL адреса.
Удаление разрешено только для неактивных адресов без открытых заказов — сначала остановите его с помощью /apiv2/time/stop или передайте "stop": true, чтобы он был остановлен автоматически.
Этот же адрес можно повторно добавить в любое время.

POST /apiv2/time/delete ​

URL эндпоинта ​

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

Тело запроса ​

Параметры ​

Поведение ​

stop ​

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

cURL ​

Python ​

Node.js ​

Ответ ​

Успешно (200 OK) ​

Успешно, если адрес был предварительно остановлен ("stop": true) ​

Поля ответа ​

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

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

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

Примечания ​

POST /apiv2/time/delete

URL эндпоинта

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

Тело запроса

Параметры

Поведение

stop

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

cURL

Python

Node.js

Ответ

Успешно (200 OK)

Успешно, если адрес был предварительно остановлен (`"stop": true`)

Поля ответа

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

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

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

Примечания