Saltar al contenido principal
GET
/
api
/
v1
/
orders
/
{order_id}
Obtener orden
curl --request GET \
  --url https://api.example.com/api/v1/orders/{order_id}

Obtener orden

Devuelve el estado actual y los detalles completos de una orden de energía o ancho de banda.

Parámetros de ruta

order_id
number
requerido
ID de la orden — el id devuelto por Buy Energy o Buy Bandwidth.

Respuesta

Devuelve el objeto completo de la orden, incluyendo status, type, volume, price_trx, delegate_txid y marcas de tiempo.

Estados de la orden

EstadoDescripción
pendingOrden recibida, delegación en curso
filledEnergía o ancho de banda delegados correctamente
failedLa delegación falló
reclaimedAncho de banda devuelto tras el período de alquiler (solo órdenes de ancho de banda)

Ejemplo

curl https://api.tronrental.com/v1/orders/12345 \
  -H "X-API-Key: your_api_key"
Response
{
  "id": 12345,
  "type": "energy",
  "target_address": "TRecipientAddress...",
  "volume": 65000,
  "duration": "1h",
  "price_trx": "1.79",
  "status": "filled",
  "delegate_txid": "a1b2c3d4e5f6...",
  "undelegate_txid": null,
  "reclaim_at": null,
  "source": "api",
  "created_at": "2026-06-10T04:30:00Z"
}