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
}

Параметри

Parameter	Type	Required	Description
api_key	string	Yes	API-ключ (або заголовок `X-API-KEY`).
address	string	Yes	Адреса TRON (TRC-20), `^T[1-9A-HJ-NP-Za-km-z]{33}$`. Повинна належати вашому акаунту.
stop	boolean	No	`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"
    }
}

Поля відповіді

Field	Type	Description
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	Cause
`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	Body	Cause
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

Пов'язані ендпоінти

Примітки