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

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

Isi 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 akan dibeli. Harus ≥ 1.

Penetapan harga dan penagihan

• Memesan siklus tidak membebankan biaya di awal. Setiap siklus ditagihkan pada saat Energy didelegasikan: delegasi pertama dari sebuah 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 → 4 TRX). Lihat Host Mode → Cycles and Pricing untuk aturan lengkapnya, dan Daily minimum untuk minimum harian 8 TRX (efektif 2026-08-29).
• Nilai amount di dalam respons adalah sebuah perkiraan (cycles × reference price), bukan total akhir.
• Saldo Anda diperiksa sebelum pesanan diterima; jika saldo tidak dapat menutupi pesanan, pesanan akan ditolak (kesalahan -2).

Melakukan pemesanan akan menyetel status alamat menjadi aktif dan membuat pesanan terbuka untuk jumlah siklus yang diminta. Alamat kemudian mulai menerima delegasi Energy siklus demi siklus, dan setiap delegasi dikenakan biaya saat itu terjadi.

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

Field Respons

Field	Tipe	Deskripsi
code	integer	0 = berhasil, negatif = kesalahan
msg	string	Pesan yang dapat dibaca manusia
data.order_id	integer	Pengenal pesanan internal
data.address	string	Alamat tujuan pembelian siklus
data.cycles	integer	Jumlah siklus yang dibeli
data.amount	number	Perkiraan total pesanan, dalam TRX (hanya referensi — penagihan dilakukan per delegasi)
data.status	string	"active" setelah pesanan berhasil
data.timestamp	string	Timestamp ISO dari 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 tak terbatas)

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

Alamat tujuan tidak diizinkan (403)

Alamat diperiksa sebelum pesanan diterima. Jika delegasi sumber daya ke alamat tersebut tidak diizinkan, permintaan akan ditolak dengan HTTP 403 dan tidak ada yang ditulis — pesanan tidak dibuat dan alamat tidak ditambahkan atau diaktifkan. Bagian body menggunakan format detail:

code	msg	Arti
1006	Address is blocked. Contact support.	Alamat diblokir
1007	Energy rental to smart contracts is not supported.	Alamat merupakan smart contract (alamat dompet GasFree juga merupakan smart contract)
1010	Resource delegation to this address is not available.	Delegasi 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/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, melakukan pemesanan juga akan mendaftarkannya dan mengaktifkannya.
• Hanya satu pesanan terbuka per alamat yang diizinkan dalam satu waktu.
• Siklus yang dibeli dikonsumsi satu per delegasi; ketika habis, alamat akan berhenti secara otomatis.