Otomatik Dolum
Otomatik Dolum bir TRON adresini izler ve enerjisi veya bant genişliği belirlediğiniz seviyenin altına düştüğünde adresi doldurur. Eşiği, her seferinde ne kadar ekleneceğini ve kiralama süresini siz seçersiniz. Her dolum, bakiyenizden ödenen sıradan bir sipariştir.Nasıl çalışır
- Bir adres için eşik,
add_volumevedurationiçeren bir kural oluşturun. - Adreste ne kadar kullanılabilir enerji (veya bant genişliği) olduğunu dakikada bir kez ve o adresten yapılan her giden USDT transferinin hemen ardından kontrol ederiz.
- Seviye eşiğin altındaysa adres için
add_volumekadar satın alır ve bakiyenizden sizin fiyatınızla ücret alırız. - Kiralama, süresi dolunca sona erer. Seviye yeniden eşiğin altına düştüğünde kural yeniden satın alır. Kural adresi bu yolla sürekli dolu tutar: ayrı bir yenileme adımı yoktur.
last_read_error_at alanında gösterir ve bir sonraki kontrol yeniden dener.
Kural oluşturmak anında hiçbir şey satın almaz. İlk dolum bir sonraki kontrolde, genellikle bir dakika içinde yapılır. Oluşturma yanıtı, dolumun yapılıp yapılmayacağını (will_refill_now) ve adreste şu anda ne kadar kaynak olduğunu bildirir.
Otomatik Dolum, seviye düştükten sonra tepki verir; bir transferden önce hazırda beklemez. Eşiği en az bir sonraki işleminizin ihtiyacı kadar ayarlayın; böylece işlem gönderildiğinde zaten karşılanmış olur.
Enerji ve bant genişliği
İki kaynağın kendi uç noktaları ve kendi kuralları vardır. Bir adreste aynı anda bir enerji kuralı ve bir bant genişliği kuralı olabilir; her biri kendi eşiğine göre kontrol edilir.
Enerji bir saatliğine kiralanır. Bittiğinde veya süresi dolduğunda seviye düşer ve kural bir sonraki saati satın alır.
Bant genişliği, adresin bir işlemin bedelini ödemek için kullanabileceği her şeyi sayar: her hesabın günde aldığı ücretsiz 600 bant genişliği ile stake edilmiş veya devredilmiş bant genişliği. Bu nedenle 600 veya daha düşük bir eşik, adres bu ücretsiz payı harcayana kadar yalnızca onunla karşılanır.
Sayıları seçmek
Bir USDT transferi, alıcıda zaten USDT varsa yaklaşık 65.000, yoksa yaklaşık 131.000 enerji kullanır; buna ek olarak yaklaşık 345 bant genişliği. Örneğinthreshold_energy: 65000 ile add_volume: 131000, bir transferlik miktardan az kaldığında iki transferlik enerji satın alır.
Maliyet
Her dolum normal bir sipariştir: sizin tarifenizle kiralama bedeli artı her dolumda alınan sabit ücret. Liste ve oluşturma yanıtlarındakiestimated_cost_per_refill_trx, hesabınız için bir dolumun sabit ücret dahil tam fiyatıdır. Bu fiyatı kural oluşturmadan önce görmek için fiyat sorgulama uç noktasını kullanın: enerji, bant genişliği. Sık doldurulan küçük bir add_volume sabit ücreti birçok kez öder; daha büyüğü daha seyrek öder.
API anahtarıyla oluşturulan bir kural, o API anahtarıyla yapılan bir alım gibi fiyatlandırılır; web sitesinde oluşturulan bir kural ise web sitesinden yapılan bir alım gibi. estimated_cost_per_refill_trx bunu zaten yansıtır.
Adres henüz zincirde yoksa ilk dolum, normal bir alımda olduğu gibi adresi de etkinleştirir. Aktivasyon ayrıca ücretlendirilir ve estimated_cost_per_refill_trx içinde yer almaz; sipariş bunu activation_cost_trx alanında gösterir.
Günlük harcama sınırı yoktur: seviye eşiğin altında olduğu ve bakiyeniz bir dolumu karşıladığı sürece kural satın alır.
Siparişler ve webhook’lar
Her dolum, sipariş geçmişinizde (Siparişleri Listele)source: "autorefill" ile görünür. Yalnızca dolum siparişlerini listelemek için GET /orders?source=autorefill çağırın; bunları dosya olarak dışa aktarmak için autorefill raporunu kullanın.
API anahtarıyla oluşturulan kurallar, dolum siparişleri için API üzerinden verdiğiniz siparişlerde olduğu gibi order.updated webhook’ları gönderir. API anahtarı olmadan oluşturulan kurallar göndermez.
Kural durumu
Hatalardan sonra duraklatma. Başarısız bir dolum, başarısız her sipariş gibi iade edilir. Art arda 5 başarısız dolumdan sonra kural duraklatılır ve
stopped_reason son hatanın nedenini verir. consecutive_failures, kuralın bu sınıra ne kadar yaklaştığını gösterir; başarılı bir dolumdan sonra ve kuralı devam ettirdiğinizde 0’a döner. Duraklatılmış bir kural asla kendiliğinden devam etmez: nedeni giderin, ardından status: "active" ayarlayın.
Bakiye nedeniyle durdurma. Bakiyeniz bir dolumu karşılayamadığında kural stopped_insufficient_balance ile durur. Bir para yatırma işlemi bakiyeyi bir dolumun fiyatına çıkardığında kural otomatik olarak active durumuna döner. status: "active" değerini kendiniz de ayarlayabilirsiniz; bakiye hâlâ yetersizse kural bir sonraki kontrolde yeniden durur.
Telegram hesabınız bağlıysa, bir kuralın ilk dolumunda ve bir kural duraklatıldığında, bakiye nedeniyle durdurulduğunda veya devam ettirildiğinde mesaj alırsınız.
Sınırlar
- Bir hesapta adres ve kaynak başına bir kural. Aynı adres için ikinci bir enerji kuralı (veya ikinci bir bant genişliği kuralı) oluşturmak
409 AUTOREFILL_ADDRESS_TAKENdöndürür — bunun yerine mevcut kuralı düzenleyin. - Hesap başına 20 enerji kuralı ve 20 bant genişliği kuralı. Silinmiş kurallar sayılmaz. Sınır aşıldığında:
409 AUTOREFILL_LIMIT_REACHED. - USDT token sözleşmesi gibi sözleşme adresleri kabul edilmez: TRON onlara kaynak devredilmesine izin vermez.
- Kural oluşturma, her kaynak için hesap başına dakikada 10 istekle sınırlıdır. Bkz. Hız Sınırları.
Düzenleme ve silme
Değişiklikler bir sonraki kontrolden itibaren geçerli olur. Kural için bir dolum satın alınırkenPATCH ve DELETE, 409 AUTOREFILL_IN_PROGRESS döndürür — bir dakika sonra yeniden deneyin. Bir kuralı silmek, zaten satın alınmış enerjiyi veya bant genişliğini geri almaz; bu kiralamalar süreleri bitene kadar devam eder.