DUIYA DEVELOPERS / API V2

把能量服務
接入你的應用

兌呀 API 對接文件。查詢餘額、租賃能量、管理託管地址，
從開戶到第一次請求，都在這裡。

諮詢開戶 @wanglei 下載 OpenAPI

duiya.org / api

GET/user_info

balance_trx TRX 餘額

balance_usdt USDT 餘額

API V2 2.1.0介面參考 25 ENDPOINTS

01 / GET STARTED

先開戶，再開始對接

請先透過 Telegram 聯絡 @wanglei 諮詢開戶後臺。

開通後，使用客服提供的後臺地址登入，確認賬戶充值方式、可用餘額、介面許可權與當前報價，再進行接入。

登入開戶後臺進入「API 使用者設定」，檢視賬戶資訊及充值後可用餘額。
新增 IP 白名單填寫呼叫 API 的伺服器出口公網 IP；伺服器或出口 IP 變更後，同步更新白名單。
開啟 API 呼叫狀態儲存設定，並確認所需業務許可權已開通。
獲取 API Key 與 API Secret按下方簽名規則在服務端呼叫介面，先使用餘額查詢確認配置。

IP 白名單維護及充值操作在開戶後臺完成。當前公開 V2 定義未提供新增白名單或查詢充值流水的 API；/user_info 返回的是當前可用餘額。

02 / AUTHENTICATION

三個請求頭，一次簽名

所有介面均使用 API Key / 簽名認證。API Secret 僅用於服務端計算簽名，不作為請求引數傳送。

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

HMAC-SHA256(API Secret, API Key + timestamp)

API Key 與時間戳直接拼接，無分隔符；輸出小寫十六進位制。時間戳單位為秒，須在伺服器時間 ±5 分鐘內。

Node.js：生成簽名並查詢餘額

Node.js · 服務端示例

import { createHmac } from 'node:crypto';

// 在服务端环境变量中配置，勿放入网页前端。
const apiKey = process.env.DUIYA_API_KEY;
const apiSecret = process.env.DUIYA_API_SECRET;
if (!apiKey || !apiSecret) throw new Error('请先配置 API Key 和 API Secret');

const timestamp = Math.floor(Date.now() / 1000).toString();
const signature = createHmac('sha256', apiSecret)
  .update(apiKey + timestamp)
  .digest('hex');

// 只查询余额；每次请求重新生成时间戳和签名。
const response = await fetch('https://weidubot.cc/api/v2/user_info', {
  method: 'GET',
  headers: {
    'x-api-key': apiKey,
    'x-timestamp': timestamp,
    'x-signature': signature
  }
});
const result = await response.json();
if (!response.ok || result.code !== 1) {
  throw new Error(result.msg || '余额查询失败');
}
console.log(result.data.balance_trx, result.data.balance_usdt);

請將金鑰放在服務端環境變數中。請求頭中的時間戳必須與生成簽名時使用的時間戳一致。

03 / ACCOUNT BALANCE

查詢充值後的可用餘額

GEThttps://weidubot.cc/api/v2/user_info

此介面無需業務查詢引數，攜帶三個認證請求頭即可。讀取 data.balance_trx 與 data.balance_usdt，兩者均為格式化字串。

JSON · 結構示例，非真實餘額

{
  "code": 1,
  "msg": "操作成功",
  "time": "1711961879",
  "data": {
    "balance_trx": "100.5000",
    "balance_usdt": "500.0000"
  }
}

餘額充值、後臺入口或白名單設定遇到問題，聯絡 @wanglei 。完整返回欄位見 /user_info。

04 / REQUEST FORMAT

按介面指定的方法傳參

本站文件地址: https://duiya.org/api/
API 基礎地址: https://weidubot.cc/api/v2
購買能量路徑: /buy_energy
最終請求地址: https://weidubot.cc/api/v2/buy_energy

GET 介面的查詢引數放在 URL 中；POST 介面按本頁定義使用表單或查詢引數。購買能量使用 POST，不能統一改為 GET。認證資訊始終放在請求頭。

特別說明：/query_fast_recover_price 使用 POST，但其 resource_type 和 count 在當前定義中位於 URL 查詢引數。

購買 1 小時能量的請求格式

cURL · 替換全部佔位符後使用

curl --request POST 'https://weidubot.cc/api/v2/buy_energy' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-timestamp: CURRENT_UNIX_SECONDS' \
  --header 'x-signature: HMAC_SHA256_HEX' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'count=65000' \
  --data-urlencode 'period=1h' \
  --data-urlencode 'address=YOUR_TRON_ADDRESS'

此示例會產生付費訂單，使用前先透過 /query_price 查詢價格，核對地址、數量、時長和餘額。非同步訂單提交成功後，透過 /query_result 查詢執行結果。

duiya.org 提供文件頁面；當前 API 請求傳送至上述服務地址。示例中的價格、餘額和數量僅用於說明結構，不代表實時報價。

05 / ENERGY SERVICES

找到適合業務的介面

01 / FAST RECOVER

能量速充

查詢速充價格，再購買能量或頻寬並跟進訂單。

/query_fast_recover_price/buy_fast_recover/query_fast_recover_order

02 / SMART DELEGATION

智慧託管

查詢託管價格、委託額度、管理地址與使用記錄。

/get_smart_price/delegate_energy_smart/query_energy_smart

03 / ENERGY RENTAL

時長租賃

按能量數量與週期報價，下單後查詢執行結果。

/query_price/buy_energy/query_result

API 筆數、賬戶啟用、地址歸集及 Fragment 服務也收錄在完整參考中，可用許可權與收費以開戶後臺及介面實際返回為準。

06 / ENDPOINT REFERENCE

完整介面參考 25

點選介面展開請求引數、返回欄位和完整定義。型別名稱可跳轉至資料模型。

查詢介面

顯示全部 25 個介面

賬戶管理

使用者資訊查詢與賬戶啟用。

POST/active_account啟用 TRON 地址

啟用 TRON 地址

提交一個啟用 TRON 地址的請求。會從賬戶扣除相應費用。

完整請求地址：https://weidubot.cc/api/v2/active_account

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`address`	string必填	需要啟用的 TRON 地址示例：`"TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"`

響應說明

HTTP 200啟用請求已提交。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	ActivationData未標記必填	賬戶啟用請求提交後的響應資料。

HTTP 400請求錯誤 (例如：地址格式無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權 (認證失敗)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 403禁止訪問 (例如：餘額不足)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "账户管理 (Account Management)"
  ],
  "summary": "激活 TRON 地址",
  "description": "提交一个激活 TRON 地址的请求。会从账户扣除相应费用。",
  "operationId": "activeAccountV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "需要激活的 TRON 地址",
              "example": "TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "激活请求已提交。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ActivationData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (例如：地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权 (认证失败)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (例如：余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/user_info獲取使用者資訊

獲取使用者資訊

獲取當前認證使用者的基本資訊，例如餘額。

完整請求地址：https://weidubot.cc/api/v2/user_info

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

響應說明

HTTP 200成功獲取使用者資訊。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	UserInfoData未標記必填	使用者資訊查詢結果。

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "账户管理 (Account Management)"
  ],
  "summary": "获取用户信息",
  "description": "获取当前认证用户的基本信息，例如余额。",
  "operationId": "getUserInfoV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取用户信息。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/UserInfoData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

資源訂單

TRON 能量和頻寬時長購買、訂單查詢與管理。

POST/buy_energy購買能量時長

購買能量時長

提交一個非同步訂單，為指定地址在給定週期內委託能量。

完整請求地址：https://weidubot.cc/api/v2/buy_energy

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`count`	integer必填	委託的能量點數 (最低 30000) 示例：`50000`
`period`	string必填	週期名稱 (例如"15minutes","1h", "1day", "3day") 示例：`"1day"`
`address`	string必填	接收能量的 TRON 地址示例：`"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

響應說明

HTTP 200訂單已成功提交。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	EnergyOrderResponseData未標記必填	能量訂單提交成功後的響應資料。

HTTP 400請求錯誤 (引數無效、地址未啟用等)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 403禁止訪問 (餘額不足、使用者狀態異常)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "购买能量时长",
  "description": "提交一个异步订单，为指定地址在给定周期内委托能量。",
  "operationId": "buyEnergyV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "count": {
              "type": "integer",
              "description": "委托的能量点数 (最低 30000)",
              "example": 50000
            },
            "period": {
              "type": "string",
              "description": "周期名称 (例如\"15minutes\",\"1h\", \"1day\", \"3day\")",
              "example": "1day"
            },
            "address": {
              "type": "string",
              "description": "接收能量的 TRON 地址",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "count",
            "period",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单已成功提交。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效、地址未激活等)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (余额不足、用户状态异常)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/buy_net購買頻寬時長

購買頻寬時長

提交一個非同步訂單，為指定地址在給定週期內委託頻寬。

完整請求地址：https://weidubot.cc/api/v2/buy_net

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`count`	integer必填	委託的頻寬位元組數 (最低 100) 示例：`5000`
`period`	string必填	週期名稱 (例如 "1day", "3day") 示例：`"3day"`
`address`	string必填	接收頻寬的 TRON 地址示例：`"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

響應說明

HTTP 200訂單已成功提交。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	NetOrderResponseData未標記必填	頻寬訂單提交成功後的響應資料。

HTTP 400請求錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 403禁止訪問

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "购买带宽时长",
  "description": "提交一个异步订单，为指定地址在给定周期内委托带宽。",
  "operationId": "buyNetV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "count": {
              "type": "integer",
              "description": "委托的带宽字节数 (最低 100)",
              "example": 5000
            },
            "period": {
              "type": "string",
              "description": "周期名称 (例如 \"1day\", \"3day\")",
              "example": "3day"
            },
            "address": {
              "type": "string",
              "description": "接收带宽的 TRON 地址",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "count",
            "period",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单已成功提交。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/NetOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/reclaim_energy主動回收能量

主動回收能量

根據已完成的訂單號和目標地址，發起回收（取消委託）對應資源的請求。這是一個非同步操作。

完整請求地址：https://weidubot.cc/api/v2/reclaim_energy

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`order_sn`	string必填	原始委託訂單的序列號示例：`"EN2025040217175512345"`
`address`	string必填	原始接收委託資源的地址示例：`"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

響應說明

HTTP 200回收請求已成功提交。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	具體的響應資料負載。允許 null

HTTP 400請求錯誤 (訂單號或地址格式無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (訂單號不存在、不屬於該使用者，或未找到匹配的可回收資源)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "主动回收能量",
  "description": "根据已完成的订单号和目标地址，发起回收（取消委托）对应资源的请求。这是一个异步操作。",
  "operationId": "reclaimEnergyV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "order_sn": {
              "type": "string",
              "description": "原始委托订单的序列号",
              "example": "EN2025040217175512345"
            },
            "address": {
              "type": "string",
              "description": "原始接收委托资源的地址",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "order_sn",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "回收请求已成功提交。",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BaseResponse"
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单号或地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单号不存在、不属于该用户，或未找到匹配的可回收资源)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_result查詢訂單結果

查詢訂單結果

獲取指定資源訂單的處理狀態和詳細資訊。

完整請求地址：https://weidubot.cc/api/v2/query_result

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`order_sn`必填	query string	要查詢的訂單的唯一序列號示例：`"EN2025040217175512345"`

響應說明

HTTP 200成功獲取訂單詳情。data 結構根據訂單狀態可能是成功詳情或失敗資訊。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	QueryResultDataSuccess 或 QueryResultDataFailed未標記必填

HTTP 400請求錯誤 (訂單號格式無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (訂單號不存在或不屬於該使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤或查詢異常

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "查询订单结果",
  "description": "获取指定资源订单的处理状态和详细信息。",
  "operationId": "queryResultV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_sn",
      "in": "query",
      "required": true,
      "description": "要查询的订单的唯一序列号",
      "schema": {
        "type": "string",
        "example": "EN2025040217175512345"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取订单详情。data 结构根据订单状态可能是成功详情或失败信息。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "oneOf": [
                      {
                        "$ref": "#/components/schemas/QueryResultDataSuccess"
                      },
                      {
                        "$ref": "#/components/schemas/QueryResultDataFailed"
                      }
                    ]
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单号格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单号不存在或不属于该用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误或查询异常",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_price查詢資源價格

查詢資源價格

根據資源型別（僅支援 energy 或 net）、數量和週期，計算預估的訂購價格。

完整請求地址：https://weidubot.cc/api/v2/query_price

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`type`必填	query string	資源型別 ("energy", "net") 列舉：`"energy"` / `"net"` 示例：`"energy"`
`count`必填	query integer	資源數量 (能量點數或頻寬位元組數) 示例：`50000`
`period`必填	query string	週期名稱 (例如 "15minutes","1h", "1day", "3day") 示例：`"1day"`

響應說明

HTTP 200成功計算價格。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	ResourcePriceData未標記必填	資源價格查詢結果。

HTTP 400請求錯誤 (引數無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (指定資源的價格未配置或不可用)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "资源订单 (Energy/Bandwidth Orders)"
  ],
  "summary": "查询资源价格",
  "description": "根据资源类型（仅支持 energy 或 net）、数量和周期，计算预估的订购价格。",
  "operationId": "queryPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "type",
      "in": "query",
      "required": true,
      "description": "资源类型 (\"energy\", \"net\")",
      "schema": {
        "type": "string",
        "enum": [
          "energy",
          "net"
        ],
        "example": "energy"
      }
    },
    {
      "name": "count",
      "in": "query",
      "required": true,
      "description": "资源数量 (能量点数或带宽字节数)",
      "schema": {
        "type": "integer",
        "example": 50000
      }
    },
    {
      "name": "period",
      "in": "query",
      "required": true,
      "description": "周期名称 (例如 \"15minutes\",\"1h\", \"1day\", \"3day\")",
      "schema": {
        "type": "string",
        "example": "1day"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功计算价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ResourcePriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (指定资源的价格未配置或不可用)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

能量速充

能量/頻寬快速補充服務。

POST/query_fast_recover_price查詢能量/頻寬速充價格

查詢能量/頻寬速充價格

查詢速衝價格

完整請求地址：https://weidubot.cc/api/v2/query_fast_recover_price

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`resource_type`必填	query string	資源型別 ("energy", "net") 列舉：`"energy"` / `"net"` 示例：`"energy"`
`count`必填	query integer	資源數量 (能量數或頻寬數) 示例：`100000`

響應說明

HTTP 200成功計算價格。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	FastRecoverPriceData未標記必填	速衝價格查詢結果

HTTP 400請求錯誤 (引數無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (指定資源的價格未配置或不可用)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量速充 (Fast Recover)"
  ],
  "summary": "查询能量/带宽速充价格",
  "description": "查询速冲价格",
  "operationId": "queryFastRecoverPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "resource_type",
      "in": "query",
      "required": true,
      "description": "资源类型 (\"energy\", \"net\")",
      "schema": {
        "type": "string",
        "enum": [
          "energy",
          "net"
        ],
        "example": "energy"
      }
    },
    {
      "name": "count",
      "in": "query",
      "required": true,
      "description": "资源数量 (能量数或带宽数)",
      "schema": {
        "type": "integer",
        "example": 100000
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功计算价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/FastRecoverPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (指定资源的价格未配置或不可用)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/buy_fast_recover能量/頻寬速充

能量/頻寬速充

為指定地址快速補充一次性的能量或頻寬。

完整請求地址：https://weidubot.cc/api/v2/buy_fast_recover

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`address`	string必填	接收資源的 TRON 地址示例：`"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer必填	需要補充的能量或頻寬數量示例：`65000`
`resource_type`	string必填	資源型別列舉：`"energy"` / `"net"` 示例：`"energy"`

響應說明

HTTP 200速充請求已提交，請稍後查詢狀態。

application/json · 點選型別名稱檢視完整欄位

欄位型別 / 必填說明與約束

code

integer必填

狀態碼，1 表示成功，0 表示失敗。

列舉：1
示例：1

msg

string必填

響應訊息文字。

示例："操作成功"

time

string必填

伺服器響應時間戳。

示例："1711961879"

data

object未標記必填

子欄位	型別 / 必填	說明與約束
`order_id`	integer未標記必填	速充訂單ID

HTTP 400請求錯誤 (引數無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 403禁止訪問 (例如餘額不足)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量速充 (Fast Recover)"
  ],
  "summary": "能量/带宽速充",
  "description": "为指定地址快速补充一次性的能量或带宽。",
  "operationId": "buyFastRecoverV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/FastRecoverOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "速充请求已提交，请稍后查询状态。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "type": "object",
                    "properties": {
                      "order_id": {
                        "type": "integer",
                        "description": "速充订单ID"
                      }
                    }
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (例如余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_fast_recover_order查詢速充訂單狀態

查詢速充訂單狀態

獲取指定速充訂單的處理狀態和詳情。

完整請求地址：https://weidubot.cc/api/v2/query_fast_recover_order

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`order_id`必填	query integer	要查詢的速充訂單 ID 示例：`123`

響應說明

HTTP 200查詢成功。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	FastRecoverOrderResponseData未標記必填	速充訂單查詢結果資料。

HTTP 400請求錯誤 (訂單 ID 無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (訂單 ID 不存在或不屬於當前使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量速充 (Fast Recover)"
  ],
  "summary": "查询速充订单状态",
  "description": "获取指定速充订单的处理状态和详情。",
  "operationId": "queryFastRecoverOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": "要查询的速充订单 ID",
      "schema": {
        "type": "integer",
        "example": 123
      }
    }
  ],
  "responses": {
    "200": {
      "description": "查询成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/FastRecoverOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单 ID 无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单 ID 不存在或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

智慧託管

智慧能量託管服務的相關操作。

GET/get_smart_price獲取智慧託管價格

獲取智慧託管價格

獲取當前 65K 和 131K 智慧能量委託的價格。

完整請求地址：https://weidubot.cc/api/v2/get_smart_price

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

響應說明

HTTP 200成功獲取價格。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	SmartPriceData未標記必填	智慧託管服務的價格資訊。

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (無法獲取部分或全部價格資訊)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "获取智能托管价格",
  "description": "获取当前 65K 和 131K 智能能量委托的价格。",
  "operationId": "getSmartPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/SmartPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (无法获取部分或全部价格信息)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/delegate_energy_smart委託智慧託管額度

委託智慧託管額度

為指定地址增加智慧能量託管服務的可用額度（餘額）。

完整請求地址：https://weidubot.cc/api/v2/delegate_energy_smart

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`address`	string必填	要增加額度的 TRON 地址示例：`"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`balance`	number · float必填	要增加的額度數量 (例如 TRX 數量，必須為正數) 示例：`10.5`
`channel`	string未標記必填	能量通道：normal->普通模式，high_frequency->高頻模式,jisu_frequency->極速模式,guangsu_frequency->光速模式列舉：`"normal"` / `"high_frequency"` / `"jisu_frequency"` / `"guangsu_frequency"` 示例：`"high_frequency"`
`hf_deposit`	number未標記必填	高頻押金：-1：跟隨系統押金設定 0:不扣押金其他金額:扣除相應押金示例：`"0"`
`net_protect`	string未標記必填	地址的頻寬保護模式列舉：`"open"` / `"close"` 示例：`"open"`

響應說明

HTTP 200委託/額度增加成功

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	EnergySmartDelegateResponseData未標記必填	智慧託管委託成功後的響應資料。

HTTP 400請求錯誤 (地址或額度值無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 429請求過於頻繁 (如果實現了鎖)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "委托智能托管额度",
  "description": "为指定地址增加智能能量托管服务的可用额度（余额）。",
  "operationId": "delegateEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要增加额度的 TRON 地址",
              "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
            },
            "balance": {
              "type": "number",
              "format": "float",
              "description": "要增加的额度数量 (例如 TRX 数量，必须为正数)",
              "example": 10.5
            },
            "channel": {
              "type": "string",
              "description": "能量通道：normal->普通模式，high_frequency->高频模式,jisu_frequency->极速模式,guangsu_frequency->光速模式",
              "enum": [
                "normal",
                "high_frequency",
                "jisu_frequency",
                "guangsu_frequency"
              ],
              "example": "high_frequency"
            },
            "hf_deposit": {
              "type": "number",
              "description": "高频押金：-1：跟随系统押金设置   0:不扣押金     其他金额:扣除相应押金",
              "example": "0"
            },
            "net_protect": {
              "type": "string",
              "description": "地址的带宽保护模式",
              "enum": [
                "open",
                "close"
              ],
              "example": "open"
            }
          },
          "required": [
            "address",
            "balance"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "委托/额度增加成功",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartDelegateResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址或额度值无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_energy_smart查詢智慧託管狀態

查詢智慧託管狀態

獲取指定地址的智慧能量託管服務的剩餘額度（餘額）、服務狀態以及消耗記錄（分頁）。

完整請求地址：https://weidubot.cc/api/v2/query_energy_smart

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`address`必填	query string	要查詢的 TRON 地址示例：`"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`page`必填	query integer	查詢的頁碼 (從1開始) 最小值：`1` 示例：`1`

響應說明

HTTP 200查詢成功。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	EnergySmartQueryResponseData未標記必填	智慧託管服務的地址查詢結果。

HTTP 400請求錯誤 (地址格式或頁碼無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (該地址未開通此服務或不屬於當前使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "查询智能托管状态",
  "description": "获取指定地址的智能能量托管服务的剩余额度（余额）、服务状态以及消耗记录（分页）。",
  "operationId": "queryEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要查询的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
      }
    },
    {
      "$ref": "#/components/parameters/PageParam"
    }
  ],
  "responses": {
    "200": {
      "description": "查询成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartQueryResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式或页码无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/update_energy_smart更新智慧託管狀態

更新智慧託管狀態

啟用 ("start") 或暫停 ("stop") 指定地址的智慧能量託管服務。

完整請求地址：https://weidubot.cc/api/v2/update_energy_smart

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`address`	string必填	要更新狀態的 TRON 地址示例：`"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`status`	string必填	目標狀態列舉：`"start"` / `"stop"` 示例：`"start"`
`net_protect`	string未標記必填	地址的頻寬保護模式列舉：`"open"` / `"close"` 示例：`"open"`

響應說明

HTTP 200狀態更新成功，返回當前狀態。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	EnergySmartData未標記必填	智慧託管服務的地址狀態資訊（用於更新響應）。

HTTP 400請求錯誤 (地址、狀態值無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (該地址未開通此服務或不屬於當前使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 409衝突 (已經是目標狀態)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 429請求過於頻繁 (如果實現了鎖)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "更新智能托管状态",
  "description": "启用 (\"start\") 或暂停 (\"stop\") 指定地址的智能能量托管服务。",
  "operationId": "updateEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要更新状态的 TRON 地址",
              "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
            },
            "status": {
              "type": "string",
              "description": "目标状态",
              "enum": [
                "start",
                "stop"
              ],
              "example": "start"
            },
            "net_protect": {
              "type": "string",
              "description": "地址的带宽保护模式",
              "enum": [
                "open",
                "close"
              ],
              "example": "open"
            }
          },
          "required": [
            "address",
            "status"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "状态更新成功，返回当前状态。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址、状态值无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": "冲突 (已经是目标状态)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/statistics_smart_by_address獲取智慧託管地址統計

獲取智慧託管地址統計

獲取指定地址在不同時間段內（今日、昨日、本週、本月、近5天）的智慧能量服務消耗統計（區分 65k/131k 型別）。

完整請求地址：https://weidubot.cc/api/v2/statistics_smart_by_address

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`address`必填	query string	要獲取統計的 TRON 地址示例：`"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`

響應說明

HTTP 200成功獲取統計資料。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	StatisticsSmartData未標記必填	智慧託管服務按地址統計結果。

HTTP 400請求錯誤 (地址格式無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "智能托管 (Smart Delegation)"
  ],
  "summary": "获取智能托管地址统计",
  "description": "获取指定地址在不同时间段内（今日、昨日、本周、本月、近5天）的智能能量服务消耗统计（区分 65k/131k 类型）。",
  "operationId": "statisticsSmartByAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要获取统计的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取统计数据。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StatisticsSmartData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

能量筆數

API筆數的相關操作。

GET/get_times_price獲取API筆數價格

獲取API筆數價格

獲取當前API筆數的單次交易價格。

完整請求地址：https://weidubot.cc/api/v2/get_times_price

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

響應說明

HTTP 200成功獲取價格。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	TimesPriceData未標記必填	API筆數的價格資訊。

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (無法獲取價格資訊)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "获取API笔数价格",
  "description": "获取当前API笔数的单次交易价格。",
  "operationId": "getTimesPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取价格。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TimesPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (无法获取价格信息)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/delegate_energy_times委託API筆數

委託API筆數

為指定地址增加指定能量筆數（按次計費）。

完整請求地址：https://weidubot.cc/api/v2/delegate_energy_times

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`address`	string必填	要增加筆數的 TRON 地址示例：`"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`times`	integer必填	要增加的能量委託筆數 (必須為正整數) 示例：`100`

響應說明

HTTP 200委託成功。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	EnergyTimesDelegateResponseData未標記必填	API筆數委託成功後的響應資料。

HTTP 400請求錯誤 (地址或筆數無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 429請求過於頻繁 (如果實現了鎖)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤 (例如資料庫錯誤)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "委托API笔数",
  "description": "为指定地址增加指定能量笔数（按次计费）。",
  "operationId": "delegateEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要增加笔数的 TRON 地址",
              "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
            },
            "times": {
              "type": "integer",
              "description": "要增加的能量委托笔数 (必须为正整数)",
              "example": 100
            }
          },
          "required": [
            "address",
            "times"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "委托成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesDelegateResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址或笔数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误 (例如数据库错误)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_energy_times查詢API筆數狀態

查詢API筆數狀態

獲取指定地址的剩餘能量筆數、服務狀態以及消耗記錄（分頁）。

完整請求地址：https://weidubot.cc/api/v2/query_energy_times

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`address`必填	query string	要查詢的 TRON 地址示例：`"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`page`必填	query integer	查詢的頁碼 (從1開始) 最小值：`1` 示例：`1`

響應說明

HTTP 200查詢成功。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	EnergyTimesQueryResponseData未標記必填	API筆數的地址查詢結果。

HTTP 400請求錯誤 (地址格式或頁碼無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (該地址未開通此服務或不屬於當前使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "查询API笔数状态",
  "description": "获取指定地址的剩余能量笔数、服务状态以及消耗记录（分页）。",
  "operationId": "queryEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要查询的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
      }
    },
    {
      "$ref": "#/components/parameters/PageParam"
    }
  ],
  "responses": {
    "200": {
      "description": "查询成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesQueryResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式或页码无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/update_energy_times更新地址的API筆數狀態

更新地址的API筆數狀態

啟用 ("start") 或暫停 ("stop") 指定地址的API筆數服務。

完整請求地址：https://weidubot.cc/api/v2/update_energy_times

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`address`	string必填	要更新狀態的 TRON 地址示例：`"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`status`	string必填	目標狀態列舉：`"start"` / `"stop"` 示例：`"stop"`

響應說明

HTTP 200狀態更新成功，返回當前狀態。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	EnergyTimesData未標記必填	API筆數的地址狀態資訊（用於更新響應）。

HTTP 400請求錯誤 (地址、狀態值無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (該地址未開通此服務或不屬於當前使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 409衝突 (已經是目標狀態)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 429請求過於頻繁 (如果實現了鎖)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "更新地址的API笔数状态",
  "description": "启用 (\"start\") 或暂停 (\"stop\") 指定地址的API笔数服务。",
  "operationId": "updateEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要更新状态的 TRON 地址",
              "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
            },
            "status": {
              "type": "string",
              "description": "目标状态",
              "enum": [
                "start",
                "stop"
              ],
              "example": "stop"
            }
          },
          "required": [
            "address",
            "status"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "状态更新成功，返回当前状态。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址、状态值无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (该地址未开通此服务或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": "冲突 (已经是目标状态)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": "请求过于频繁 (如果实现了锁)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/statistics_times_by_address獲取 API能量筆數地址統計

獲取 API能量筆數地址統計

獲取指定地址在不同時間段內（今日、昨日、本週、本月、近5天）的 API能量筆數消耗數量統計。

完整請求地址：https://weidubot.cc/api/v2/statistics_times_by_address

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`address`必填	query string	要獲取統計的 TRON 地址示例：`"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`

響應說明

HTTP 200成功獲取統計資料。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	StatisticsTimesData未標記必填	API筆數按地址統計結果。

HTTP 400請求錯誤 (地址格式無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "能量笔数 (Energy Times)"
  ],
  "summary": "获取 API能量笔数 地址统计",
  "description": "获取指定地址在不同时间段内（今日、昨日、本周、本月、近5天）的 API能量笔数 消耗数量统计。",
  "operationId": "statisticsTimesByAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": "要获取统计的 TRON 地址",
      "schema": {
        "type": "string",
        "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取统计数据。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StatisticsTimesData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (地址格式无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Fragment 服務

透過 Fragment 訂購 Telegram Premium 會員和星星的操作。

POST/buy_premium購買 Telegram Premium 會員

購買 Telegram Premium 會員

建立一個為指定 Telegram 使用者贈送 Premium 會員的訂單。

完整請求地址：https://weidubot.cc/api/v2/buy_premium

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`username`	string必填	目標 Telegram 使用者名稱 (不含 @)。示例：`"telegram_user"`
`month`	integer必填	購買月數。列舉：`3` / `6` / `12` 示例：`3`

響應說明

HTTP 200訂單提交成功。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	PremiumOrderResponseData未標記必填	Premium 會員下單成功響應資料。

HTTP 400請求錯誤 (使用者名稱或月數無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 403禁止訪問 (餘額不足)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "购买 Telegram Premium 会员",
  "description": "创建一个为指定 Telegram 用户赠送 Premium 会员的订单。",
  "operationId": "buyPremiumV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/PremiumOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单提交成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PremiumOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (用户名或月数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_premium_order查詢 Premium 會員訂單狀態

查詢 Premium 會員訂單狀態

獲取指定 Premium 會員訂單的處理狀態和詳情。

完整請求地址：https://weidubot.cc/api/v2/query_premium_order

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`order_id`必填	query integer	要查詢的內部訂單 ID 示例：`5678`

響應說明

HTTP 200成功獲取訂單詳情。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	PremiumQueryResultData未標記必填	Premium 訂單查詢結果資料。

HTTP 400請求錯誤 (訂單 ID 無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (訂單 ID 不存在或不屬於當前使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "查询 Premium 会员订单状态",
  "description": "获取指定 Premium 会员订单的处理状态和详情。",
  "operationId": "queryPremiumOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": "要查询的内部订单 ID",
      "schema": {
        "type": "integer",
        "example": 5678
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取订单详情。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PremiumQueryResultData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单 ID 无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单 ID 不存在或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

POST/buy_star購買 Telegram 星星

購買 Telegram 星星

建立一個向指定 Telegram 使用者傳送星星的訂單。

完整請求地址：https://weidubot.cc/api/v2/buy_star

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`username`	string必填	目標 Telegram 使用者名稱 (不含 @)。示例：`"channel_owner"`
`count`	integer必填	購買的星星數量 (50-10000)。最小值：`50` 最大值：`10000` 示例：`100`

響應說明

HTTP 200訂單提交成功。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	StarOrderResponseData未標記必填	星星下單成功響應資料。

HTTP 400請求錯誤 (使用者名稱或數量無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 403禁止訪問 (餘額不足)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "购买 Telegram 星星",
  "description": "创建一个向指定 Telegram 用户发送星星的订单。",
  "operationId": "buyStarV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/StarOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "订单提交成功。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StarOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (用户名或数量无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "禁止访问 (余额不足)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

GET/query_star_order查詢星星訂單狀態

查詢星星訂單狀態

獲取指定星星訂單的處理狀態和詳情。

完整請求地址：https://weidubot.cc/api/v2/query_star_order

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`
`order_id`必填	query integer	要查詢的內部訂單 ID 示例：`91011`

響應說明

HTTP 200成功獲取訂單詳情。

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	StarQueryResultData未標記必填	星星訂單查詢結果資料。

HTTP 400請求錯誤 (訂單 ID 無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 404未找到 (訂單 ID 不存在或不屬於當前使用者)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "Fragment 服务 (Premium/Stars Service)"
  ],
  "summary": "查询星星订单状态",
  "description": "获取指定星星订单的处理状态和详情。",
  "operationId": "queryStarOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": "要查询的内部订单 ID",
      "schema": {
        "type": "integer",
        "example": 91011
      }
    }
  ],
  "responses": {
    "200": {
      "description": "成功获取订单详情。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StarQueryResultData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (订单 ID 无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "未找到 (订单 ID 不存在或不属于当前用户)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

地址歸集

管理 USDT 自動歸集地址。

POST/submit_converge_address提交地址歸集配置

提交地址歸集配置

為一個 TRON 地址配置自動 USDT 歸集的規則。

完整請求地址：https://weidubot.cc/api/v2/submit_converge_address

請求頭與引數

引數	位置 / 型別	說明與約束
`x-api-key`必填	header string	您的 API Key。
`x-timestamp`必填	header integer	當前 UNIX 時間戳 (秒)。示例：`1711961879`
`x-signature`必填	header string	簽名 (對 `x-api-key` + `x-timestamp` 進行 HMAC-SHA256 計算得到的小寫 Hex 值)。示例：`"a1b2c3d4e5f6..."`

請求體 · application/x-www-form-urlencoded

請求體必填

表單欄位	型別 / 必填	說明與約束
`address`	string必填	要配置歸集的 TRON 地址示例：`"TConvergeAddressxxxxxxxxxxxxxxxxxx"`
`mode`	string必填	歸集模式列舉：`"once"` / `"keep"` 示例：`"keep"`
`transfer_threshold`	number · float必填	觸發歸集的最低餘額閾值示例：`100`
`balance_min`	number · float必填	歸集後地址保留的最低餘額示例：`10`
`balance_max`	number · float必填	歸集後地址允許保留的最高餘額 (需 >= min) 示例：`20`
`energy_count`	integer必填	為歸集操作提供的能量數量示例：`65000`
`type`	string必填	為地址提供的服務型別列舉：`"energy"` / `"all"` 示例：`"all"`
`notify_callback`	string · url未標記必填	可選，接收歸集通知的回撥 URL 允許 null 示例：`"https://yourcallback.com/notify"`

響應說明

HTTP 200配置提交成功

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	具體的響應資料負載。允許 null

HTTP 400請求錯誤 (引數無效)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 401未授權

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 409衝突 (該地址已存在啟用中的配置)

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

HTTP 500伺服器內部錯誤

application/json · 點選型別名稱檢視完整欄位

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

檢視此介面的完整 OpenAPI 定義

OpenAPI · JSON

{
  "tags": [
    "地址归集 (Converge Address)"
  ],
  "summary": "提交地址归集配置",
  "description": "为一个 TRON 地址配置自动 USDT 归集的规则。",
  "operationId": "submitConvergeAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "要配置归集的 TRON 地址",
              "example": "TConvergeAddressxxxxxxxxxxxxxxxxxx"
            },
            "mode": {
              "type": "string",
              "description": "归集模式",
              "enum": [
                "once",
                "keep"
              ],
              "example": "keep"
            },
            "transfer_threshold": {
              "type": "number",
              "format": "float",
              "description": "触发归集的最低余额阈值",
              "example": 100
            },
            "balance_min": {
              "type": "number",
              "format": "float",
              "description": "归集后地址保留的最低余额",
              "example": 10
            },
            "balance_max": {
              "type": "number",
              "format": "float",
              "description": "归集后地址允许保留的最高余额 (需 >= min)",
              "example": 20
            },
            "energy_count": {
              "type": "integer",
              "description": "为归集操作提供的能量数量",
              "example": 65000
            },
            "type": {
              "type": "string",
              "description": "为地址提供的服务类型",
              "enum": [
                "energy",
                "all"
              ],
              "example": "all"
            },
            "notify_callback": {
              "type": "string",
              "format": "url",
              "nullable": true,
              "description": "可选，接收归集通知的回调 URL",
              "example": "https://yourcallback.com/notify"
            }
          },
          "required": [
            "address",
            "mode",
            "transfer_threshold",
            "balance_min",
            "balance_max",
            "energy_count",
            "type"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "配置提交成功",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BaseResponse"
          }
        }
      }
    },
    "400": {
      "description": "请求错误 (参数无效)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "未授权",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": "冲突 (该地址已存在启用中的配置)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "服务器内部错误",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

07 / DATA MODELS

完整資料模型

以下欄位與當前 V2 定義一致。介面成功響應通常以 code、msg、time、data 包裝，具體業務欄位見對應模型。

BaseResponse欄位定義

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，1 表示成功，0 表示失敗。列舉：`1` 示例：`1`
`msg`	string必填	響應訊息文字。示例：`"操作成功"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	具體的響應資料負載。允許 null

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer",
      "description": "状态码，1 表示成功，0 表示失败。",
      "enum": [
        1
      ],
      "example": 1
    },
    "msg": {
      "type": "string",
      "description": "响应消息文本。",
      "example": "操作成功"
    },
    "time": {
      "type": "string",
      "description": "服务器响应时间戳。",
      "example": "1711961879"
    },
    "data": {
      "type": "object",
      "nullable": true,
      "description": "具体的响应数据负载。"
    }
  },
  "required": [
    "code",
    "msg",
    "time"
  ]
}

ErrorResponse欄位定義

欄位	型別 / 必填	說明與約束
`code`	integer必填	狀態碼，0 表示失敗。列舉：`0` 示例：`0`
`msg`	string必填	錯誤訊息描述。示例：`"参数错误"`
`time`	string必填	伺服器響應時間戳。示例：`"1711961879"`
`data`	object未標記必填	允許 null 示例：`null`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer",
      "description": "状态码，0 表示失败。",
      "enum": [
        0
      ],
      "example": 0
    },
    "msg": {
      "type": "string",
      "description": "错误消息描述。",
      "example": "参数错误"
    },
    "time": {
      "type": "string",
      "description": "服务器响应时间戳。",
      "example": "1711961879"
    },
    "data": {
      "type": "object",
      "nullable": true,
      "example": null
    }
  },
  "required": [
    "code",
    "msg",
    "time"
  ]
}

ActivationData賬戶啟用請求提交後的響應資料。

賬戶啟用請求提交後的響應資料。

欄位	型別 / 必填	說明與約束
`tx_id`	string必填	交易雜湊 (通常在後臺任務完成後才有，初始為空)。示例：`""`
`order_id`	integer必填	用於追蹤啟用請求的內部訂單 ID。示例：`12345`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "账户激活请求提交后的响应数据。",
  "properties": {
    "tx_id": {
      "type": "string",
      "description": "交易哈希 (通常在后台任务完成后才有，初始为空)。",
      "example": ""
    },
    "order_id": {
      "type": "integer",
      "description": "用于追踪激活请求的内部订单 ID。",
      "example": 12345
    }
  },
  "required": [
    "tx_id",
    "order_id"
  ]
}

EnergyOrderResponseData能量訂單提交成功後的響應資料。

能量訂單提交成功後的響應資料。

欄位	型別 / 必填	說明與約束
`order_sn`	string必填	唯一的訂單序列號。示例：`"EN2025040217175512345"`
`price`	number · float未標記必填	計算出的單位能量價格 (SUN)。允許 null 示例：`35000000`
`fee`	number · float未標記必填	額外手續費 (TRX)。允許 null 示例：`0.56`
`amount`	number · float未標記必填	訂單總費用 (TRX)。允許 null 示例：`5.65`
`balance`	number · float未標記必填	操作後賬戶餘額 (可能不準確或不提供)。允許 null 示例：`94.35`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "能量订单提交成功后的响应数据。",
  "properties": {
    "order_sn": {
      "type": "string",
      "description": "唯一的订单序列号。",
      "example": "EN2025040217175512345"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "计算出的单位能量价格 (SUN)。",
      "example": 35000000
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "额外手续费 (TRX)。",
      "example": 0.56
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单总费用 (TRX)。",
      "example": 5.65
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "操作后账户余额 (可能不准确或不提供)。",
      "example": 94.35
    }
  },
  "required": [
    "order_sn"
  ]
}

NetOrderResponseData頻寬訂單提交成功後的響應資料。

頻寬訂單提交成功後的響應資料。

欄位	型別 / 必填	說明與約束
`order_sn`	string必填	唯一的訂單序列號。示例：`"NET2025040217180012345"`
`amount`	number · float未標記必填	訂單總費用 (TRX)。允許 null 示例：`2.1`
`price`	number · float未標記必填	計算出的單位頻寬價格 (SUN?)。允許 null 示例：`420000`
`fee`	number · float未標記必填	額外手續費 (TRX)。允許 null 示例：`0`
`balance`	number · float未標記必填	操作後賬戶餘額 (可能不準確或不提供)。允許 null 示例：`97.9`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "带宽订单提交成功后的响应数据。",
  "properties": {
    "order_sn": {
      "type": "string",
      "description": "唯一的订单序列号。",
      "example": "NET2025040217180012345"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单总费用 (TRX)。",
      "example": 2.1
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "计算出的单位带宽价格 (SUN?)。",
      "example": 420000
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "额外手续费 (TRX)。",
      "example": 0
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "操作后账户余额 (可能不准确或不提供)。",
      "example": 97.9
    }
  },
  "required": [
    "order_sn"
  ]
}

QueryResultDataSuccess查詢成功的訂單詳情。

查詢成功的訂單詳情。

欄位	型別 / 必填	說明與約束
`order_sn`	string必填
`amount`	number · float未標記必填	訂單金額 (TRX) 允許 null
`price`	number · float未標記必填	訂單單價 (SUN) 允許 null
`fee`	number · float未標記必填	訂單手續費 (TRX) 允許 null
`period`	string必填	週期名稱
`status`	string必填	訂單狀態碼
`orders`	array<object>必填	子訂單（委託）列表

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "查询成功的订单详情。",
  "properties": {
    "order_sn": {
      "type": "string"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单单价 (SUN)"
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "订单手续费 (TRX)"
    },
    "period": {
      "type": "string",
      "description": "周期名称"
    },
    "status": {
      "type": "string",
      "description": "订单状态码"
    },
    "orders": {
      "type": "array",
      "description": "子订单（委托）列表",
      "items": {
        "type": "object",
        "properties": {
          "from_address": {
            "type": "string",
            "description": "该笔委托的来源地址"
          },
          "tx_id": {
            "type": "string",
            "nullable": true,
            "description": "该笔委托的交易哈希"
          },
          "count": {
            "type": "integer",
            "description": "该笔委托的资源数量"
          }
        },
        "required": [
          "from_address",
          "count"
        ]
      }
    }
  },
  "required": [
    "order_sn",
    "period",
    "status",
    "orders"
  ]
}

QueryResultDataFailed查詢失敗或未完成的訂單基本資訊。

查詢失敗或未完成的訂單基本資訊。

欄位	型別 / 必填	說明與約束
`order_sn`	string必填
`amount`	number · float未標記必填	允許 null
`price`	number · float未標記必填	允許 null
`fee`	number · float未標記必填	允許 null
`period`	string未標記必填	允許 null
`status`	string必填	訂單狀態碼
`orders`	array<object>必填	空陣列

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "查询失败或未完成的订单基本信息。",
  "properties": {
    "order_sn": {
      "type": "string"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "period": {
      "type": "string",
      "nullable": true
    },
    "status": {
      "type": "string",
      "description": "订单状态码"
    },
    "orders": {
      "type": "array",
      "items": {},
      "description": "空数组"
    }
  },
  "required": [
    "order_sn",
    "status",
    "orders"
  ]
}

UserInfoData使用者資訊查詢結果。

使用者資訊查詢結果。

欄位	型別 / 必填	說明與約束
`balance_trx`	string必填	使用者可用 TRX 餘額 (格式化字串)。示例：`"100.5000"`
`balance_usdt`	string必填	使用者可用 USDT 餘額 (格式化字串)。示例：`"500.0000"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "用户信息查询结果。",
  "properties": {
    "balance_trx": {
      "type": "string",
      "description": "用户可用 TRX 余额 (格式化字符串)。",
      "example": "100.5000"
    },
    "balance_usdt": {
      "type": "string",
      "description": "用户可用 USDT 余额 (格式化字符串)。",
      "example": "500.0000"
    }
  },
  "required": [
    "balance_trx",
    "balance_usdt"
  ]
}

ResourcePriceData資源價格查詢結果。

資源價格查詢結果。

欄位	型別 / 必填	說明與約束
`price`	integer必填	單位價格 (SUN / 每週期)。示例：`35`
`amount`	string必填	請求數量的總預估費用 (單位：TRX)，包含可能的手續費。示例：`"5.6500"`
`fee`	string必填	額外的手續費 (單位：TRX)，例如小額訂單費用。示例：`"0.5600"`
`remark`	string必填	關於價格計算的附加說明 (例如手續費詳情)。示例：`"包含 0.56 TRX 带宽手续费"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "资源价格查询结果。",
  "properties": {
    "price": {
      "type": "integer",
      "description": "单位价格 (SUN / 每周期)。",
      "example": 35
    },
    "amount": {
      "type": "string",
      "description": "请求数量的总预估费用 (单位：TRX)，包含可能的手续费。",
      "example": "5.6500"
    },
    "fee": {
      "type": "string",
      "description": "额外的手续费 (单位：TRX)，例如小额订单费用。",
      "example": "0.5600"
    },
    "remark": {
      "type": "string",
      "description": "关于价格计算的附加说明 (例如手续费详情)。",
      "example": "包含 0.56 TRX 带宽手续费"
    }
  },
  "required": [
    "price",
    "amount",
    "fee",
    "remark"
  ]
}

FastRecoverPriceData速衝價格查詢結果

速衝價格查詢結果

欄位	型別 / 必填	說明與約束
`price`	integer必填	單位價格 (SUN)。示例：`100`
`amount`	string必填	請求數量的總預估費用 (單位：TRX)，包含可能的手續費。示例：`"5.6500"`
`fee`	string必填	額外的手續費 (單位：TRX)，例如小額訂單費用。示例：`"0.5600"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "速冲价格查询结果",
  "properties": {
    "price": {
      "type": "integer",
      "description": "单位价格 (SUN)。",
      "example": 100
    },
    "amount": {
      "type": "string",
      "description": "请求数量的总预估费用 (单位：TRX)，包含可能的手续费。",
      "example": "5.6500"
    },
    "fee": {
      "type": "string",
      "description": "额外的手续费 (单位：TRX)，例如小额订单费用。",
      "example": "0.5600"
    }
  },
  "required": [
    "price",
    "amount",
    "fee",
    "remark"
  ]
}

SmartPriceData智慧託管服務的價格資訊。

智慧託管服務的價格資訊。

欄位型別 / 必填說明與約束

65K_price

string必填

每次 65K 能量委託的價格 (TRX)。

示例："0.5000"

131K_price

string必填

每次 131K 能量委託的價格 (TRX)。

示例："0.9500"

remark

string未標記必填

允許 null
示例："价格单位：TRX/次"

high_frequency

object未標記必填

高頻價格資訊，包含能量價格、押金和統計週期等。

子欄位	型別 / 必填	說明與約束
`65k_price`	string未標記必填	高頻模式65K能量的價格。允許 null 示例：`"0.8000"`
`131k_price`	string未標記必填	高頻模式131K能量的價格。允許 null 示例：`"1.5000"`
`deposit_period`	string未標記必填	高頻模式統計週期，單位：小時允許 null 示例：`"72"`
`deposit_amount`	string未標記必填	高頻模式押金，單位: TRX 允許 null 示例：`1000`
`min_energy_count`	string未標記必填	高頻模式最少使用能量數允許 null 示例：`200000`

jisu_frequency

object未標記必填

極速模式價格資訊，包含能量價格、押金和統計週期等。

子欄位	型別 / 必填	說明與約束
`65k_price`	string未標記必填	極速模式65K能量的價格。允許 null 示例：`"0.8000"`
`131k_price`	string未標記必填	極速模式131K能量的價格。允許 null 示例：`"1.5000"`
`deposit_period`	string未標記必填	極速模式統計週期，單位：小時允許 null 示例：`"72"`
`deposit_amount`	string未標記必填	極速模式押金，單位: TRX 允許 null 示例：`1000`
`min_energy_count`	string未標記必填	極速模式最少使用能量數允許 null 示例：`200000`

guangsu_frequency

object未標記必填

光速模式價格資訊，包含能量價格、押金和統計週期等。

子欄位	型別 / 必填	說明與約束
`65k_price`	string未標記必填	光速模式65K能量的價格。允許 null 示例：`"0.8000"`
`131k_price`	string未標記必填	光速模式131K能量的價格。允許 null 示例：`"1.5000"`
`deposit_period`	string未標記必填	光速模式統計週期，單位：小時允許 null 示例：`"72"`
`deposit_amount`	string未標記必填	光速模式押金，單位: TRX 允許 null 示例：`1000`
`min_energy_count`	string未標記必填	光速模式最少使用能量數允許 null 示例：`200000`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务的价格信息。",
  "properties": {
    "65K_price": {
      "type": "string",
      "description": "每次 65K 能量委托的价格 (TRX)。",
      "example": "0.5000"
    },
    "131K_price": {
      "type": "string",
      "description": "每次 131K 能量委托的价格 (TRX)。",
      "example": "0.9500"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "example": "价格单位：TRX/次"
    },
    "high_frequency": {
      "type": "object",
      "description": "高频价格信息，包含能量价格、押金和统计周期等。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "高频模式65K能量的价格。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "高频模式131K能量的价格。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": "高频模式统计周期，单位：小时",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": "高频模式押金，单位: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "高频模式最少使用能量数",
          "example": 200000
        }
      }
    },
    "jisu_frequency": {
      "type": "object",
      "description": "极速模式价格信息，包含能量价格、押金和统计周期等。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "极速模式65K能量的价格。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "极速模式131K能量的价格。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": "极速模式统计周期，单位：小时",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": "极速模式押金，单位: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "极速模式最少使用能量数",
          "example": 200000
        }
      }
    },
    "guangsu_frequency": {
      "type": "object",
      "description": "光速模式价格信息，包含能量价格、押金和统计周期等。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "光速模式65K能量的价格。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "光速模式131K能量的价格。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": "光速模式统计周期，单位：小时",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": "光速模式押金，单位: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "光速模式最少使用能量数",
          "example": 200000
        }
      }
    }
  },
  "required": [
    "65K_price",
    "131K_price"
  ]
}

TimesPriceDataAPI筆數的價格資訊。

API筆數的價格資訊。

欄位	型別 / 必填	說明與約束
`price`	string必填	每次能量委託的價格 (TRX)。示例：`"0.6000"`
`remark`	string未標記必填	允許 null 示例：`"价格单位：TRX/笔"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数的价格信息。",
  "properties": {
    "price": {
      "type": "string",
      "description": "每次能量委托的价格 (TRX)。",
      "example": "0.6000"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "example": "价格单位：TRX/笔"
    }
  },
  "required": [
    "price"
  ]
}

EnergyTimesDelegateResponseDataAPI筆數委託成功後的響應資料。

API筆數委託成功後的響應資料。

欄位	型別 / 必填	說明與約束
`address`	string必填	委託的目標地址
`remain_times`	integer必填	操作後剩餘筆數
`status`	string必填	當前服務狀態列舉：`"start"` / `"stop"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数委托成功后的响应数据。",
  "properties": {
    "address": {
      "type": "string",
      "description": "委托的目标地址"
    },
    "remain_times": {
      "type": "integer",
      "description": "操作后剩余笔数"
    },
    "status": {
      "type": "string",
      "description": "当前服务状态",
      "enum": [
        "start",
        "stop"
      ]
    }
  },
  "required": [
    "address",
    "remain_times",
    "status"
  ]
}

EnergyTimesOrderItem能量筆數消耗記錄項

能量筆數消耗記錄項

欄位	型別 / 必填	說明與約束
`remain_times`	integer未標記必填	此次消耗後的剩餘筆數允許 null
`status`	string未標記必填	能量狀態允許 null 列舉：`"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`speed_mode`	string未標記必填	能量模式允許 null 列舉：`"normal"` / `"low_speed"`
`used_tx_id`	string未標記必填	消耗能量的交易雜湊允許 null
`used_energy`	integer未標記必填	消耗的能量值允許 null
`delegate_tx_id`	string未標記必填	委託能量的交易雜湊允許 null
`delegate_time`	integer未標記必填	委託時間戳允許 null
`un_delegate_tx_id`	string未標記必填	回收能量的交易雜湊允許 null
`un_delegate_time`	integer未標記必填	回收時間戳允許 null
`createtime`	integer未標記必填	記錄建立時間戳允許 null

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "能量笔数消耗记录项",
  "properties": {
    "remain_times": {
      "type": "integer",
      "nullable": true,
      "description": "此次消耗后的剩余笔数"
    },
    "status": {
      "type": "string",
      "nullable": true,
      "description": "能量状态",
      "enum": [
        "init",
        "waiting_delegate",
        "delegate_success",
        "delegate_failed",
        "waiting_un_delegate",
        "un_delegate_success",
        "un_delegate_failed"
      ]
    },
    "speed_mode": {
      "type": "string",
      "nullable": true,
      "description": "能量模式",
      "enum": [
        "normal",
        "low_speed"
      ]
    },
    "used_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "消耗能量的交易哈希"
    },
    "used_energy": {
      "type": "integer",
      "nullable": true,
      "description": "消耗的能量值"
    },
    "delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "委托能量的交易哈希"
    },
    "delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "委托时间戳"
    },
    "un_delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "回收能量的交易哈希"
    },
    "un_delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "回收时间戳"
    },
    "createtime": {
      "type": "integer",
      "nullable": true,
      "description": "记录创建时间戳"
    }
  }
}

EnergyTimesQueryResponseDataAPI筆數的地址查詢結果。

API筆數的地址查詢結果。

欄位	型別 / 必填	說明與約束
`address`	string必填	TRON 地址
`remain_times`	integer必填	剩餘可用筆數
`status`	string必填	服務狀態 (啟用/暫停) 列舉：`"start"` / `"stop"`
`order_count`	integer必填	總消耗記錄數
`page_size`	integer必填	每頁記錄數
`page`	integer必填	當前頁碼
`orders`	array<EnergyTimesOrderItem>必填	當前頁的消耗記錄列表

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数的地址查询结果。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "remain_times": {
      "type": "integer",
      "description": "剩余可用笔数"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    },
    "order_count": {
      "type": "integer",
      "description": "总消耗记录数"
    },
    "page_size": {
      "type": "integer",
      "description": "每页记录数"
    },
    "page": {
      "type": "integer",
      "description": "当前页码"
    },
    "orders": {
      "type": "array",
      "description": "当前页的消耗记录列表",
      "items": {
        "$ref": "#/components/schemas/EnergyTimesOrderItem"
      }
    }
  },
  "required": [
    "address",
    "remain_times",
    "status",
    "order_count",
    "page_size",
    "page",
    "orders"
  ]
}

EnergyTimesDataAPI筆數的地址狀態資訊（用於更新響應）。

API筆數的地址狀態資訊（用於更新響應）。

欄位	型別 / 必填	說明與約束
`address`	string必填	TRON 地址
`remain_times`	integer必填	剩餘可用筆數
`status`	string必填	服務狀態 (啟用/暫停) 列舉：`"start"` / `"stop"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数的地址状态信息（用于更新响应）。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "remain_times": {
      "type": "integer",
      "description": "剩余可用笔数"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    }
  },
  "required": [
    "address",
    "remain_times",
    "status"
  ]
}

EnergySmartDelegateResponseData智慧託管委託成功後的響應資料。

智慧託管委託成功後的響應資料。

欄位	型別 / 必填	說明與約束
`address`	string必填	委託的目標地址
`balance`	string必填	操作後的總餘額 (格式化字串)
`status`	string必填	當前服務狀態列舉：`"start"` / `"stop"`
`net_protect`	string未標記必填	頻寬模式列舉：`"open"` / `"close"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管委托成功后的响应数据。",
  "properties": {
    "address": {
      "type": "string",
      "description": "委托的目标地址"
    },
    "balance": {
      "type": "string",
      "description": "操作后的总余额 (格式化字符串)"
    },
    "status": {
      "type": "string",
      "description": "当前服务状态",
      "enum": [
        "start",
        "stop"
      ]
    },
    "net_protect": {
      "type": "string",
      "description": "带宽模式",
      "enum": [
        "open",
        "close"
      ]
    }
  },
  "required": [
    "address",
    "balance",
    "status"
  ]
}

EnergySmartOrderItem智慧託管消耗記錄項

智慧託管消耗記錄項

欄位	型別 / 必填	說明與約束
`energy_type`	string未標記必填	能量型別: 65k=65K能量, 131k=131K能量允許 null
`amount`	number · float未標記必填	消耗金額允許 null
`balance`	number · float未標記必填	消耗後餘額允許 null
`currency`	string未標記必填	幣種允許 null 列舉：`"trx"` / `"usdt"`
`status`	string未標記必填	能量狀態允許 null 列舉：`"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`used_tx_id`	string未標記必填	消耗能量的交易雜湊允許 null
`speed_mode`	string未標記必填	能量模式允許 null 列舉：`"normal"` / `"low_speed"`
`used_energy`	integer未標記必填	消耗的能量值允許 null
`used_times`	integer未標記必填	使用筆數允許 null
`remain_times`	integer未標記必填	地址剩餘總筆數允許 null
`delegate_count`	integer未標記必填	委託的能量數量允許 null
`delegate_tx_id`	string未標記必填	委託能量的交易雜湊允許 null
`delegate_time`	integer未標記必填	委託時間戳允許 null
`un_delegate_tx_id`	string未標記必填	回收能量的交易雜湊允許 null
`un_delegate_time`	integer未標記必填	回收時間戳允許 null
`createtime`	integer未標記必填	記錄建立時間戳允許 null

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管消耗记录项",
  "properties": {
    "energy_type": {
      "type": "string",
      "nullable": true,
      "description": "能量类型: 65k=65K能量, 131k=131K能量"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "消耗金额"
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "消耗后余额"
    },
    "currency": {
      "type": "string",
      "nullable": true,
      "description": "币种",
      "enum": [
        "trx",
        "usdt"
      ]
    },
    "status": {
      "type": "string",
      "nullable": true,
      "description": "能量状态",
      "enum": [
        "init",
        "waiting_delegate",
        "delegate_success",
        "delegate_failed",
        "waiting_un_delegate",
        "un_delegate_success",
        "un_delegate_failed"
      ]
    },
    "used_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "消耗能量的交易哈希"
    },
    "speed_mode": {
      "type": "string",
      "nullable": true,
      "description": "能量模式",
      "enum": [
        "normal",
        "low_speed"
      ]
    },
    "used_energy": {
      "type": "integer",
      "nullable": true,
      "description": "消耗的能量值"
    },
    "used_times": {
      "type": "integer",
      "nullable": true,
      "description": "使用笔数"
    },
    "remain_times": {
      "type": "integer",
      "nullable": true,
      "description": "地址剩余总笔数"
    },
    "delegate_count": {
      "type": "integer",
      "nullable": true,
      "description": "委托的能量数量"
    },
    "delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "委托能量的交易哈希"
    },
    "delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "委托时间戳"
    },
    "un_delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": "回收能量的交易哈希"
    },
    "un_delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": "回收时间戳"
    },
    "createtime": {
      "type": "integer",
      "nullable": true,
      "description": "记录创建时间戳"
    }
  }
}

EnergySmartQueryResponseData智慧託管服務的地址查詢結果。

智慧託管服務的地址查詢結果。

欄位	型別 / 必填	說明與約束
`address`	string必填	TRON 地址
`balance`	string必填	剩餘可用額度 (格式化字串)
`status`	string必填	服務狀態 (啟用/暫停) 列舉：`"start"` / `"stop"`
`order_count`	integer必填	總消耗記錄數
`page_size`	integer必填	每頁記錄數
`page`	integer必填	當前頁碼
`orders`	array<EnergySmartOrderItem>必填	當前頁的消耗記錄列表

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务的地址查询结果。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "balance": {
      "type": "string",
      "description": "剩余可用额度 (格式化字符串)"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    },
    "order_count": {
      "type": "integer",
      "description": "总消耗记录数"
    },
    "page_size": {
      "type": "integer",
      "description": "每页记录数"
    },
    "page": {
      "type": "integer",
      "description": "当前页码"
    },
    "orders": {
      "type": "array",
      "description": "当前页的消耗记录列表",
      "items": {
        "$ref": "#/components/schemas/EnergySmartOrderItem"
      }
    }
  },
  "required": [
    "address",
    "balance",
    "status",
    "order_count",
    "page_size",
    "page",
    "orders"
  ]
}

EnergySmartData智慧託管服務的地址狀態資訊（用於更新響應）。

智慧託管服務的地址狀態資訊（用於更新響應）。

欄位	型別 / 必填	說明與約束
`address`	string必填	TRON 地址
`balance`	string必填	剩餘可用額度 (格式化字串)
`status`	string必填	服務狀態 (啟用/暫停) 列舉：`"start"` / `"stop"`
`net_protect`	string未標記必填	頻寬模式列舉：`"open"` / `"close"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务的地址状态信息（用于更新响应）。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON 地址"
    },
    "balance": {
      "type": "string",
      "description": "剩余可用额度 (格式化字符串)"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": "服务状态 (启用/暂停)"
    },
    "net_protect": {
      "type": "string",
      "description": "带宽模式",
      "enum": [
        "open",
        "close"
      ]
    }
  },
  "required": [
    "address",
    "balance",
    "status"
  ]
}

StatisticsDetail單個時間段的智慧託管統計詳情。

單個時間段的智慧託管統計詳情。

欄位	型別 / 必填	說明與約束
`65k`	integer必填	65k 型別操作筆數示例：`8`
`131k`	integer必填	131k 型別操作筆數示例：`15`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "单个时间段的智能托管统计详情。",
  "properties": {
    "65k": {
      "type": "integer",
      "description": "65k 类型操作笔数",
      "example": 8
    },
    "131k": {
      "type": "integer",
      "description": "131k 类型操作笔数",
      "example": 15
    }
  },
  "required": [
    "65k",
    "131k"
  ]
}

StatisticsSmartData智慧託管服務按地址統計結果。

智慧託管服務按地址統計結果。

欄位	型別 / 必填	說明與約束
`days`	object必填	最近 5 天的統計 (鍵為 YYYY-MM-DD)。動態鍵的值：StatisticsDetail
`today`	StatisticsDetail必填	今日統計
`yesterday`	StatisticsDetail必填	昨日統計
`this_week`	StatisticsDetail必填	本週統計 (週一至今)
`this_month`	StatisticsDetail必填	本月統計 (1號至今)

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "智能托管服务按地址统计结果。",
  "properties": {
    "days": {
      "type": "object",
      "description": "最近 5 天的统计 (键为 YYYY-MM-DD)。",
      "additionalProperties": {
        "$ref": "#/components/schemas/StatisticsDetail"
      }
    },
    "today": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "今日统计"
    },
    "yesterday": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "昨日统计"
    },
    "this_week": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "本周统计 (周一至今)"
    },
    "this_month": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": "本月统计 (1号至今)"
    }
  },
  "required": [
    "days",
    "today",
    "yesterday",
    "this_week",
    "this_month"
  ]
}

StatisticsTimesDataAPI筆數按地址統計結果。

API筆數按地址統計結果。

欄位	型別 / 必填	說明與約束
`days`	object必填	最近 5 天的統計 (鍵為 YYYY-MM-DD)。動態鍵的值：integer
`today`	integer必填	今日總筆數示例：`5`
`yesterday`	integer必填	昨日總筆數示例：`8`
`this_week`	integer必填	本週總筆數 (週一至今) 示例：`30`
`this_month`	integer必填	本月總筆數 (1號至今) 示例：`150`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "API笔数 按地址统计结果。",
  "properties": {
    "days": {
      "type": "object",
      "description": "最近 5 天的统计 (键为 YYYY-MM-DD)。",
      "additionalProperties": {
        "type": "integer",
        "example": 25,
        "description": "每日总笔数"
      }
    },
    "today": {
      "type": "integer",
      "example": 5,
      "description": "今日总笔数"
    },
    "yesterday": {
      "type": "integer",
      "example": 8,
      "description": "昨日总笔数"
    },
    "this_week": {
      "type": "integer",
      "example": 30,
      "description": "本周总笔数 (周一至今)"
    },
    "this_month": {
      "type": "integer",
      "example": 150,
      "description": "本月总笔数 (1号至今)"
    }
  },
  "required": [
    "days",
    "today",
    "yesterday",
    "this_week",
    "this_month"
  ]
}

PremiumOrderRequest欄位定義

欄位	型別 / 必填	說明與約束
`username`	string必填	目標 Telegram 使用者名稱 (不含 @)。示例：`"telegram_user"`
`month`	integer必填	購買月數。列舉：`3` / `6` / `12` 示例：`3`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标 Telegram 用户名 (不含 @)。",
      "example": "telegram_user"
    },
    "month": {
      "type": "integer",
      "description": "购买月数。",
      "enum": [
        3,
        6,
        12
      ],
      "example": 3
    }
  },
  "required": [
    "username",
    "month"
  ]
}

StarOrderRequest欄位定義

欄位	型別 / 必填	說明與約束
`username`	string必填	目標 Telegram 使用者名稱 (不含 @)。示例：`"channel_owner"`
`count`	integer必填	購買的星星數量 (50-10000)。最小值：`50` 最大值：`10000` 示例：`100`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标 Telegram 用户名 (不含 @)。",
      "example": "channel_owner"
    },
    "count": {
      "type": "integer",
      "description": "购买的星星数量 (50-10000)。",
      "minimum": 50,
      "maximum": 10000,
      "example": 100
    }
  },
  "required": [
    "username",
    "count"
  ]
}

PremiumOrderResponseDataPremium 會員下單成功響應資料。

Premium 會員下單成功響應資料。

欄位	型別 / 必填	說明與約束
`username`	string必填	目標使用者名稱
`period`	string必填	購買週期 (例如 "3month")
`order_id`	integer必填	內部訂單 ID
`amount`	number · float必填	訂單金額 (TRX)
`price`	number · float必填	價格資訊
`pay_status`	string必填	支付狀態
`status`	string必填	訂單處理狀態

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "Premium 会员下单成功响应数据。",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标用户名"
    },
    "period": {
      "type": "string",
      "description": "购买周期 (例如 \"3month\")"
    },
    "order_id": {
      "type": "integer",
      "description": "内部订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    }
  },
  "required": [
    "username",
    "period",
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

StarOrderResponseData星星下單成功響應資料。

星星下單成功響應資料。

欄位	型別 / 必填	說明與約束
`username`	string必填	目標使用者名稱
`count`	integer必填	購買的星星數量
`order_id`	integer必填	內部訂單 ID
`amount`	number · float必填	訂單金額 (TRX)
`price`	number · float必填	價格資訊
`pay_status`	string必填	支付狀態
`status`	string必填	訂單處理狀態

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "星星下单成功响应数据。",
  "properties": {
    "username": {
      "type": "string",
      "description": "目标用户名"
    },
    "count": {
      "type": "integer",
      "description": "购买的星星数量"
    },
    "order_id": {
      "type": "integer",
      "description": "内部订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    }
  },
  "required": [
    "username",
    "count",
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

PremiumQueryResultDataPremium 訂單查詢結果資料。

Premium 訂單查詢結果資料。

欄位	型別 / 必填	說明與約束
`username`	string未標記必填	目標使用者名稱允許 null
`nickname`	string未標記必填	目標使用者暱稱允許 null
`period`	string未標記必填	購買週期允許 null
`order_id`	integer必填	訂單 ID
`amount`	number · float必填	訂單金額 (TRX)
`price`	number · float必填	價格資訊
`pay_status`	string必填	支付狀態
`status`	string必填	訂單處理狀態
`remark`	string未標記必填	備註/失敗原因 (截斷後) 允許 null
`create_time`	string · date-time未標記必填	訂單建立時間允許 null

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "Premium 订单查询结果数据。",
  "properties": {
    "username": {
      "type": "string",
      "nullable": true,
      "description": "目标用户名"
    },
    "nickname": {
      "type": "string",
      "nullable": true,
      "description": "目标用户昵称"
    },
    "period": {
      "type": "string",
      "nullable": true,
      "description": "购买周期"
    },
    "order_id": {
      "type": "integer",
      "description": "订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "description": "备注/失败原因 (截断后)"
    },
    "create_time": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": "订单创建时间"
    }
  },
  "required": [
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

StarQueryResultData星星訂單查詢結果資料。

星星訂單查詢結果資料。

欄位	型別 / 必填	說明與約束
`username`	string未標記必填	目標使用者名稱允許 null
`nickname`	string未標記必填	目標使用者暱稱允許 null
`count`	integer未標記必填	購買的星星數量允許 null
`order_id`	integer必填	訂單 ID
`amount`	number · float必填	訂單金額 (TRX)
`price`	number · float必填	價格資訊
`pay_status`	string必填	支付狀態
`status`	string必填	訂單處理狀態
`remark`	string未標記必填	備註/失敗原因 (截斷後) 允許 null
`create_time`	string · date-time未標記必填	訂單建立時間允許 null

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "星星订单查询结果数据。",
  "properties": {
    "username": {
      "type": "string",
      "nullable": true,
      "description": "目标用户名"
    },
    "nickname": {
      "type": "string",
      "nullable": true,
      "description": "目标用户昵称"
    },
    "count": {
      "type": "integer",
      "nullable": true,
      "description": "购买的星星数量"
    },
    "order_id": {
      "type": "integer",
      "description": "订单 ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": "订单金额 (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": "价格信息"
    },
    "pay_status": {
      "type": "string",
      "description": "支付状态"
    },
    "status": {
      "type": "string",
      "description": "订单处理状态"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "description": "备注/失败原因 (截断后)"
    },
    "create_time": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": "订单创建时间"
    }
  },
  "required": [
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}

FastRecoverOrderRequest欄位定義

欄位	型別 / 必填	說明與約束
`address`	string必填	接收資源的 TRON 地址示例：`"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer必填	需要補充的能量或頻寬數量示例：`65000`
`resource_type`	string必填	資源型別列舉：`"energy"` / `"net"` 示例：`"energy"`

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "接收资源的 TRON 地址",
      "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "count": {
      "type": "integer",
      "description": "需要补充的能量或带宽数量",
      "example": 65000
    },
    "resource_type": {
      "type": "string",
      "description": "资源类型",
      "enum": [
        "energy",
        "net"
      ],
      "example": "energy"
    }
  },
  "required": [
    "address",
    "count",
    "resource_type"
  ]
}

FastRecoverOrderResponseData速充訂單查詢結果資料。

速充訂單查詢結果資料。

欄位	型別 / 必填	說明與約束
`order_id`	integer必填	內部訂單 ID
`address`	string必填	目標地址
`energy_count`	integer必填	請求的能量/頻寬數量
`price`	number · float未標記必填	單價 (SUN) 允許 null
`fee`	number · float未標記必填	手續費 (TRX) 允許 null
`resource_type`	string必填	資源型別列舉：`"energy"` / `"net"`
`amount`	number · float未標記必填	總金額 (TRX) 允許 null
`status`	string必填	訂單狀態列舉：`"waiting"` / `"success"` / `"failed"`
`delegate_txid`	string未標記必填	委託交易雜湊允許 null
`reclaim_txid`	string未標記必填	回收交易雜湊允許 null
`actual_recover_count`	integer未標記必填	實際補充數量允許 null

原始模型定義

OpenAPI · JSON

{
  "type": "object",
  "description": "速充订单查询结果数据。",
  "properties": {
    "order_id": {
      "type": "integer",
      "description": "内部订单 ID"
    },
    "address": {
      "type": "string",
      "description": "目标地址"
    },
    "energy_count": {
      "type": "integer",
      "description": "请求的能量/带宽数量"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "单价 (SUN)"
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "手续费 (TRX)"
    },
    "resource_type": {
      "type": "string",
      "description": "资源类型",
      "enum": [
        "energy",
        "net"
      ]
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "总金额 (TRX)"
    },
    "status": {
      "type": "string",
      "description": "订单状态",
      "enum": [
        "waiting",
        "success",
        "failed"
      ]
    },
    "delegate_txid": {
      "type": "string",
      "nullable": true,
      "description": "委托交易哈希"
    },
    "reclaim_txid": {
      "type": "string",
      "nullable": true,
      "description": "回收交易哈希"
    },
    "actual_recover_count": {
      "type": "integer",
      "nullable": true,
      "description": "实际补充数量"
    }
  },
  "required": [
    "order_id",
    "address",
    "energy_count",
    "resource_type",
    "status"
  ]
}

介面版本 2.1.0 · 核對日期 2026-09-30

介面定義來源：API V2 開發文件。本站整理接入指引並保留完整介面定義；原服務更新後，請重新核對。

下載本站完整 OpenAPI 檔案

把能量服務接入你的應用

先開戶，再開始對接

三個請求頭，一次簽名

Node.js：生成簽名並查詢餘額

查詢充值後的可用餘額

按介面指定的方法傳參

購買 1 小時能量的請求格式

找到適合業務的介面

能量速充

智慧託管

時長租賃

完整介面參考 25

賬戶管理

啟用 TRON 地址

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

獲取使用者資訊

請求頭與引數

響應說明

資源訂單

購買能量時長

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

購買頻寬時長

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

主動回收能量

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

查詢訂單結果

請求頭與引數

響應說明

查詢資源價格

請求頭與引數

響應說明

能量速充

查詢能量/頻寬速充價格

請求頭與引數

響應說明

能量/頻寬速充

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

查詢速充訂單狀態

請求頭與引數

響應說明

智慧託管

獲取智慧託管價格

請求頭與引數

響應說明

委託智慧託管額度

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

查詢智慧託管狀態

請求頭與引數

響應說明

更新智慧託管狀態

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

獲取智慧託管地址統計

請求頭與引數

響應說明

能量筆數

獲取API筆數價格

請求頭與引數

響應說明

委託API筆數

請求頭與引數

請求體 · application/x-www-form-urlencoded

響應說明

查詢API筆數狀態

請求頭與引數

響應說明

更新地址的API筆數狀態

把能量服務
接入你的應用

獲取 API能量筆數地址統計