POST /apiv2/time/order

Beli sejumlah siklus delegasi Energy tertentu untuk sebuah alamat dan aktifkan Host Mode untuk alamat tersebut.

URL Endpoint

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

Autentikasi

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

Body Permintaan

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

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}$.
cycles	integer	Ya	Jumlah siklus yang ingin dibeli. Harus ≥ 1.

Penetapan harga dan penagihan

• Memesan siklus tidak membebankan biaya di muka. Setiap siklus ditagihkan pada saat Energy-nya didelegasikan: delegasi pertama dari suatu aktivasi berbiaya 4 TRX, setiap delegasi berikutnya berbiaya 2 atau 4 TRX tergantung pada Energy yang sebenarnya dikonsumsi oleh transfer Anda sebelumnya (≤65.000 → 2 TRX, lebih → 4 TRX). Lihat Host Mode → Siklus dan Penetapan Harga untuk aturan selengkapnya, termasuk batas minimum harian 8 TRX (berlaku mulai 2026-08-29).
• Nilai amount dalam respons adalah estimasi (cycles × harga referensi), bukan total akhir.
• Saldo Anda akan diperiksa sebelum pesanan diterima; jika tidak dapat mencukupi pesanan, pesanan akan ditolak (kesalahan -2).

Melakukan pemesanan akan mengatur alamat menjadi active dan membuat pesanan terbuka untuk jumlah siklus yang diminta. Alamat kemudian mulai menerima delegasi Energy siklus demi siklus, dan setiap delegasi dikenakan biaya saat dilakukan.

Contoh Permintaan

cURL

curl -X POST https://netts.io/apiv2/time/order \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "cycles": 10
  }'

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/order",
    json={
        "api_key": "YOUR_API_KEY_HERE",
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "cycles": 10,
    },
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    d = result["data"]
    print(f"Order {d['order_id']}: {d['cycles']} cycles for {d['amount']} TRX")
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/order', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    cycles: 10,
}).then(({ data: result }) => {
    if (result.code === 0) {
        const d = result.data;
        console.log(`Order ${d.order_id}: ${d.cycles} cycles for ${d.amount} TRX`);
    } else {
        console.error('Error:', result.msg);
    }
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Respons

Berhasil (200 OK)

{
    "code": 0,
    "msg": "Cycles purchased and host mode activated successfully",
    "data": {
        "order_id": 5426,
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "cycles": 10,
        "amount": 23.5,
        "status": "active",
        "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.order_id	integer	Pengidentifikasi pesanan internal
data.address	string	Alamat tujuan pembelian siklus
data.cycles	integer	Jumlah siklus yang dibeli
data.amount	number	Estimasi total pesanan, dalam TRX (hanya referensi — penagihan dilakukan per delegasi)
data.status	string	"active" setelah pesanan berhasil
data.timestamp	string	Timestamp ISO pesanan

Respons Kesalahan

code	msg	Penyebab
-1	Invalid API key or IP not in whitelist	Autentikasi gagal
-1	Invalid TRC-20 address format	Format alamat salah
-1	Cycle count must be 1 or more	cycles < 1
-1	Database error processing order	Kesalahan sementara pada sisi server — coba lagi
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Saldo di bawah total pesanan
-6	Cannot buy cycles: There is an open order with … cycles for this address	Pesanan terbuka sudah ada (termasuk infinity)

{
    "code": -2,
    "msg": "Insufficient balance. Required: 23.5 TRX, Available: 10.0 TRX"
}

Endpoint Terkait

• POST /apiv2/time/add — tambahkan alamat terlebih dahulu
• POST /apiv2/time/infinitystart — siklus tak terbatas alih-alih jumlah tetap
• POST /apiv2/time/status — periksa sisa siklus
• POST /apiv2/time/stop — hentikan dan tutup pesanan

Catatan

• Jika alamat belum berada di Host Mode, pemesanan juga akan mendaftarkan dan mengaktifkannya.
• Hanya satu pesanan terbuka per alamat yang diperbolehkan dalam satu waktu.
• Siklus yang dibeli dikonsumsi satu per delegasi; ketika habis, alamat akan berhenti secara otomatis.