Tovanix
Tovanix

API Sewa Energi TRON

Sewa energi TRON melalui program sebagai alternatif membakar TRX untuk biaya — potensi penghematan 70–80% per transfer TRC-20, sesuai kondisi jaringan dan harga sewa.

  • Pemesanan: tentukan alamat penerima, jumlah energi, dan masa sewa; delegasi diterima dalam hitungan detik
  • Pencarian pesanan: periksa status delegasi dan kedaluwarsa berdasarkan ID pesanan atau alamat
  • Harga: harga per unit terkini dan tingkatan harga untuk perencanaan biaya
  • Webhook: peristiwa delegasi berhasil dan kedaluwarsa, ditandatangani HMAC

GET / POST /api/v1/energy/*

Autentikasi

API energi memakai kunci API pengguna untuk autentikasi. Sertakan header berikut pada tiap permintaan:

Masuk ke konsol → Alat & Pengaturan → Pengelolaan API, lalu buat dan aktifkan kunci untuk memperoleh X-API-Key dan X-Secret-Key.

Panggilan bertanda tangan endpoint biaya

Membuat pesanan, pesanan sekali pakai, dan penarikan kembali adalah endpoint berbiaya. Kunci API baru secara bawaan mewajibkan permintaan bertanda tangan untuk endpoint tersebut (X-Key-ID / X-Timestamp / X-Nonce / X-Sign-Version / X-Signature); di bawah ini contoh lengkap untuk membuat pesanan. Endpoint kueri tetap menerima X-API-Key + X-Secret-Key saja. Jika Anda mematikan "Wajibkan tanda tangan untuk permintaan berbiaya dan data sensitif" di pengaturan kunci, endpoint berbiaya juga menerima X-Secret-Key biasa, tetapi ini tidak disarankan.

Ringkasan

Transfer USDT on-chain TRON memakai Energi. Alamat tanpa TRX dibekukan membayar ~6,5-13 TRX per transaksi. Dengan energi sewaan, transfer memakai energi itu alih-alih membakar TRX; besar penghematan bergantung pada harga sewa saat memesan.

Transfer ke alamat yang punya USDT: ~65,000 Energi

Transfer ke alamat belum pernah menerima USDT: ~135,000 Energi

Ambil Informasi Platform

GET /api/v1/energy/info

Ambil info publik layanan sewa: energi tersedia, tingkat harga, dan batas.

Kueri saldo akun

GET /api/v1/energy/balance

Kueri saldo pemilik kunci API. Sewa energi sering dan bernilai kecil, sehingga saldo habis lazim — cek sebelum pesanan massal dan pasang peringatan saldo rendah.

Daftar durasi sewa (endpoint)

GET /api/v1/energy/periods

Mengembalikan nilai period yang didukung. Nilai di luar daftar ditolak 400 tanpa membuat pesanan.

Estimasi Harga

GET /api/v1/energy/price

Estimasi biaya menurut durasi/jumlah; menghasilkan harga khusus API dalam TRX.

Estimasi Konsumsi Energi

GET /api/v1/energy/estimate-energy

Estimasi energi untuk transfer USDT ke alamat tertentu.

Buat Pesanan Sewa

POST /api/v1/energy/order

Pesan sewa energi; biaya dari saldo akun USD.

Kolom Respons

Jika saldo kurang, mengembalikan code: 400, message: "Insufficient account balance, please top up first"

Pesanan Energi Sekali Pakai

POST /api/v1/energy/order/onetime

Pesan dengan strategi per transaksi; energy_amount otomatis ditetapkan sistem.

Kueri Daftar Pesanan

GET /api/v1/energy/orders

Kueri pesanan sewa energi Anda.

Kueri Pesanan Tunggal

GET /api/v1/energy/order/:serial

Kueri detail dan sinkronkan status terbaru.

Kueri melalui nomor transaksi Anda

GET /api/v1/energy/order/by-trade-no/:out_trade_no

Cari melalui out_trade_no sendiri tanpa memerlukan seri kami.

⚠️ Saat waktu habis, endpoint buat menghasilkan 504 dan Anda hanya punya out_trade_no (serial dibuat oleh kami dan tidak ada di respons timeout). Gunakan endpoint ini dengan out_trade_no sama untuk memperoleh hasil akhir.

Tarik Kembali Pesanan

POST /api/v1/energy/order/reclaim

Tarik kembali sewa yang belum kedaluwarsa lebih awal.

Callback hasil pesanan

Pesanan dengan callback_url, termasuk sekali pakai, didorong saat pertama berhasil status=40/gagal status=41. Apa pun sumber konfirmasi — notifikasi status waktu nyata, polling, rekonsiliasi, pemulihan gagal simpan — tiap pesanan sekali, dengan ulang otomatis jika pengiriman gagal. Pengecualian: buat menghasilkan 504 dengan hasil belum diketahui, placeholder seri LOCAL-, diselesaikan manual tanpa push; kueri melalui nomor Anda. Push ditandatangani platform; format callback lama tidak dipakai lagi, sehingga integrasi lama harus memperbarui parsing dan verifikasi.

POST dengan Content-Type: application/json. JSON datar semua nilai teks, termasuk status/energy_amount/timestamp, tanpa harga. Tidak mengikuti redirect; timeout 10 detik.

Verifikasi tanda tangan

Algoritmanya sama dengan callback pesanan pembayaran: ambil setiap field yang nilainya tidak kosong kecuali sign, urutkan menurut nama field dalam urutan ASCII, gabungkan sebagai k1=v1&k2=v2&…, lalu hitung HMAC-SHA256; hasilnya heksadesimal huruf kecil. Kuncinya adalah Secret Key dari kunci API yang dipakai membuat pesanan; untuk pesanan yang dibuat dengan kredensial aplikasi pembayaran, kuncinya adalah Push Secret aplikasi tersebut (WebhookSecret, ditampilkan di halaman detail aplikasi di konsol — kunci yang sama dengan callback pesanan pembayaran); aplikasi lama yang belum pernah membuat Push Secret memakai App Key.

Push tidak membawa sign bila pesanan dibuat oleh dukungan platform atas nama Anda (tidak ada kunci untuknya), atau bila kunci API maupun aplikasi pembayaran yang dipakai membuat pesanan sudah dihapus. Saat menerima push tanpa sign, konfirmasikan status pesanan melalui endpoint kueri pesanan sebelum menindaklanjutinya.

Respons dan ulang

Semua 2xx dianggap terkirim tanpa memeriksa isi. Selain 2xx, timeout/koneksi/redirect gagal: ulang 30 detik, 1 menit, 2 menit, 5 menit, lalu tiap 10 menit hingga 10 ulang (sekitar 70 menit). Isi tetap sama termasuk notify_id/sign.

Jika jaringan putus setelah server memproses sebelum 2xx diterima, push diulang. Deduplikasi notify_id/serial agar pemrosesan ganda tanpa efek samping. Push bukan satu-satunya kebenaran; jika tidak tiba/gagal akhir, kueri GET /api/v1/energy/order/:serial atau nomor Anda.

Durasi Sewa

Semua durasi saat ini tersedia juga dari GET /api/v1/energy/periods. Nilai lain menghasilkan 400 tanpa pesanan.

Pertanyaan umum

Berapa penghematan aktual API sewa energi?

Sebagai ilustrasi, membakar TRX langsung untuk satu transfer USDT TRC-20 dapat menghabiskan sekitar 6,5-13 TRX. Sewa energi berpotensi menghemat 70–80%; penghematan aktual, termasuk transfer massal, mengikuti kondisi jaringan dan harga sewa.

Seberapa cepat delegasi dan bisakah ditujukan ke alamat lain?

Delegasi diterima dalam hitungan detik, dan alamat penerima mengikuti nilai dalam permintaan — tidak harus akun pemesan, sehingga Anda dapat memasok energi secara massal ke berbagai alamat bisnis.

Halaman terkait: Sewa Energi TRON · Dokumentasi API · Pembayaran Kripto Multichain

Memuat…