Fiyat hesapla

GET

api

energy

quote

Fiyat hesapla

curl --request GET \
  --url https://api.example.com/api/v1/energy/quote

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/energy/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/energy/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "volume": 123,
  "duration": "<string>",
  "price_sun": "<string>",
  "rental_trx": "<string>",
  "fixed_fee_trx": "<string>",
  "total_trx": "<string>",
  "total_usd": {},
  "personal_price": true
}

Belirtilen enerji miktarı için tam olarak tahsil edilecek tutarı döner — kiralama ve sabit ücret birlikte, sizin tarifenizle. Bu uç nokta herkese açıktır — kimlik doğrulama isteğe bağlıdır. Kendi fiyatınızı almak için API anahtarınızı gönderin; anahtarsız genel piyasa fiyatı döner.

Belirli bir miktarın fiyatı gerektiğinde bu uç noktayı kullanın. GET /api/v1/prices her zaman 65.000 birim üzerinden fiyat verir ve parametre almaz; POST /api/v1/energy/estimate ise yalnızca piyasa fiyatıyla kiralama tutarını döner ve anahtarınızı yok sayar.

Sorgu parametreleri

integer

gerekli

Fiyatlandırılacak enerji birimi. 60.000 ile 5.000.000 arasında.

string

varsayılan:"1h"

Kiralama süresi. Enerji yalnızca 1h destekler.

Başlıklar

string

İsteğe bağlı. Geçerli bir anahtarla yanıt, anlaşmalı tarifenizi ve ücretinizi yansıtır. Anahtarın olmaması, geçersiz veya iptal edilmiş olması hata değildir — yalnızca genel piyasa fiyatını alırsınız.

Yanıt

number

Fiyatın hesaplandığı enerji miktarı

string

Kiralama süresi (1h)

string

1 enerji birimi başına SUN cinsinden tarife. Diğer miktarları kendiniz hesaplamak için kullanın: kiralama = miktar × price_sun / 1.000.000

string

Bu miktar için kiralama bedeli, sabit ücret hariç

string

Sabit ücret; miktardan bağımsız olarak sipariş başına bir kez alınır. Hesabınızda özel ücret, indirim veya muafiyet varsa burada kendi ücretiniz görünür.

string

Tahsil edilecek tutar: rental_trx + fixed_fee_trx

string | null

Aynı tutarın USD karşılığı. TRX/USD kuru anlık olarak alınamadığında null — TRX değerleri yine geçerlidir.

boolean

Anlaşmalı tarifeniz uygulandıysa true, fiyat genel piyasa fiyatıysa false. Bu alanı kontrol edin: unutulmuş bir X-API-Key başlığı normal bir yanıt gibi görünür ve müşterilerinize genel fiyatı verirken sizden kendi fiyatınız tahsil edilir.

Örnek

curl "https://api.tronrental.com/v1/energy/quote?volume=131000&duration=1h" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

resp = requests.get(
    "https://api.tronrental.com/v1/energy/quote",
    params={"volume": 131000, "duration": "1h"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(resp.json()["total_trx"])

const resp = await fetch(
  "https://api.tronrental.com/v1/energy/quote?volume=131000&duration=1h",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const quote = await resp.json();
console.log(quote.total_trx);

Aşağıdaki değerler örnektir. Enerjinin piyasa fiyatı vardır ve gün içinde değişir.

Response

{
  "volume": 131000,
  "duration": "1h",
  "price_sun": "20.99",
  "rental_trx": "2.749690",
  "fixed_fee_trx": "0.2",
  "total_trx": "2.949690",
  "total_usd": "1.02",
  "personal_price": true
}

Yaygın miktarlar

Miktar	Ne zaman
65,000	Halihazırda USDT bulunduran bir adrese USDT transferi
131,000	Hiç USDT tutmamış bir adrese USDT transferi (yeni bir depolama alanı oluşturulur)

Paket kataloğu yoktur — 60.000 ile 5.000.000 arasındaki her miktar geçerlidir ve sabit ücret her durumda sipariş başına bir kez alınır. Aynı alıcıya iki transfer, iki adet 65.000 yerine tek bir 131.000 siparişi olarak daha ucuza gelir: ücret iki kez yerine bir kez ödenir.

Hatalar

Kod	Anlamı
`400 INVALID_VOLUME`	Miktar 60.000–5.000.000 aralığının dışında
`400 INVALID_DURATION`	`1h` dışında bir süre

Geçersiz veya iptal edilmiş X-API-Key burada hata değildir: fiyat genel piyasa fiyatıyla ve personal_price: false ile döner.

Fiyat hesapla

curl --request GET \
  --url https://api.example.com/api/v1/energy/quote

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/energy/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/energy/quote"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/energy/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "volume": 123,
  "duration": "<string>",
  "price_sun": "<string>",
  "rental_trx": "<string>",
  "fixed_fee_trx": "<string>",
  "total_trx": "<string>",
  "total_usd": {},
  "personal_price": true
}

Temel API

Bant Genişliği Kiralamaları

Siparişler

Faturalar

Smart Mode

Transfer Paketleri

Hesap

Webhooks

Fiyat hesapla

Fiyat hesapla

Sorgu parametreleri

Başlıklar

Yanıt

Örnek

Yaygın miktarlar

Hatalar

​Fiyat hesapla

​Sorgu parametreleri

​Başlıklar

​Yanıt

​Örnek

​Yaygın miktarlar

​Hatalar

Fiyat hesapla

Sorgu parametreleri

Başlıklar

Yanıt

Örnek

Yaygın miktarlar

Hatalar