API 接口一览
所有可用的 API 端点
Base URL
生产环境：
https://api.usdtlowfee.com 通用约定
单位
- • sun: 1 TRX = 1,000,000 sun（所有金额字段使用 sun）
- • energyValue: 能量单位（int64 数字）
- • durationHours: 小时（int 数字）
数据类型
- • ID 字段: int64 数字（snowflake ID）
- • 金额字段: int64 数字（*Sun 后缀，如 balanceSun, priceSun）
- • 时间字段: string (ISO8601 UTC 格式，如 "2025-01-15T10:30:00Z")
- • 布尔字段: true/false
响应格式
- • 成功: { "data": {...}, "meta": {...} }（meta 可选）
- • 失败: { "error": { "code": "...", "message": "..." } }
账户管理
查询钱包余额和用户信息
GET
/v1/wallet/balance 查询余额
获取当前钱包余额
响应示例：
{
"data": {
"balanceSun": 1000000,
"frozenSun": 0,
"totalSun": 1000000
}
} GET
/v1/users/me 用户信息
获取当前用户基本信息
响应示例：
{
"data": {
"id": 123456,
"email": "user@example.com",
"emailVerified": true,
"createdAt": "2025-01-01T00:00:00Z"
}
}订单管理
创建和查询能量订单
POST
/v1/energy/orders 创建订单
为指定地址创建能量租赁订单（目前仅支持 manual 类型）
请求参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 订单类型，目前仅支持 "manual" |
| data.tronAddress | string | 是 | 接收能量的 TRON 地址（34位，T开头） |
| data.energyValue | int64 | 是 | 能量数量（数字，最小 32000，推荐 65000 用于 USDT 转账） |
| data.durationHours | int | 是 | 租赁时长（小时数，可选值：1, 24, 72, 168, 336, 720） |
请求示例：
{
"type": "manual",
"data": {
"tronAddress": "TYour1Address2Here3...",
"energyValue": 65000,
"durationHours": 1
}
}响应示例：
{
"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 查询订单
根据订单 ID 查询订单详情
响应示例：
{
"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 订单列表
查询订单列表（支持分页和筛选）
请求参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| offset | number | 否 | 偏移量，默认 0 |
| limit | number | 否 | 每页数量，默认 20，最大 100 |
| status | string | 否 | 订单状态筛选：processing, completed, failed |
响应示例：
{
"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
}
}地址管理
管理常用收款地址
POST
/v1/addresses 添加地址
保存新地址
请求示例：
{
"tronAddress": "TYour1Address2Here3...",
"label": "主钱包",
"isDefault": false
}响应示例：
{
"data": {
"id": 1,
"tronAddress": "TYour1Address2Here3...",
"label": "主钱包",
"isDefault": false,
"usageCount": 0,
"createdAt": "2025-01-01T00:00:00Z"
}
} GET
/v1/addresses 地址列表
获取保存的地址列表
响应示例：
{
"data": {
"addresses": [
{
"id": 1,
"tronAddress": "TYour1Address2Here3...",
"label": "主钱包",
"isDefault": true,
"usageCount": 5,
"lastUsedAt": "2025-01-15T10:30:00Z",
"createdAt": "2025-01-01T00:00:00Z"
}
],
"total": 1
}
} GET
/v1/addresses/:id 获取地址详情
查询单个地址信息
响应示例：
{
"data": {
"id": 1,
"tronAddress": "TYour1Address2Here3...",
"label": "主钱包",
"isDefault": true,
"usageCount": 5,
"lastUsedAt": "2025-01-15T10:30:00Z",
"createdAt": "2025-01-01T00:00:00Z"
}
} PUT
/v1/addresses/:id/label 更新地址标签
修改地址的备注标签
请求示例：
{
"label": "新标签"
}响应示例：
{
"data": {
"id": 1,
"tronAddress": "TYour1Address2Here3...",
"label": "新标签",
"isDefault": false,
"usageCount": 3,
"lastUsedAt": "2025-01-15T10:30:00Z",
"createdAt": "2025-01-01T00:00:00Z"
}
} PUT
/v1/addresses/:id/default 设置默认地址
将指定地址设为默认收款地址
响应示例：
// HTTP 204 No Content
// 无响应体
成功时返回状态码 204，无响应内容。 DELETE
/v1/addresses/:id 删除地址
删除保存的地址