API

Integra la compra de energía con una API key. Tu cliente, con sus propios TRX, compra energía para CUALQUIER wallet: la API consulta el stock, crea la orden, él paga el monto exacto desde su cartera y la energía se delega a la wallet destino. Vende en cualquier temporalidad disponible (de 5 min a 30 días).

1. Obtén tu API key

Genérala en tu Panel → API (se muestra una sola vez; guárdala segura). Mándala en el header X-API-Key. /dashboard/api

2. Crea la orden

Llama a POST /orders con la wallet destino y la energía. Devuelve el monto EXACTO a pagar (en vivo, igual que la plataforma) y la dirección.

POST https://tron-services.xyz/api/v1/orders
Header: X-API-Key: trk_xxxxxxxx
Body:   { "resource": "energy", "amount": 65000,
          "duration_key": "5min", "target_address": "T..." }

→ {
  "order": { "id": 123, "status": "pending_payment" },
  "payment": {
    "deposit_address": "T...",
    "amount_due": 1.952341,
    "currency": "TRX"
  }
}

3. El cliente paga

Tu cliente envía el monto EXACTO (amount_due) en TRX nativo, desde CUALQUIER cartera, a la dirección. La energía se delega a la wallet destino (no a la que paga) por la duración elegida. El pago se detecta y se entrega AUTOMÁTICAMENTE.

4. Confirma

Tras pagar, llama a POST /orders/{id}/check cada ~5s: detecta el pago y ENTREGA en esa misma llamada (usa timeout HTTP de 60s+). GET /orders/{id} es solo lectura del estado.

POST /api/v1/orders/123/check     # every ~5s after paying
Header: X-API-Key: trk_xxxxxxxx

→ { "status": "pending_payment" }  # not detected yet, retry
→ { "status": "active", "delegation_tx_hash": "..." }

GET /api/v1/orders/123             # read-only status
→ { "status": "active", "delegation_tx_hash": "..." }

📦 Ver stock disponible

Antes de vender, consulta cuánta energía hay en stock (total y por temporalidad). Si pides más de lo disponible, la orden se rechaza (409).

GET /api/v1/pool
→ { "energy": { "available": 2100000, "total": 8300000 } }

GET /api/v1/availability?resource=energy
→ { "durations": [
     { "duration": "5min", "available": 2100000 },
     { "duration": "1d",   "available": 2100000 },
     { "duration": "30d",  "available": 0 }
   ] }

Cotización (opcional)

Consulta el precio antes de crear la orden — en vivo, igual que la plataforma.

POST /api/v1/quote
{ "resource":"energy", "amount":65000, "duration_key":"5min" }
→ { "price_trx": 1.95, "price_usdt": 0.21 }

🔒 Seguridad

La API NUNCA mueve ni guarda fondos: solo crea órdenes e informa el monto y la dirección. Sin el pago exacto no hay energía, así que ni tus fondos quedan expuestos ni el cliente puede obtener energía que no pagó.

📣 Antes de integrar

Si vas a abrir o integrar una API key, contáctame para avisarte de futuros cambios de precios o actualizaciones: @Zurcnuf