API Endpoints - API Documentation

Base URL

Production: https://api.usdtlowfee.com

General Conventions

Units

• sun: 1 TRX = 1,000,000 sun (all amount fields use sun)
• energyValue: energy unit (int64 number)
• durationHours: hours (int number)

Data Types

• ID fields: int64 number (snowflake ID)
• Amount fields: int64 number (*Sun suffix, e.g., balanceSun, priceSun)
• Time fields: string (ISO8601 UTC format, e.g., "2025-01-15T10:30:00Z")
• Boolean fields: true/false

Response Format

• Success: { "data": {...}, "meta": {...} } (meta optional)
• Error: { "error": { "code": "...", "message": "..." } }

Account Management

Query wallet balance and user information

GET /v1/wallet/balance

Get Balance

Get current wallet balance

Response Example:

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

GET /v1/users/me

User Info

Get current user basic information

Response Example:

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

Order Management

Create and query energy orders

POST /v1/energy/orders

Create Order

Create energy rental order for a specified address (currently supports manual type only)

Request Parameters:

Parameter	Type	Required	Description
type	string	Yes	Order type, currently only supports "manual"
data.tronAddress	string	Yes	TRON address to receive energy (34 characters, starts with T)
data.energyValue	int64	Yes	Energy amount (number, minimum 32000, recommended 65000 for USDT transfers)
data.durationHours	int	Yes	Rental duration (hours, valid values: 1, 24, 72, 168, 336, 720)

Request Example:

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

Response Example:

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

Get Order

Query order details by order ID

Response Example:

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

List Orders

Query order list (supports pagination and filtering)

Request Parameters:

Parameter	Type	Required	Description
offset	number	No	Offset, default 0
limit	number	No	Items per page, default 20, maximum 100
status	string	No	Filter by order status: processing, completed, failed

Response Example:

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

Address Management

Manage frequently used receiving addresses

POST /v1/addresses

Add Address

Save a new address

Request Example:

{
  "tronAddress": "TYour1Address2Here3...",
  "label": "Main Wallet",
  "isDefault": false
}

Response Example:

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

GET /v1/addresses

List Addresses

Get saved address list

Response Example:

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

GET /v1/addresses/:id

Get Address Details

Query single address information

Response Example:

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

PUT /v1/addresses/:id/label

Update Address Label

Modify the label of an address

Request Example:

{
  "label": "New Label"
}

Response Example:

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

PUT /v1/addresses/:id/default

Set Default Address

Set specified address as default receiving address

Response Example:

// HTTP 204 No Content
// No response body

Returns status code 204 with no content on success.

DELETE /v1/addresses/:id

Delete Address

Delete a saved address