POST /apiv2/time/infinitystart

Mengaktifkan mode infinity (tanpa batas) untuk alamat yang sudah berada dalam Host Mode — energy terus didelegasikan siklus demi siklus sampai Anda menghentikannya.

URL Endpoint

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

Autentikasi

Sediakan API key Anda di dalam body permintaan (api_key) atau header X-API-KEY. IP permintaan harus terdaftar dalam whitelist yang dikonfigurasikan untuk API key Anda.

Isi 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}$. Alamat harus sudah berada dalam Host Mode (tambahkan terlebih dahulu).

Perilaku

• Alamat harus sudah terdaftar di Host Mode dan berstatus tidak aktif (dihentikan).
• Saldo Anda harus mencukupi setidaknya satu siklus pada harga saat ini (diperiksa sebelum aktivasi).
• Endpoint mengaktifkan alamat, membuat pesanan infinity yang terbuka, dan Host Mode terus mendelegasikan energy siklus demi siklus sampai Anda memanggil /apiv2/time/stop.

Siklus ditagih saat didelegasikan (satu siklus per delegasi). Delegasi pertama dari suatu aktivasi berbiaya 4 TRX; setiap delegasi berikutnya berbiaya 2 atau 4 TRX tergantung pada energy yang benar-benar dikonsumsi oleh transfer Anda sebelumnya (≤ 65.000 → 2 TRX, lebih banyak → 4 TRX). Batas minimum harian 8 TRX (berlaku mulai 2026-08-29) dan penghentian otomatis akibat tidak aktif selama 2 hari juga berlaku pada mode infinity — lihat Host Mode → Siklus dan Penetapan Harga.

Pada Time Status, alamat infinity melaporkan cycles_ordered dan cycles_remaining sebagai null — tidak ada batasan untuk dihitung mundur. Pahami null sebagai “tanpa batas”, bukan sebagai “tidak ada siklus tersisa”.

Contoh Permintaan

cURL

curl -X POST https://netts.io/apiv2/time/infinitystart \
  -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/infinitystart",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Infinity mode active, order:", result["data"]["order_id"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/infinitystart', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Infinity mode active, order:', result.data.order_id);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Respons

Berhasil (200 OK)

{
    "code": 0,
    "msg": "Infinity mode activated successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "order_id": 5427,
        "mode": "infinity",
        "status": "active",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Bidang Respons

Bidang	Tipe	Deskripsi
code	integer	0 = sukses, negatif = kesalahan
msg	string	Pesan yang dapat dibaca manusia
data.address	string	Alamat yang diaktifkan dalam mode infinity
data.order_id	integer	Pengidentifikasi pesanan internal
data.mode	string	"infinity"
data.status	string	"active"
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	Failed to activate host mode	Alamat tidak dapat diaktifkan — coba lagi
-1	Database error activating infinity mode	Kesalahan sementara pada sisi server — coba lagi
-1	Internal server error	Kesalahan tak terduga — coba lagi atau hubungi dukungan
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Saldo di bawah harga satu siklus
-4	Address not found. Please add address first	Alamat tidak terdaftar di Host Mode
-5	Host mode is already active for this address	Alamat sudah berjalan
-6	There is already an open order for this address	Pesanan terbuka sudah ada

{ "code": -4, "msg": "Address not found. Please add address first", "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 ini menggunakan status non-200 dan bentuk body yang berbeda:

HTTP	Body	Penyebab
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	Saldo akun terlalu rendah
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API key diblokir — hubungi dukungan
422	{"detail": [ … ]}	Body permintaan gagal validasi: bidang yang diperlukan hilang atau memiliki tipe yang salah. Perhatikan bahwa tidak ada bidang code dalam respons ini

Endpoint Terkait

• POST /apiv2/time/add — tambahkan alamat terlebih dahulu
• POST /apiv2/time/order — beli jumlah siklus tetap sebagai gantinya
• POST /apiv2/time/stop — hentikan mode infinity
• POST /apiv2/time/status — periksa status

Catatan

• Mode infinity berjalan hingga Anda menghentikannya dengan /apiv2/time/stop.
• Pertahankan saldo yang cukup — siklus ditagih saat didelegasikan.
• Gunakan endpoint ini untuk melanjutkan alamat yang sebelumnya dihentikan (alamat harus dalam status tidak aktif).