​
Create Order

To create multiple order, use the endpoint with an array of target addresses.

​
Endpoint

POST https://tronspace.vip/api/public/order

​
Authentication

Requires x-api-key header

​
Request Body

​
targetAddress
array | string
required

One or more TRON wallet addresses to receive the resources

​
duration
string
required

Duration of resource delegation. Valid values:

  • 5m (5 minutes)
  • 15m (15 minutes)
  • 1h (1 hour)
​
resourceType
number
required

Type of resource. Currently only supports:

  • 0 (ENERGY)
​
resourceAmount
number
required

Amount of resource units to delegate

​
Example Request

{
  // Single order
  "targetAddress": "TAA9KiqKZSU2tUhqrPpYBHPprxnKVwnik5",

  // Multiple order
  "targetAddresses": ["TAA9KiqKZSU2tUhqrPpYBHPprxnKVwnik5", "TAA9KiqKZSU2tUhqrPpYBHPprxnKVwnik5"],

  "duration": "5m",
  "resourceType": 0,
  "resourceAmount": 60000
}

​
Response

​
Response Fields

​
Order Information

​
id
string

Unique order identifier (UUID v4)

​
status
enum

Order status:

  • PAYMENT_PENDING - Initial state, awaiting payment
  • PAYMENT_FAILED - Payment not received by paymentDue
  • PAYMENT_CONFIRMED - Payment transaction verified
  • ORDER_PENDING - Processing resource delegation
  • ORDER_COMPLETED - Resources successfully delegated

​
Resource Details

​
details
object

​
Payment Information

​
payment
object
  • Payment must be sent as a single transaction
  • Exact amount must be sent (no more, no less)
  • Payment window is 10 minutes from order creation
  • Resource delegation starts immediately after payment confirmation

​
Example Response

{
  "json": {
    "id": "61553646-39de-4ab2-bd0d-d51a22da9679",
    "status": "PAYMENT_PENDING",
    "details": {
      "resourceType": "ENERGY",
      "amount": {
        "value": 60001,
        "sunValue": 5342967805
      },
      "duration": "FIVE_MIN",
      "target": ["TAA9KiqKZSU2tUhqrPpYBHPprxnKVwnik5"]
    },
    "payment": {
      "amount": {
        "trx": 6.0001,
        "sun": 6000100
      },
      "status": "PAYMENT_PENDING",
      "dueDate": "2025-01-23 12:34:21",
      "paymentAddress": "TBQfnrQzPveCqxZ9prJd8fZY2KJ5dyCqDz"
    },
    "timestamps": {
      "created": "2025-01-23 12:24:21",
      "updated": "2025-01-23 12:24:21"
    }
  },
  "meta": {
    "values": {
      "delegations": ["undefined"]
    }
  }
}