API Uç Noktaları - API Dokümantasyonu

Temel URL

Üretim: https://api.usdtlowfee.com

Genel Kurallar

Birimler

• sun: 1 TRX = 1.000.000 sun (tüm değer alanları sun kullanır)
• energyValue: enerji birimi (int64 sayı)
• durationHours: saat (int sayı)

Veri Türleri

• ID alanları: int64 sayı (snowflake ID)
• Değer alanları: int64 sayı (*Sun son eki, örneğin: balanceSun, priceSun)
• Zaman alanları: string (ISO8601 UTC formatı, örneğin: "2025-01-15T10:30:00Z")
• Boolean alanları: true/false

Yanıt Formatı

• Başarı: { "data": {...}, "meta": {...} } (meta isteğe bağlı)
• Hata: { "error": { "code": "...", "message": "..." } }

Hesap Yönetimi

Cüzdan bakiyesi ve kullanıcı bilgilerini sorgulama

GET /v1/wallet/balance

Bakiye Sorgulama

Mevcut cüzdan bakiyesini sorgulama

Yanıt örneği:

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

GET /v1/users/me

Kullanıcı Bilgileri

Mevcut kullanıcının temel bilgilerini sorgulama

Yanıt örneği:

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

Sipariş Yönetimi

Enerji siparişlerini oluşturma ve sorgulama

POST /v1/energy/orders

Sipariş Oluşturma

Belirtilen bir adres için enerji kiralama siparişi oluşturma (şu anda yalnızca manuel türü destekler)

İstek parametreleri:

Parametre	Tür	Gerekli	Açıklama
type	string	Evet	Sipariş türü, şu anda yalnızca "manual" desteklenir
data.tronAddress	string	Evet	Enerjiyi alacak TRON adresi (34 karakter, T ile başlar)
data.energyValue	int64	Evet	Enerji miktarı (sayı, minimum 32000, USDT transferi için 65000 önerilir)
data.durationHours	int	Evet	Kiralama süresi (saat, geçerli değerler: 1, 24, 72, 168, 336, 720)

İstek örneği:

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

Yanıt örneği:

{
  "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

Sipariş Sorgulama

ID'ye göre sipariş detaylarını sorgulama

Yanıt örneği:

{
  "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

Sipariş Listesi

Sipariş listesini sorgulama (sayfalama ve filtreleri destekler)

İstek parametreleri:

Parametre	Tür	Gerekli	Açıklama
offset	number	Hayır	Başlangıç noktası, varsayılan 0
limit	number	Hayır	Sayfa başına öğe sayısı, varsayılan 20, maksimum 100
status	string	Hayır	Sipariş durumuna göre filtrele: processing, completed, failed

Yanıt örneği:

{
  "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
  }
}

Adres Yönetimi

Sık kullanılan alıcı adreslerini yönetme

POST /v1/addresses

Adres Ekleme

Yeni bir adres kaydetme

İstek örneği:

{
  "tronAddress": "TYour1Address2Here3...",
  "label": "Ana Cüzdan",
  "isDefault": false
}

Yanıt örneği:

{
  "data": {
    "id": 1,
    "tronAddress": "TYour1Address2Here3...",
    "label": "Ana Cüzdan",
    "isDefault": false,
    "usageCount": 0,
    "createdAt": "2025-01-01T00:00:00Z"
  }
}

GET /v1/addresses

Adres Listesi

Kayıtlı adreslerin listesini alma

Yanıt örneği:

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

GET /v1/addresses/:id

Adres Detayları

Bir adresin bilgilerini sorgulama

Yanıt örneği:

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

PUT /v1/addresses/:id/label

Adres Etiketini Güncelleme

Bir adresin etiketini değiştirme

İstek örneği:

{
  "label": "Yeni Etiket"
}

Yanıt örneği:

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

PUT /v1/addresses/:id/default

Varsayılan Adres Ayarlama

Belirtilen adresi varsayılan alıcı adresi olarak ayarlama

Yanıt örneği:

// HTTP 204 No Content
// Yanıt içeriği yok

Başarılı olduğunda içerik olmadan 204 durum kodu döner.

DELETE /v1/addresses/:id

Adres Silme

Kayıtlı bir adresi silme