POST /apiv2/time/order

Bir adres için belirli sayıda enerji 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 adresi, API anahtarınız için yapılandırılmış beyaz listede yer almalıdır.

İstek Gövdesi

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

Parametreler

Parametre	Tür	Zorunlu	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ü, enerjisi delege edildiği anda faturalandırılır: Bir etkinleştirmenin ilk delegasyonu 4 TRX tutarındadır, sonraki her delegasyon ise önceki transferinizin fiilen tükettiği enerjiye bağlı olarak 2 veya 4 TRX tutarındadır (≤65.000 → 2 TRX, daha fazlası → 4 TRX). Kuralların tamamı için Host Mode → Döngüler ve Fiyatlandırma bölümüne, 8 TRX tutarındaki günlük minimum ücret için (2026-08-29 tarihinden itibaren geçerli) Günlük minimum bölümüne bakın.
• Yanıttaki amount, nihai toplam değil, bir tahmindir (cycles × referans fiyat).
• Sipariş kabul edilmeden önce bakiyeniz kontrol edilir; siparişi karşılayamıyorsa sipariş reddedilir (-2 hatası).

Sipariş vermek adresi active (etkin) olarak ayarlar ve istenen döngü sayısı için açık bir sipariş oluşturur. Ardından adres döngü döngü enerji 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"
}

Hedef adrese izin verilmiyor (403)

Sipariş kabul edilmeden önce adres kontrol edilir. Adrese kaynak delegasyonuna izin verilmiyorsa, istek HTTP 403 ile reddedilir ve hiçbir şey yazılmaz — sipariş oluşturulmaz ve adres eklenmez veya açılmaz. Gövde detail yapısını kullanır:

code	msg	Anlamı
1006	Address is blocked. Contact support.	Adres engellenmiş
1007	Energy rental to smart contracts is not supported.	Adres bir akıllı sözleşmedir (GasFree cüzdan adresleri de akıllı sözleşmelerdir)
1010	Resource delegation to this address is not available.	Bu adrese kaynak delegasyonu kullanılamıyor
1011	This address is frozen and cannot receive resource delegation.	Adres dondurulmuş

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

İlgili Endpoint'ler

• 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 — durdurun ve siparişi kapatın

Notlar

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