POST /apiv2/time/order

Bir adres için belirli sayıda Energy delegasyon döngüsü satın alın ve bu adres için Host Mode'u etkinleştirin.

Uç Nokta URL'si

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

Kimlik Doğrulama

API anahtarınızı istek gövdesinde (api_key) veya X-API-KEY başlığında sağlayın. İstek IP'si, API anahtarınız için yapılandırılmış beyaz listede olmalıdır.

İstek Gövdesi

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

Parametreler

Parametre	Tür	Gerekli	Açıklama
api_key	string	Evet	API anahtarı (veya X-API-KEY başlığı).
address	string	Evet	TRON (TRC-20) adresi, ^T[1-9A-HJ-NP-Za-km-z]{33}$.
cycles	integer	Evet	Satın alınacak döngü sayısı. ≥ 1 olmalıdır.

Fiyatlandırma ve faturalandırma

• Döngü siparişi vermek sizden peşin ücret almaz. Her döngü, Energy'si delege edildiği anda faturalandırılır: bir etkinleştirmenin ilk delegasyonu 4 TRX tutarındadır, sonraki her biri önceki transferinizin gerçekte tükettiği Energy'ye bağlı olarak 2 veya 4 TRX tutarındadır (≤65.000 → 2 TRX, daha fazlası → 4 TRX). Günlük 8 TRX minimum tutar (2026-08-29 tarihinden itibaren geçerli) dahil tüm kurallar için Host Mode → Döngüler ve Fiyatlandırma bölümüne bakın.
• Yanıttaki amount bir tahmindir (cycles × referans fiyat), nihai toplam değildir.
• Sipariş kabul edilmeden önce bakiyeniz kontrol edilir; siparişi karşılayamıyorsa sipariş reddedilir (hata -2).

Bir sipariş vermek, adresi active duruma getirir ve talep edilen döngü sayısı için açık bir sipariş oluşturur. Adres daha sonra döngü döngü Energy delegasyonları almaya başlar ve her delegasyon gerçekleştiğinde ücretlendirilir.

Örnek İstekler

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

Yanıt

Başarılı (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"
    }
}

Yanıt Alanları

Alan	Tür	Açıklama
code	integer	0 = başarılı, negatif = hata
msg	string	İnsan tarafından okunabilir mesaj
data.order_id	integer	Dahili sipariş tanımlayıcısı
data.address	string	Döngülerin satın alındığı adres
data.cycles	integer	Satın alınan döngü sayısı
data.amount	number	TRX cinsinden tahmini sipariş toplamı (yalnızca referans amaçlıdır — faturalandırma delegasyon başınadır)
data.status	string	Başarılı bir siparişin ardından "active"
data.timestamp	string	Siparişin ISO zaman damgası

Hata Yanıtları

code	msg	Neden
-1	Invalid API key or IP not in whitelist	Kimlik doğrulama başarısız oldu
-1	Invalid TRC-20 address format	Hatalı adres biçimi
-1	Cycle count must be 1 or more	cycles < 1
-1	Database error processing order	Geçici sunucu tarafı hatası — tekrar deneyin
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Bakiye sipariş toplamının altında
-6	Cannot buy cycles: There is an open order with … cycles for this address	Zaten açık bir sipariş mevcut (infinity dahil)

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

İlgili Uç Noktalar

• POST /apiv2/time/add — önce adresi ekleyin
• POST /apiv2/time/infinitystart — sabit bir sayı yerine sınırsız döngü
• POST /apiv2/time/status — kalan döngüleri kontrol edin
• POST /apiv2/time/stop — siparişi durdurun ve kapatın

Notlar

• Adres henüz Host Mode'da değilse, sipariş vermek aynı zamanda adresi kaydeder ve etkinleştirir.
• Bir adres için aynı anda yalnızca bir açık siparişe izin verilir.
• Satın alınan döngüler her delegasyonda bir adet tüketilir; tükendiklerinde adres otomatik olarak durur.