API Documentation

Integrate Kitron energy rental into your applications

Quick Start

1. Get your API key from the dashboard after signing in

2. Include your credentials in request headers:

# Headers

X-API-Key: your_api_key

X-API-Secret: your_api_secret

Content-Type: application/json

Base URL

https://kitron.tech/api/v1

Account

GET/account

Get account information and balance

Response:

{"email": "user@example.com", "balance_trx": 100.5}

Energy Orders

POST/orders

Create a new energy rental order

Request body:

{"wallet_address": "TXxxx...", "energy_amount": 65000, "duration_hours": 1}

Response:

{"id": 123, "status": "pending", "total_trx": 2.5}

GET/orders/:id

Get order status and details

Calculator

POST/calculator/estimate

Estimate cost for energy rental

Request body:

{"energy_amount": 65000, "duration_hours": 1}

Response:

{"best_price_sun": 30, "total_trx": 2.145}

Webhooks

Receive real-time notifications when events occur. Configure webhooks in your dashboard.

Available Events

order.created - New order placed

order.completed - Energy delegated

order.failed - Order failed

deposit.received - TRX/USDT received

Webhook Payload Example

{  "event": "order.completed",  "timestamp": "2026-01-08T12:30:00Z",  "data": {    "order_id": 123,    "wallet_address": "TXxxx...",    "energy_amount": 65000,    "duration_hours": 1,    "total_trx": 2.09,    "tx_hash": "abc123...",    "expires_at": "2026-01-08T13:30:00Z"  }}

Signature Verification

Each webhook includes a signature header for verification:

# Header

X-Kitron-Signature: sha256=abc123...

Verify by computing HMAC-SHA256 of the raw request body using your webhook secret.

Need Help?

Contact on Telegram