POST /apiv2/time/infinitystart

Host Mode içinde zaten bulunan bir adres için sonsuz (sınırsız) modu etkinleştirin — siz durdurana kadar enerji döngü üstüne döngü delege edilmeye devam eder.

Uç Nokta URL'si

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

Kimlik Doğrulama

API anahtarınızı istek gövdesinde (api_key) veya X-API-KEY üstbilgisinde sağlayın. İstek IP adresi, API anahtarınız için yapılandırılmış beyaz listede bulunmalıdır.

İstek Gövdesi

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

Parametreler

Parametre	Tür	Gerekli	Açıklama
api_key	string	Evet	API anahtarı (veya X-API-KEY üstbilgisi).
address	string	Evet	TRON (TRC-20) adresi, ^T[1-9A-HJ-NP-Za-km-z]{33}$. Adres zaten Host Mode içinde bulunmalıdır (önce ekleyin).

Davranış

• Adres zaten Host Mode içinde mevcut olmalı ve etkin olmamalıdır (durdurulmuş).
• Bakiyeniz geçerli fiyattan en az bir döngüyü karşılamalıdır (etkinleştirme öncesinde kontrol edilir).
• Endpoint adresi etkinleştirir, açık bir sonsuz sipariş oluşturur ve siz /apiv2/time/stop çağrısı yapana kadar Host Mode döngü üstüne döngü enerji delege etmeye devam eder.

Döngüler delege edildikçe faturalandırılır (delegasyon başına bir döngü). Bir etkinleştirmenin ilk delegasyonu 4 TRX tutarındadır; sonraki her biri önceki transferinizin gerçekte tükettiği enerjiye bağlı olarak 2 veya 4 TRX tutarındadır (≤ 65.000 → 2 TRX, daha fazlası → 4 TRX). 8 TRX günlük minimum tutar (2026-08-29 tarihinden itibaren geçerli) ve 2 günlük boşta kalma kapatması sonsuz modda da geçerlidir — bkz. Host Mode → Döngüler ve Fiyatlandırma ve Günlük minimum.

Time Status içinde bir sonsuz adres, cycles_ordered ve cycles_remaining değerlerini null olarak bildirir — geriye doğru sayılacak bir sınır yoktur. null değerini "hiç döngü kalmadı" olarak değil, "sınırsız" olarak yorumlayın.

Örnek İstekler

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

Yanıt

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

Yanıt Alanları

Alan	Tür	Açıklama
code	integer	0 = başarılı, negatif = hata
msg	string	İnsan tarafından okunabilir mesaj
data.address	string	Sonsuz modda etkinleştirilen adres
data.order_id	integer	Dahili sipariş tanımlayıcısı
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	ISO zaman damgası

Hata Yanıtları

code	msg	Neden
-1	API key required in X-API-KEY header or request body	Hiçbir API anahtarı sağlanmadı
-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 formatı
-1	Failed to activate host mode	Adres etkinleştirilemedi — tekrar deneyin
-1	Database error activating infinity mode	Geçici sunucu tarafı hatası — tekrar deneyin
-1	Internal server error	Beklenmeyen hata — tekrar deneyin veya destekle iletişime geçin
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Bakiye bir döngü fiyatının altında
-4	Address not found. Please add address first	Adres Host Mode içinde değil
-5	Host mode is already active for this address	Adres zaten çalışıyor
-6	There is already an open order for this address	Halihazırda açık bir sipariş mevcut

{ "code": -4, "msg": "Address not found. Please add address first", "data": null }

HTTP durum kodları

Endpoint hataları HTTP 200 ve negatif bir code ile döndürülür — HTTP durumunu değil, code değerini kontrol edin. Hata gövdeleri her zaman "data": null içerir.

Bazı hatalar istek endpointe ulaşmadan önce döndürülür. Bunlar 200 dışı bir durum ve farklı bir gövde yapısı kullanır:

HTTP	Gövde	Neden
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	Hesap bakiyesi çok düşük
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API anahtarı engellendi — destekle iletişime geçin
422	{"detail": [ … ]}	İstek gövdesi doğrulamadan geçemedi: gerekli bir alan eksik veya yanlış türe sahip. Bu yanıtta code alanı bulunmadığına dikkat edin

Hedef adrese izin verilmiyor (403)

Adres açılmadan önce kontrol edilir. Adrese kaynak delegasyonuna izin verilmiyorsa istek HTTP 403 ile reddedilir ve hiçbir şey yazılmaz — adres etkin değil olarak kalır ve hiçbir sipariş oluşturulmaz. Gövde detail yapısını kullanır:

code	msg	Anlamı
1006	Address is blocked. Contact support.	Adres engellendi
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 delegasyon kullanılamıyor
1011	This address is frozen and cannot receive resource delegation.	Adres dondurulmuştur ve kaynak delegasyonu alamaz

{ "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/order — bunun yerine sabit sayıda döngü satın alın
• POST /apiv2/time/stop — sonsuz modu durdurun
• POST /apiv2/time/status — durumu kontrol edin

Notlar

• Sonsuz mod, siz /apiv2/time/stop ile durdurana kadar çalışır.
• Yeterli bakiyeyi hazır bulundurun — döngüler delege edildikçe ücretlendirilir.
• Daha önce durdurulmuş bir adresi devam ettirmek için bu endpoint'i kullanın (etkin olmamalıdır).