Enerji Miktarını Tahmin Et

Bu uç nokta işlem oluşturmadan token transferi yapmak için gereken enerji miktarını tahmin eder.

POST /v1/estimate-energy

İstek

İstek Parametreleri

Alan	Tür	Gerekli	Açıklama
from_address	string	Evet	Gönderenin TRON cüzdan adresi (34 karakter)
to_address	string	Evet	Alıcının TRON cüzdan adresi (34 karakter)
contract_address	string	Hayır	Akıllı sözleşme adresi (varsayılan: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t - Tether (USDT))

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "from_address": "TRX_FROM_ADDRESS",
  "to_address": "TRX_TO_ADDRESS",
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}'

# İmzayı hesapla
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# API isteği yap
curl -X POST "https://api.trxup.com/v1/estimate-energy" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  from_address: 'TRX_FROM_ADDRESS',
  to_address: 'TRX_TO_ADDRESS',
  contract_address: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
});

// İmzayı hesapla
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// API isteği yap
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/estimate-energy',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'from_address' => 'TRX_FROM_ADDRESS',
  'to_address' => 'TRX_TO_ADDRESS',
  'contract_address' => 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
]);

// İmzayı hesapla
$signature = hash('sha256', $requestBody . $apiSecret);

// API isteği yap
$ch = curl_init('https://api.trxup.com/v1/estimate-energy');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'from_address': 'TRX_FROM_ADDRESS',
  'to_address': 'TRX_TO_ADDRESS',
  'contract_address': 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
})

# İmzayı hesapla
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# API isteği yap
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/estimate-energy',
  headers=headers,
  data=request_body
)

print(response.json())

Yanıt

Yanıt, token transferi yapmak için gereken enerji ile ilgili ayrıntılı hesaplama bilgilerini sağlar.

Yanıt Alanları

Alan	Tür	Açıklama
code	integer	Yanıt kodu (0 = başarılı)
request_id	string	Benzersiz istek tanımlayıcısı
result	object	Yanıt verisi
result.amount	integer	Transferi karşılayan enerji miktarı ve Create Transaction çağrısına verilecek değer: tam olarak bu miktar satılıyorsa tahminin kendisi, satılmıyorsa satıştaki bir üst en küçük miktar
result.energy	integer	Sözleşme kullanarak transfer yapmak için gereken enerji miktarı (kullanımdan kalktı, amount kullanın)
result.needed	integer	Transferin kendisinin yaktığı miktar, düğümün bildirdiği gibi. Yalnızca amount değerinden küçük olduğunda — yani transfer satıştaki en küçük miktarın altında kaldığında — döner
result.duration	integer	Saat cinsinden süre (şu anda yalnızca 1 saat mevcut)
result.price	float	Enerji delegasyonu fiyatı
result.activation_fee	float	Adres etkinleştirme fiyatı (gerekirse)
result.total	float	Gerekirse etkinleştirme dahil nihai fiyat
result.from_address	string	İstekte sağlanan gönderenin TRON adresi
result.to_address	string	İstekte sağlanan alıcının TRON adresi
result.contract_address	string	Hesaplama için kullanılan akıllı sözleşme adresi

Örnek Yanıt

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "amount": 64400,
        "energy": 64400,
        "duration": 1,
        "price": 3.66,
        "activation_fee": 0,
        "total": 3.66,
        "from_address": "TRX_FROM_ADDRESS",
        "to_address": "TRX_TO_ADDRESS",
        "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
    }
}

Örnek Yanıt (Adres etkinleştirilmemiş)

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "amount": 64400,
        "energy": 64400,
        "duration": 1,
        "price": 3.66,
        "activation_fee": 1.4,
        "total": 5.06,
        "from_address": "TRX_FROM_ADDRESS",
        "to_address": "TRX_TO_ADDRESS",
        "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
    }
}

Örnek Yanıt (satıştaki en küçük miktarın altında bir transfer)

{
    "code": 0,
    "request_id": "bbf74bcd-fb36-4df8-adc8-25f2bacd087b",
    "result": {
        "amount": 65000,
        "energy": 65000,
        "duration": 1,
        "price": 3.4,
        "activation_fee": 0,
        "total": 3.4,
        "needed": 64285,
        "from_address": "TRX_FROM_ADDRESS",
        "to_address": "TRX_TO_ADDRESS",
        "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
    }
}

Olası Hatalar

Hata Kodu	Key	Açıklama
1	auth	Kimlik doğrulama hatası (yanlış token veya imza)
10	invalid_tron_address	Geçersiz gönderen adresi
10	invalid_tron_address	Geçersiz alıcı adresi
10	invalid_tron_address	Geçersiz sözleşme adresi
35	service_unavailable	Hizmet kullanılamıyor
500	internal_server_error	Dahili sunucu hatası

Notlar

• contract_address parametresi isteğe bağlıdır ve varsayılan olarak TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t (Tether USDT) değerini alır
• Bu uç nokta yalnızca işlem oluşturmadan USDT transferi yapmak için enerjiyi tahmin eder
• Gerçek bir enerji satın alma işlemi oluşturmak için İşlem Oluştur uç noktasını kullanın
• Enerji sabit miktarlarla satılır. Satıştaki en küçük miktardan daha azını yakan bir transfer, o miktar üzerinden fiyatlanır: amount satın aldığınız ve ödediğiniz miktardır, needed ise transferin yaktığı miktardır. 35 service_unavailable kodu, satıştaki hiçbir şeyin karşılamadığı tahminler için kalır — en büyük miktarın üzerinde veya saatlik enerji hiç satışta değilken