POST /apiv2/time/stop

Dừng Host Mode cho một địa chỉ TRON: đóng các đơn hàng đang mở và hủy kích hoạt địa chỉ đó. Địa chỉ vẫn được đăng ký trong Host Mode và có thể được kích hoạt lại sau.

URL Điểm cuối

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

Xác thực

Cung cấp API key của bạn trong phần thân yêu cầu (api_key) hoặc tiêu đề X-API-KEY. IP yêu cầu phải nằm trong danh sách trắng (whitelist) được định cấu hình cho API key của bạn.

Thân Yêu cầu

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

Các Tham số

Tham số	Loại	Bắt buộc	Mô tả
api_key	chuỗi	Có	API key (hoặc tiêu đề X-API-KEY).
address	chuỗi	Có	Địa chỉ TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. Phải ở trong Host Mode và hiện đang hoạt động.

Hành vi

Dừng một địa chỉ sẽ:

• Đóng tất cả các đơn hàng đang mở của địa chỉ đó.
• Đặt Host Mode thành không hoạt động (status = 0, cycle_set = 0).
• Đặt lại bộ đếm chu kỳ đã sử dụng cho địa chỉ.
• Không có Energy mới nào được ủy quyền cho đến khi bạn kích hoạt lại địa chỉ đó (bằng /apiv2/time/order hoặc /apiv2/time/infinitystart).

Bản thân địa chỉ vẫn duy trì trong Host Mode; để xóa hoàn toàn địa chỉ, sử dụng /apiv2/time/delete.

Yêu cầu Ví dụ

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));

Phản hồi

Thành công (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"
    }
}

Các Trường Phản hồi

Trường	Loại	Mô tả
code	số nguyên	0 = thành công, số âm = lỗi
msg	chuỗi	Thông báo con người có thể đọc được
data.address	chuỗi	Địa chỉ đã bị dừng
data.orders_closed	số nguyên	Số lượng đơn hàng đang mở đã được đóng
data.status	chuỗi	"inactive"
data.timestamp	chuỗi	Dấu thời gian ISO

Phản hồi Lỗi

code	msg	Nguyên nhân
-1	API key required in X-API-KEY header or request body	Không có API key được cung cấp
-1	Invalid API key or IP not in whitelist	Xác thực thất bại
-1	Invalid TRC-20 address format	Định dạng địa chỉ không hợp lệ
-1	Database error stopping host mode	Lỗi máy chủ tạm thời — hãy thử lại
-1	Internal server error	Lỗi không mong muốn — hãy thử lại hoặc liên hệ hỗ trợ
-4	Address not found	Địa chỉ không ở trong Host Mode thuộc tài khoản của bạn
-7	Host mode is already inactive	Địa chỉ đã dừng trước đó rồi

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

Mã trạng thái HTTP

Các lỗi tại điểm cuối được trả về với HTTP 200 và một code âm — kiểm tra code, không kiểm tra trạng thái HTTP. Nội dung lỗi luôn bao gồm "data": null.

Một số lỗi được trả về trước khi yêu cầu đến được điểm cuối. Chúng sử dụng trạng thái khác 200 và định dạng nội dung khác:

HTTP	Nội dung	Nguyên nhân
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API key bị khóa — liên hệ hỗ trợ
422	{"detail": [ … ]}	Thân yêu cầu không vượt qua xác thực: thiếu trường bắt buộc hoặc sai kiểu dữ liệu. Lưu ý không có trường code trong phản hồi này

Việc dừng một địa chỉ luôn khả dụng bất kể số dư tài khoản của bạn là bao nhiêu.

Dừng so với Xóa

	Dừng	Xóa
Đăng ký Host Mode	Giữ lại	Đã xóa
Các đơn hàng đang mở	Đã đóng	Phải không có
Tái kích hoạt	order / infinitystart	Phải add lại từ đầu
Callback URL	Giữ lại	Đã xóa

Các Điểm cuối Liên quan

• POST /apiv2/time/infinitystart — kích hoạt lại địa chỉ (vô hạn)
• POST /apiv2/time/order — kích hoạt lại với số chu kỳ cố định
• POST /apiv2/time/status — kiểm tra trạng thái
• POST /apiv2/time/delete — xóa hoàn toàn địa chỉ

Ghi chú

• Việc dừng vẫn giữ địa chỉ trong Host Mode; địa chỉ có thể được kích hoạt lại bất kỳ lúc nào.
• Các chu kỳ đã đặt còn lại không được bảo lưu — bộ đếm chu kỳ đã sử dụng sẽ bị đặt lại khi dừng.