POST /apiv2/time/stop

Hentikan Host Mode untuk alamat TRON: tutup pesanan yang terbuka dan nonaktifkan. Alamat tetap terdaftar di Host Mode dan dapat diaktifkan kembali nanti.

URL Endpoint

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

Autentikasi

Berikan API key Anda di body permintaan (api_key) atau header X-API-KEY. IP permintaan harus ada di dalam whitelist yang dikonfigurasi untuk API key Anda.

Body Permintaan

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

Parameter

Parameter	Tipe	Diperlukan	Deskripsi
api_key	string	Ya	API key (atau header X-API-KEY).
address	string	Ya	Alamat TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. Harus dalam Host Mode dan saat ini aktif.

Perilaku

Menghentikan alamat:

• Menutup semua pesanannya yang terbuka.
• Menyetel Host Mode ke tidak aktif (status = 0, cycle_set = 0).
• Mereset penghitung siklus yang digunakan untuk alamat tersebut.
• Tidak ada Energy baru yang didelegasikan sampai Anda mengaktifkannya kembali (dengan /apiv2/time/order atau /apiv2/time/infinitystart).

Alamat itu sendiri tetap berada di Host Mode; untuk menghapusnya sepenuhnya gunakan /apiv2/time/delete.

Contoh Permintaan

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

Respons

Berhasil (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"
    }
}

Bidang Respons

Bidang	Tipe	Deskripsi
code	integer	0 = berhasil, negatif = kesalahan
msg	string	Pesan yang dapat dibaca manusia
data.address	string	Alamat yang dihentikan
data.orders_closed	integer	Jumlah pesanan terbuka yang ditutup
data.status	string	"inactive"
data.timestamp	string	Timestamp ISO

Respons Kesalahan

code	msg	Penyebab
-1	API key required in X-API-KEY header or request body	Tidak ada API key yang diberikan
-1	Invalid API key or IP not in whitelist	Autentikasi gagal
-1	Invalid TRC-20 address format	Format alamat salah
-1	Database error stopping host mode	Kesalahan sementara pada sisi server — coba lagi
-1	Internal server error	Kesalahan tak terduga — coba lagi atau hubungi dukungan
-4	Address not found	Alamat tidak ditemukan di Host Mode di bawah akun Anda
-7	Host mode is already inactive	Alamat sudah dihentikan

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

Kode status HTTP

Kesalahan endpoint dikembalikan dengan HTTP 200 dan code bernilai negatif — periksa code, bukan status HTTP. Body kesalahan selalu menyertakan "data": null.

Beberapa kesalahan dikembalikan sebelum permintaan mencapai endpoint. Kesalahan tersebut menggunakan status non-200 dan bentuk body yang berbeda:

HTTP	Body	Penyebab
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API key diblokir — hubungi dukungan
422	{"detail": [ … ]}	Body permintaan gagal divalidasi: bidang yang diperlukan tidak ada atau memiliki tipe yang salah. Perhatikan bahwa tidak ada bidang code dalam respons ini

Menghentikan alamat selalu tersedia terlepas dari saldo akun Anda.

Hentikan vs Hapus

	Hentikan	Hapus
Pendaftaran Host Mode	Dipertahankan	Dihapus
Pesanan terbuka	Ditutup	Harus tidak ada
Pengaktifan kembali	order / infinitystart	Harus add lagi
URL Callback	Dipertahankan	Dihapus

Endpoint Terkait

• POST /apiv2/time/infinitystart — aktifkan kembali alamat (tak terbatas)
• POST /apiv2/time/order — aktifkan kembali dengan jumlah siklus tetap
• POST /apiv2/time/status — periksa status
• POST /apiv2/time/delete — hapus alamat sepenuhnya

Catatan

• Menghentikan alamat tetap mempertahankan alamat tersebut di Host Mode; alamat dapat diaktifkan kembali kapan saja.
• Sisa siklus yang dipesan tidak dialihkan — penghitung siklus yang digunakan direset saat dihentikan.