Skip to content

Order energy for 1 hour

POST
/order1h

Hourly energy rental. The order goes through several providers with automatic failover: the cheapest available one is picked, and if it declines the order moves to the next.

Energy normally arrives in 0.5–10 seconds. The response timeout is 10 seconds. If the receiver address is not activated on TRON, NETTS activates it at cost price and the response may take up to 6 seconds.

A buffer of +50 energy units is added to the order automatically, free of charge, as compensation to the provider.

Idempotency. Request uniqueness is determined by the combination of the timestamp (a 1-second window), the amount, the receiver address and the key. Repeating the same request does not charge you twice: you get 208 with the cached response, or 409 if the first one is still running. Identical requests must not be sent in parallel.

Authorizations

ApiKeyAuth

API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.

Type
API Key (header: X-API-KEY)

Parameters

Header Parameters

X-Real-IP*

An IP address from the key's whitelist. A request from an address outside the whitelist is rejected with 401.

Type
string
Required
Example"203.0.113.10"
Format
"ipv4"

Request Body

application/json
JSON
{
  
"amount": 131000,
  
"receiveAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
}

Responses

The order was fulfilled and the energy delegated.

application/json
JSON
{
  
"detail": {
  
  
"code": 10000,
  
  
"msg": "Successful, 2.23 TRX deducted",
  
  
"data": {
  
  
  
"orderId": "1H70bcc7962a",
  
  
  
"paidTRX": 2.535,
  
  
  
"hash": "string",
  
  
  
"delegateAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  
  
  
"energy": 131050,
  
  
  
"activationHash": "string"
  
  
}
  
}
}

Playground

Authorization
Headers
Body

Samples

Powered by VitePress OpenAPI