Endpoint API - Dokumentasi API

URL Dasar

Produksi: https://api.usdtlowfee.com

Konvensi Umum

Unit

• sun: 1 TRX = 1.000.000 sun (semua field jumlah menggunakan sun)
• energyValue: unit energi (angka int64)
• durationHours: jam (angka int)

Tipe Data

• Field ID: angka int64 (snowflake ID)
• Field jumlah: angka int64 (suffix *Sun, contoh: balanceSun, priceSun)
• Field waktu: string (format ISO8601 UTC, contoh: "2025-01-15T10:30:00Z")
• Field boolean: true/false

Format Respons

• Sukses: { "data": {...}, "meta": {...} } (meta opsional)
• Error: { "error": { "code": "...", "message": "..." } }

Manajemen Akun

Query saldo dompet dan informasi pengguna

GET /v1/wallet/balance

Ambil Saldo

Ambil saldo dompet saat ini

Contoh respons:

{
  "data": {
    "balanceSun": 1000000,
    "frozenSun": 0,
    "totalSun": 1000000
  }
}

GET /v1/users/me

Informasi Pengguna

Ambil informasi dasar pengguna saat ini

Contoh respons:

{
  "data": {
    "id": 123456,
    "email": "user@example.com",
    "emailVerified": true,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

Manajemen Pesanan

Buat dan query pesanan energi

POST /v1/energy/orders

Buat Pesanan

Buat pesanan sewa energi untuk alamat yang ditentukan (saat ini hanya mendukung tipe manual)

Parameter permintaan:

Parameter	Tipe	Wajib	Deskripsi
type	string	Ya	Tipe pesanan, saat ini hanya mendukung "manual"
data.tronAddress	string	Ya	Alamat TRON penerima energi (34 karakter, dimulai dengan T)
data.energyValue	int64	Ya	Jumlah energi (angka, minimum 32000, disarankan 65000 untuk transfer USDT)
data.durationHours	int	Ya	Durasi sewa (jam, nilai valid: 1, 24, 72, 168, 336, 720)

Contoh permintaan:

{
  "type": "manual",
  "data": {
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1
  }
}

Contoh respons:

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "processing",
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-15T10:30:00Z",
    "statusUpdatedAt": "2025-01-15T10:30:00Z",
    "canTransitionTo": ["completed", "failed"]
  }
}

GET /v1/energy/orders/:id

Ambil Pesanan

Query detail pesanan berdasarkan ID pesanan

Contoh respons:

{
  "data": {
    "id": 1234567890,
    "userId": 9876543210,
    "tronAddress": "TYour1Address2Here3...",
    "energyValue": 65000,
    "durationHours": 1,
    "priceSun": 3000000,
    "priceTrx": 3.0,
    "orderType": "manual",
    "status": "completed",
    "txid": "abc123...",
    "createdAt": "2025-01-15T10:30:00Z",
    "completedAt": "2025-01-15T10:30:05Z",
    "updatedAt": "2025-01-15T10:30:05Z",
    "statusUpdatedAt": "2025-01-15T10:30:05Z",
    "canTransitionTo": []
  }
}

GET /v1/energy/orders

Daftar Pesanan

Query daftar pesanan (mendukung pagination dan filter)

Parameter permintaan:

Parameter	Tipe	Wajib	Deskripsi
offset	number	Tidak	Offset, default 0
limit	number	Tidak	Jumlah item per halaman, default 20, maksimum 100
status	string	Tidak	Filter berdasarkan status pesanan: processing, completed, failed

Contoh respons:

{
  "data": {
    "orders": [
      {
        "id": 1234567890,
        "userId": 9876543210,
        "tronAddress": "TYour1...",
        "energyValue": 65000,
        "durationHours": 1,
        "priceSun": 3000000,
        "priceTrx": 3.0,
        "orderType": "manual",
        "status": "completed",
        "createdAt": "2025-01-15T10:30:00Z",
        "updatedAt": "2025-01-15T10:30:05Z",
        "statusUpdatedAt": "2025-01-15T10:30:05Z",
        "canTransitionTo": []
      }
    ],
    "total": 100,
    "offset": 0,
    "limit": 20
  }
}

Manajemen Alamat

Kelola alamat penerima yang sering digunakan

POST /v1/addresses

Tambah Alamat

Simpan alamat baru

Contoh permintaan:

{
  "tronAddress": "TYour1Address2Here3...",
  "label": "Dompet Utama",
  "isDefault": false
}

Contoh respons:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Dompet Utama",
    "isDefault": false,
    "usageCount": 0,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

GET /v1/addresses

Daftar Alamat

Ambil daftar alamat yang disimpan

Contoh respons:

{
  "data": {
    "addresses": [
      {
        "id": 1,
        "tronAddress": "TYour1Address2Here3...",
        "label": "Dompet Utama",
        "isDefault": true,
        "usageCount": 5,
        "lastUsedAt": "2025-01-15T10:30:00Z",
        "createdAt": "2025-01-01T00:00:00Z"
      }
    ],
    "total": 1
  }
}

GET /v1/addresses/:id

Ambil Detail Alamat

Query informasi satu alamat

Contoh respons:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Dompet Utama",
    "isDefault": true,
    "usageCount": 5,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/label

Perbarui Label Alamat

Ubah label dari satu alamat

Contoh permintaan:

{
  "label": "Label Baru"
}

Contoh respons:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Label Baru",
    "isDefault": false,
    "usageCount": 3,
    "lastUsedAt": "2025-01-15T10:30:00Z",
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

PUT /v1/addresses/:id/default

Setel Alamat Default

Setel alamat yang ditentukan sebagai alamat penerima default

Contoh respons:

// HTTP 204 No Content
// Tidak ada konten respons

Mengembalikan status code 204 tanpa konten saat berhasil.

DELETE /v1/addresses/:id

Hapus Alamat

Hapus satu alamat yang disimpan