POST /apiv2/time/infinitystart

Aktifkan mode infinity (tanpa batas) untuk alamat yang sudah berada dalam Host Mode — energy akan 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 di whitelist yang dikonfigurasikan untuk API key Anda.

Isi Permintaan

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

Parameter

Parameter	Type	Required	Description
api_key	string	Yes	API key (atau header X-API-KEY).
address	string	Yes	Alamat TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. Alamat tersebut harus sudah berada dalam Host Mode (tambahkan terlebih dahulu).

Perilaku

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

Siklus ditagih saat didelegasikan (satu siklus per pendelegasian). Pendelegasian pertama dari suatu aktivasi berbiaya 4 TRX; setiap pendelegasian 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). Minimum harian 8 TRX (berlaku mulai 2026-08-29) dan penghentian otomatis setelah 2 hari tidak aktif juga berlaku dalam mode infinity — lihat Host Mode → Siklus dan Harga dan Minimum harian.

Di 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

Sukses (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 Response

Field	Type	Description
code	integer	0 = sukses, negatif = error
msg	string	Pesan yang dapat dibaca manusia
data.address	string	Alamat yang diaktifkan dalam mode infinity
data.order_id	integer	Pengenal pesanan internal
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	Timestamp ISO

Respons Kesalahan

code	msg	Cause
-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 ada 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

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

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

HTTP	Body	Cause
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 divalidasi: bidang yang diperlukan tidak ada atau memiliki tipe yang salah. Perhatikan bahwa tidak ada bidang code dalam respons ini

Alamat tujuan tidak diizinkan (403)

Alamat akan diperiksa sebelum diaktifkan. Jika pendelegasian sumber daya ke alamat tersebut tidak diizinkan, permintaan akan ditolak dengan HTTP 403 dan tidak ada yang ditulis — alamat tetap tidak aktif dan tidak ada pesanan yang dibuat. Body menggunakan bentuk detail:

code	msg	Meaning
1006	Address is blocked. Contact support.	Alamat diblokir
1007	Energy rental to smart contracts is not supported.	Alamat adalah smart contract (alamat dompet GasFree juga merupakan smart contract)
1010	Resource delegation to this address is not available.	Pendelegasian sumber daya ke alamat ini tidak tersedia
1011	This address is frozen and cannot receive resource delegation.	Alamat dibekukan

{ "detail": { "code": 1007, "msg": "Energy rental to smart contracts is not supported." } }

Endpoint Terkait

• POST /apiv2/time/add — tambahkan alamat terlebih dahulu
• POST /apiv2/time/order — beli sejumlah 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.
• Pastikan saldo yang tersedia mencukupi — siklus ditagih saat didelegasikan.
• Gunakan endpoint ini untuk melanjutkan alamat yang sebelumnya dihentikan (alamat harus dalam keadaan tidak aktif).