TRONENS API

Antwortformat

Eine echte API-Antwort enthält immer success und bei Erfolg data. Fehler enthalten einen maschinenlesbaren error-Code. Die Diagnosedatei zeigt zusätzlich method, url, http_code, duration_ms, request, response und curl_error; diese Felder gehören nicht zur öffentlichen API. Die echte TRONENS-Antwort steht im Feld response des Testers.

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": "ERROR_CODE"
}

Authentifizierung

Authorization: Bearer te_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Bearer-Token im Authorization-Header senden. Der Schlüssel wird im Konto erstellt und nur einmal vollständig angezeigt.

Pro Schlüssel sind IP-Whitelist, Limit pro Minute und Ablaufdatum möglich. Antworten enthalten X-RateLimit-Limit und X-RateLimit-Remaining; bei 429 auch Retry-After.

Preis

Gibt den Kundenpreis inklusive Kontorabatt zurück.

GET /api/v1/quote/?package_id=1&duration_minutes=15
GET /api/v1/quote/?energy_amount=65000&duration_minutes=60

Beispielantwort

{
  "success": true,
  "data": {
    "type": "custom",
    "energy_amount": 65000,
    "duration_minutes": 60,
    "base_price_trx": 1.961,
    "discount_percent": 0,
    "discount_trx": 0,
    "price_trx": 2.05
  }
}

Energy-Schätzung

Schätzt den benötigten Energy-Betrag für eine TRON-Empfängeradresse.

{
  "recipient_address": "T...",
  "has_usdt": true
}

Beispielantwort

{
  "success": true,
  "data": {
    "estimated_energy": 65000,
    "recommended_package": {
      "id": 1,
      "name": "65 000 Energy",
      "energy_amount": 65000,
      "duration_minutes": 15
    }
  }
}

Auftrag erstellen

Erstellt einen echten Auftrag und belastet das interne TRX-Guthaben. Die Empfängeradresse muss zuvor im TRON-Netzwerk aktiviert sein. Neue API-Aufträge werden asynchron mit HTTP 202 angenommen. external_id sollte immer verwendet werden; Wiederholung liefert den bestehenden Auftrag ohne zweite Belastung.

{
  "external_id": "merchant_93481",
  "package_id": 1,
  "duration_minutes": 15,
  "address": "T..."
}

Beispielantwort

HTTP 202
{
  "success": true,
  "data": {
    "order_id": 123,
    "external_id": "merchant_93481",
    "status": "processing",
    "idempotent": false
  }
}

Auftragsstatus

Gibt die aktuellen Auftragsdaten und den Status zurück.

GET /api/v1/status/?id=123
GET /api/v1/status/?external_id=merchant_93481

Zeitfelder verwenden YYYY-MM-DD HH:MM:SS in der TRONENS-Serverzeitzone.

Beispielantwort

{
  "success": true,
  "data": {
    "id": 123,
    "external_id": "merchant_93481",
    "address": "T...",
    "energy_amount": 65000,
    "duration_minutes": 15,
    "price_trx": 1.14,
    "status": "delegated",
    "txid": "...",
    "refunded": false,
    "error_code": null,
    "created_at": "2026-10-03 18:01:00",
    "delivered_at": "2026-10-03 18:01:12",
    "completed_at": null,
    "updated_at": "2026-10-03 18:01:12"
  }
}

Status

Guthaben

Aktuell verfügbares TRX-Guthaben des Kontos.

{"success":true,"data":{"balance_trx":125.5}}

Webhook

Webhooks senden Auftragsdaten bei Statusänderungen. Die Signatur anhand des rohen JSON-Bodys und des Webhook-Secrets prüfen.

X-Webhook-Event: order.delegated
X-Webhook-Id: order-123-order.delegated-...
X-Webhook-Signature: sha256=<hex_hmac>

expected = HMAC_SHA256(raw_json_body, webhook_secret)

{
  "event": "order.delegated",
  "event_id": "order-123-order.delegated-...",
  "created_at": "2026-10-03T15:01:12Z",
  "data": {
    "order_id": 123,
    "external_id": "merchant_93481",
    "address": "T...",
    "energy_amount": 65000,
    "duration_minutes": 15,
    "price_trx": 1.14,
    "status": "delegated",
    "txid": "...",
    "refunded": false,
    "error_code": null,
    "created_at": "2026-10-03 18:01:00",
    "delivered_at": "2026-10-03 18:01:12",
    "completed_at": null,
    "updated_at": "2026-10-03 18:01:12"
  }
}

Events: order.processing, order.delegating, order.delegated, order.undelegating, order.completed, order.review, order.failed. HTTP 2xx gilt als erfolgreiche Zustellung; temporäre Fehler werden bis zu 8-mal mit Backoff wiederholt. Nach event_id deduplizieren.

Fehler

error-Codes sind für die programmgesteuerte Verarbeitung gedacht. Verwenden Sie HTTP-Status und das Feld error.