APIエンドポイント - APIドキュメント

ベース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)
• 時刻フィールド: 文字列(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、USDT送金には65000を推奨)
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

アドレスを削除

保存されたアドレスを削除