DUIYA DEVELOPERS / API V2

Bring Energy services
into your application

DuiYa API integration: check balances, rent Energy and manage delegated addresses.
From account setup to your first request, start here.

Open an account · @wanglei Download OpenAPI

duiya.org / api

GET/user_info

balance_trx TRX balance

balance_usdt USDT balance

API V2 2.1.0 API reference 25 ENDPOINTS

01 / GET STARTED

Open an account before integrating

First contact Telegram @wanglei to arrange backend account access.

After activation, log in at the backend address provided by support. Confirm deposits, available balance, API permissions and current prices before integration.

Log in to the backend Open API user settings to check account details and available balance after deposits.
Add IP allowlist entries Add the calling server's public outbound IP. Update the allowlist when the server or outbound IP changes.
Enable API access Save the settings and confirm the required service permissions are enabled.
Get your API Key and API Secret Sign requests on your server using the rules below. Start with a balance query to verify the configuration.

Manage deposits and IP allowlisting in the backend. The public V2 definition has no endpoint to add IPs or query deposit history; /user_info returns the currently available balance.

02 / AUTHENTICATION

Three headers and one signature

All endpoints use API Key/signature authentication. Use the API Secret only to sign on the server; do not send it as a request parameter.

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

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

Concatenate API Key and timestamp without a separator. Output lowercase hex. The timestamp is in seconds and must be within ±5 minutes of server time.

Node.js: sign and query balance

Node.js · Server-side example

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);

Store keys in server environment variables. The header timestamp must match the timestamp used for the signature.

03 / ACCOUNT BALANCE

Check the available balance after a deposit

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

No business query parameters are needed; include the three authentication headers. Read data.balance_trx and data.balance_usdt , both formatted strings.

JSON · Structure example, not a real balance

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

For deposits, backend access or IP allowlisting, contact @wanglei . Full response fields: /user_info .

04 / REQUEST FORMAT

Use each endpoint's specified method

This documentation URL: https://duiya.org/api/
API base URL: https://weidubot.cc/api/v2
Energy purchase path: /buy_energy
Full request URL: https://weidubot.cc/api/v2/buy_energy

GET query parameters go in the URL. For POST, use form fields or query parameters as defined here. Energy purchase requires POST, not GET. Authentication always belongs in the headers.

Note: /query_fast_recover_price uses POST, but resource_type and count are URL query parameters in the current definition.

Example: rent Energy for 1 hour

cURL · Replace every placeholder before use

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'

This request creates a paid order. First use /query_price to check the price, address, quantity, duration and balance. After submitting an asynchronous order, use /query_result to check the execution result.

duiya.org hosts these docs; API requests go to the service URL above. Example prices, balances and amounts illustrate structure and are not live quotes.

05 / ENERGY SERVICES

Find the right endpoints

01 / FAST RECOVER

Instant recharge

Check recharge prices, purchase Energy or Bandwidth, then track the order.

/query_fast_recover_price/buy_fast_recover/query_fast_recover_order

02 / SMART DELEGATION

Smart delegation

Check delegation prices, allocate credit and manage addresses and usage records.

/get_smart_price/delegate_energy_smart/query_energy_smart

03 / ENERGY RENTAL

Timed rental

Get a quote by quantity and duration, then check the order result.

/query_price/buy_energy/query_result

Unit-based Energy, account activation, address consolidation and Fragment services are also documented. Availability and pricing depend on account permissions and actual API responses.

06 / ENDPOINT REFERENCE

Complete API reference 25

Expand an endpoint for parameters, response fields and the full definition. Click a type name to view its data model.

Find an endpoint

Showing all 25 endpoints

Account management

User information and account activation.

POST/active_account Activate a TRON address

Activate a TRON address

Submit an address activation request. The corresponding fee is deducted from your balance.

Full URL: https://weidubot.cc/api/v2/active_account

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`address`	string Required	TRON address to activate Example: `"TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"`

Responses

HTTP 200 Activation request submitted.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	ActivationData Not marked required	Response data after submitting account activation.

HTTP 400 Bad request, e.g. invalid address format

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized: authentication failed

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 403 Forbidden, e.g. insufficient balance

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Get user information

Get user information

Get basic details for the authenticated user, including balances.

Full URL: https://weidubot.cc/api/v2/user_info

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Responses

HTTP 200 User information retrieved.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	UserInfoData Not marked required	User information result.

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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

Resource orders

Buy TRON Energy or Bandwidth for a duration; query and manage orders.

POST/buy_energy Buy timed Energy

Buy timed Energy

Submit an asynchronous order to delegate Energy to an address for the selected period.

Full URL: https://weidubot.cc/api/v2/buy_energy

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`count`	integer Required	Energy amount to delegate, minimum 30000 Example: `50000`
`period`	string Required	Period, e.g. "15minutes", "1h", "1day", "3day" Example: `"1day"`
`address`	string Required	TRON address receiving Energy Example: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

Responses

HTTP 200 Order submitted successfully.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	EnergyOrderResponseData Not marked required	Data returned after an Energy order is submitted.

HTTP 400 Bad request: invalid parameters, inactive address, etc.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 403 Forbidden: insufficient balance or abnormal user status

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Buy timed Bandwidth

Buy timed Bandwidth

Submit an asynchronous order to delegate Bandwidth to an address for the selected period.

Full URL: https://weidubot.cc/api/v2/buy_net

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`count`	integer Required	Bandwidth bytes to delegate, minimum 100 Example: `5000`
`period`	string Required	Period, e.g. "1day", "3day" Example: `"3day"`
`address`	string Required	TRON address receiving Bandwidth Example: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

Responses

HTTP 200 Order submitted successfully.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	NetOrderResponseData Not marked required	Data returned after a Bandwidth order is submitted.

HTTP 400 Bad request

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 403 Forbidden

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Reclaim Energy

Reclaim Energy

Asynchronously reclaim delegated resources using a completed order's serial number and target address.

Full URL: https://weidubot.cc/api/v2/reclaim_energy

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`order_sn`	string Required	Original delegation order serial number Example: `"EN2025040217175512345"`
`address`	string Required	Original resource receiving address Example: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

Responses

HTTP 200 Reclaim request submitted.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Response data payload. Nullable

HTTP 400 Bad request: invalid order number or address

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: missing order, wrong owner or no matching reclaimable resources

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Query order result

Query order result

Get a resource order's processing status and details.

Full URL: https://weidubot.cc/api/v2/query_result

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`order_sn` Required	query string	Unique serial number of the order Example: `"EN2025040217175512345"`

Responses

HTTP 200 Order details retrieved. The data structure contains success details or failure information depending on status.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	QueryResultDataSuccess or QueryResultDataFailed Not marked required

HTTP 400 Bad request: invalid order number

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: order missing or belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server or query error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Query resource price

Query resource price

Estimate the order price by resource type (energy or net), quantity and period.

Full URL: https://weidubot.cc/api/v2/query_price

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`type` Required	query string	Resource type ("energy", "net") Enum: `"energy"` / `"net"` Example: `"energy"`
`count` Required	query integer	Energy points or Bandwidth bytes Example: `50000`
`period` Required	query string	Period, e.g. "15minutes", "1h", "1day", "3day" Example: `"1day"`

Responses

HTTP 200 Price calculated.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	ResourcePriceData Not marked required	Resource price result.

HTTP 400 Bad request: invalid parameters

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: price unavailable or not configured

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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

Instant recharge

Fast Energy and Bandwidth top-up services.

POST/query_fast_recover_price Query recharge price

Query recharge price

Get the recharge price.

Full URL: https://weidubot.cc/api/v2/query_fast_recover_price

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`resource_type` Required	query string	Resource type ("energy", "net") Enum: `"energy"` / `"net"` Example: `"energy"`
`count` Required	query integer	Quantity of Energy or Bandwidth Example: `100000`

Responses

HTTP 200 Price calculated.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	FastRecoverPriceData Not marked required	Recharge price result

HTTP 400 Bad request: invalid parameters

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: price unavailable or not configured

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Recharge Energy or Bandwidth

Recharge Energy or Bandwidth

Provide a one-time Energy or Bandwidth top-up to an address.

Full URL: https://weidubot.cc/api/v2/buy_fast_recover

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`address`	string Required	TRON address receiving resources Example: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer Required	Amount of Energy or Bandwidth to top up Example: `65000`
`resource_type`	string Required	Resource type Enum: `"energy"` / `"net"` Example: `"energy"`

Responses

HTTP 200 Recharge request submitted; query its status later.

application/json · Click a type for full fields

Field Type / required Description and constraints

code

integer Required

Status code: 1 for success, 0 for failure.

Enum: 1
Example: 1

msg

string Required

Response message.

Example: "操作成功"

time

string Required

Server response timestamp.

Example: "1711961879"

data

object Not marked required

Nested field	Type / required	Description and constraints
`order_id`	integer Not marked required	Recharge order ID

HTTP 400 Bad request: invalid parameters

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 403 Forbidden, e.g. insufficient balance

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Query recharge order

Query recharge order

Get a recharge order's status and details.

Full URL: https://weidubot.cc/api/v2/query_fast_recover_order

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`order_id` Required	query integer	Recharge order ID to query Example: `123`

Responses

HTTP 200 Query successful.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	FastRecoverOrderResponseData Not marked required	Recharge order query result.

HTTP 400 Bad request: invalid order ID

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: order missing or belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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

Smart delegation

Smart Energy delegation operations.

GET/get_smart_price Get smart delegation prices

Get smart delegation prices

Get current smart delegation prices for 65K and 131K Energy.

Full URL: https://weidubot.cc/api/v2/get_smart_price

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Responses

HTTP 200 Prices retrieved.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	SmartPriceData Not marked required	Smart delegation pricing.

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: some or all prices unavailable

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Add smart delegation credit

Add smart delegation credit

Increase an address's available smart delegation credit (balance).

Full URL: https://weidubot.cc/api/v2/delegate_energy_smart

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`address`	string Required	TRON address to credit Example: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`balance`	number · float Required	Positive credit amount, e.g. a TRX amount Example: `10.5`
`channel`	string Not marked required	Mode: normal = standard; high_frequency = high frequency; jisu_frequency = fast; guangsu_frequency = light speed Enum: `"normal"` / `"high_frequency"` / `"jisu_frequency"` / `"guangsu_frequency"` Example: `"high_frequency"`
`hf_deposit`	number Not marked required	High-frequency deposit: -1 follows system settings; 0 means no deposit; other amounts deduct that deposit Example: `"0"`
`net_protect`	string Not marked required	Address Bandwidth protection mode Enum: `"open"` / `"close"` Example: `"open"`

Responses

HTTP 200 Delegation or credit increase successful

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	EnergySmartDelegateResponseData Not marked required	Smart delegation success data.

HTTP 400 Bad request: invalid address or credit amount

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 429 Too many requests, if locking is implemented

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Query smart delegation status

Query smart delegation status

Get an address's remaining credit, service status and paginated usage history.

Full URL: https://weidubot.cc/api/v2/query_energy_smart

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`address` Required	query string	TRON address to query Example: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`page` Required	query integer	Page number, starting at 1 Minimum: `1` Example: `1`

Responses

HTTP 200 Query successful.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	EnergySmartQueryResponseData Not marked required	Smart delegation address query result.

HTTP 400 Bad request: invalid address or page

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: service inactive or address belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Update smart delegation status

Update smart delegation status

Start ("start") or pause ("stop") smart delegation for an address.

Full URL: https://weidubot.cc/api/v2/update_energy_smart

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`address`	string Required	TRON address to update Example: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`status`	string Required	Target status Enum: `"start"` / `"stop"` Example: `"start"`
`net_protect`	string Not marked required	Address Bandwidth protection mode Enum: `"open"` / `"close"` Example: `"open"`

Responses

HTTP 200 Status updated; returns the current status.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	EnergySmartData Not marked required	Address status after a smart delegation update.

HTTP 400 Bad request: invalid address or status

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: service inactive or address belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 409 Conflict: already in the target status

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 429 Too many requests, if locking is implemented

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Get smart delegation statistics

Get smart delegation statistics

Usage by address for today, yesterday, this week, this month and the last 5 days, split into 65k/131k.

Full URL: https://weidubot.cc/api/v2/statistics_smart_by_address

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`address` Required	query string	TRON address for statistics Example: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`

Responses

HTTP 200 Statistics retrieved.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	StatisticsSmartData Not marked required	Smart delegation statistics by address.

HTTP 400 Bad request: invalid address format

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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

Energy units

Unit-based Energy API operations.

GET/get_times_price Get unit-based Energy price

Get unit-based Energy price

Get the current per-transaction unit price.

Full URL: https://weidubot.cc/api/v2/get_times_price

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Responses

HTTP 200 Prices retrieved.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	TimesPriceData Not marked required	Unit-based Energy pricing.

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: price unavailable

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Add Energy units

Add Energy units

Add Energy transaction units to an address, billed per use.

Full URL: https://weidubot.cc/api/v2/delegate_energy_times

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`address`	string Required	TRON address receiving units Example: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`times`	integer Required	Units to add; positive integer Example: `100`

Responses

HTTP 200 Delegation successful.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	EnergyTimesDelegateResponseData Not marked required	Unit delegation success data.

HTTP 400 Bad request: invalid address or unit count

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 429 Too many requests, if locking is implemented

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error, e.g. database error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Query Energy unit status

Query Energy unit status

Get remaining units, service status and paginated usage records for an address.

Full URL: https://weidubot.cc/api/v2/query_energy_times

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`address` Required	query string	TRON address to query Example: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`page` Required	query integer	Page number, starting at 1 Minimum: `1` Example: `1`

Responses

HTTP 200 Query successful.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	EnergyTimesQueryResponseData Not marked required	Unit-based service address query result.

HTTP 400 Bad request: invalid address or page

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: service inactive or address belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Update address unit-service status

Update address unit-service status

Start ("start") or pause ("stop") unit-based Energy for an address.

Full URL: https://weidubot.cc/api/v2/update_energy_times

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`address`	string Required	TRON address to update Example: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`status`	string Required	Target status Enum: `"start"` / `"stop"` Example: `"stop"`

Responses

HTTP 200 Status updated; returns the current status.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	EnergyTimesData Not marked required	Address status after a unit-service update.

HTTP 400 Bad request: invalid address or status

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: service inactive or address belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 409 Conflict: already in the target status

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 429 Too many requests, if locking is implemented

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Get Energy unit statistics

Get Energy unit statistics

Energy units consumed by address for today, yesterday, this week, this month and the last 5 days.

Full URL: https://weidubot.cc/api/v2/statistics_times_by_address

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`address` Required	query string	TRON address for statistics Example: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`

Responses

HTTP 200 Statistics retrieved.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	StatisticsTimesData Not marked required	Energy unit statistics by address.

HTTP 400 Bad request: invalid address format

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 services

Order Telegram Premium and Stars via Fragment.

POST/buy_premium Buy Telegram Premium

Buy Telegram Premium

Create an order to gift Premium to a Telegram user.

Full URL: https://weidubot.cc/api/v2/buy_premium

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`username`	string Required	Target Telegram username, without @. Example: `"telegram_user"`
`month`	integer Required	Number of months to purchase. Enum: `3` / `6` / `12` Example: `3`

Responses

HTTP 200 Order submitted.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	PremiumOrderResponseData Not marked required	Premium order submission result.

HTTP 400 Bad request: invalid username or months

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 403 Forbidden: insufficient balance

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Query Premium order

Query Premium order

Get a Premium order's status and details.

Full URL: https://weidubot.cc/api/v2/query_premium_order

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`order_id` Required	query integer	Internal order ID to query Example: `5678`

Responses

HTTP 200 Order details retrieved.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	PremiumQueryResultData Not marked required	Premium order query result.

HTTP 400 Bad request: invalid order ID

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: order missing or belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Buy Telegram Stars

Buy Telegram Stars

Create an order to send Stars to a Telegram user.

Full URL: https://weidubot.cc/api/v2/buy_star

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`username`	string Required	Target Telegram username, without @. Example: `"channel_owner"`
`count`	integer Required	Number of Stars, 50–10000. Minimum: `50` Maximum: `10000` Example: `100`

Responses

HTTP 200 Order submitted.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	StarOrderResponseData Not marked required	Stars order submission result.

HTTP 400 Bad request: invalid username or quantity

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 403 Forbidden: insufficient balance

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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 Query Stars order

Query Stars order

Get a Stars order's status and details.

Full URL: https://weidubot.cc/api/v2/query_star_order

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`
`order_id` Required	query integer	Internal order ID to query Example: `91011`

Responses

HTTP 200 Order details retrieved.

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	StarQueryResultData Not marked required	Stars order query result.

HTTP 400 Bad request: invalid order ID

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 404 Not found: order missing or belongs to another user

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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

Address consolidation

Manage automatic USDT consolidation addresses.

POST/submit_converge_address Submit consolidation settings

Submit consolidation settings

Configure automatic USDT consolidation rules for a TRON address.

Full URL: https://weidubot.cc/api/v2/submit_converge_address

Headers and parameters

Parameter	Location / type	Description and constraints
`x-api-key` Required	header string	Your API Key.
`x-timestamp` Required	header integer	Current UNIX timestamp in seconds. Example: `1711961879`
`x-signature` Required	header string	Signature (lowercase hex HMAC-SHA256 of `x-api-key` + `x-timestamp` ). Example: `"a1b2c3d4e5f6..."`

Body · application/x-www-form-urlencoded

Request body required

Form field	Type / required	Description and constraints
`address`	string Required	TRON address to configure Example: `"TConvergeAddressxxxxxxxxxxxxxxxxxx"`
`mode`	string Required	Consolidation mode Enum: `"once"` / `"keep"` Example: `"keep"`
`transfer_threshold`	number · float Required	Minimum balance threshold to trigger consolidation Example: `100`
`balance_min`	number · float Required	Minimum balance retained after consolidation Example: `10`
`balance_max`	number · float Required	Maximum retained balance, must be >= min Example: `20`
`energy_count`	integer Required	Energy supplied for consolidation Example: `65000`
`type`	string Required	Service type provided to the address Enum: `"energy"` / `"all"` Example: `"all"`
`notify_callback`	string · url Not marked required	Optional callback URL for consolidation notifications Nullable Example: `"https://yourcallback.com/notify"`

Responses

HTTP 200 Settings submitted

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Response data payload. Nullable

HTTP 400 Bad request: invalid parameters

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 401 Unauthorized

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 409 Conflict: an active configuration already exists for this address

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

HTTP 500 Internal server error

application/json · Click a type for full fields

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

View the complete OpenAPI definition

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

Complete data models

These fields match the current V2 definition. Successful responses usually wrap data in code , msg , time , data ; see each model for business-specific fields.

BaseResponse Field definition

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 1 for success, 0 for failure. Enum: `1` Example: `1`
`msg`	string Required	Response message. Example: `"操作成功"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Response data payload. Nullable

Original model definition

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 Field definition

Field	Type / required	Description and constraints
`code`	integer Required	Status code: 0 for failure. Enum: `0` Example: `0`
`msg`	string Required	Error message description. Example: `"参数错误"`
`time`	string Required	Server response timestamp. Example: `"1711961879"`
`data`	object Not marked required	Nullable Example: `null`

Original model definition

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 Response data after submitting account activation.

Response data after submitting account activation.

Field	Type / required	Description and constraints
`tx_id`	string Required	Transaction hash; usually populated after the background job completes, initially empty. Example: `""`
`order_id`	integer Required	Internal order ID tracking activation. Example: `12345`

Original model definition

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 Data returned after an Energy order is submitted.

Data returned after an Energy order is submitted.

Field	Type / required	Description and constraints
`order_sn`	string Required	Unique order serial number. Example: `"EN2025040217175512345"`
`price`	number · float Not marked required	Calculated unit Energy price in SUN. Nullable Example: `35000000`
`fee`	number · float Not marked required	Additional fee in TRX. Nullable Example: `0.56`
`amount`	number · float Not marked required	Total order cost in TRX. Nullable Example: `5.65`
`balance`	number · float Not marked required	Account balance after the operation; may be inaccurate or omitted. Nullable Example: `94.35`

Original model definition

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 Data returned after a Bandwidth order is submitted.

Data returned after a Bandwidth order is submitted.

Field	Type / required	Description and constraints
`order_sn`	string Required	Unique order serial number. Example: `"NET2025040217180012345"`
`amount`	number · float Not marked required	Total order cost in TRX. Nullable Example: `2.1`
`price`	number · float Not marked required	Calculated unit Bandwidth price; source lists unit as SUN? Nullable Example: `420000`
`fee`	number · float Not marked required	Additional fee in TRX. Nullable Example: `0`
`balance`	number · float Not marked required	Account balance after the operation; may be inaccurate or omitted. Nullable Example: `97.9`

Original model definition

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 Details of a successfully queried order.

Details of a successfully queried order.

Field	Type / required	Description and constraints
`order_sn`	string Required
`amount`	number · float Not marked required	Order amount in TRX Nullable
`price`	number · float Not marked required	Order unit price in SUN Nullable
`fee`	number · float Not marked required	Order fee in TRX Nullable
`period`	string Required	Period name
`status`	string Required	Order status code
`orders`	array<object> Required	Child delegation orders

Original model definition

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 Basic details of a failed or unfinished order.

Basic details of a failed or unfinished order.

Field	Type / required	Description and constraints
`order_sn`	string Required
`amount`	number · float Not marked required	Nullable
`price`	number · float Not marked required	Nullable
`fee`	number · float Not marked required	Nullable
`period`	string Not marked required	Nullable
`status`	string Required	Order status code
`orders`	array<object> Required	Empty array

Original model definition

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 User information result.

User information result.

Field	Type / required	Description and constraints
`balance_trx`	string Required	Available TRX balance as a formatted string. Example: `"100.5000"`
`balance_usdt`	string Required	Available USDT balance as a formatted string. Example: `"500.0000"`

Original model definition

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 Resource price result.

Resource price result.

Field	Type / required	Description and constraints
`price`	integer Required	Unit price in SUN per period. Example: `35`
`amount`	string Required	Estimated total in TRX for the requested quantity, including applicable fees. Example: `"5.6500"`
`fee`	string Required	Additional fee in TRX, e.g. a small-order fee. Example: `"0.5600"`
`remark`	string Required	Additional pricing notes, e.g. fee details. Example: `"包含 0.56 TRX 带宽手续费"`

Original model definition

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 Recharge price result

Recharge price result

Field	Type / required	Description and constraints
`price`	integer Required	Unit price in SUN. Example: `100`
`amount`	string Required	Estimated total in TRX for the requested quantity, including applicable fees. Example: `"5.6500"`
`fee`	string Required	Additional fee in TRX, e.g. a small-order fee. Example: `"0.5600"`

Original model definition

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 Smart delegation pricing.

Smart delegation pricing.

Field Type / required Description and constraints

65K_price

string Required

TRX price per 65K Energy delegation.

Example: "0.5000"

131K_price

string Required

TRX price per 131K Energy delegation.

Example: "0.9500"

remark

string Not marked required

Nullable
Example: "价格单位：TRX/次"

high_frequency

object Not marked required

High-frequency pricing, deposit and statistics period.

Nested field	Type / required	Description and constraints
`65k_price`	string Not marked required	High-frequency 65K price. Nullable Example: `"0.8000"`
`131k_price`	string Not marked required	High-frequency 131K price. Nullable Example: `"1.5000"`
`deposit_period`	string Not marked required	High-frequency statistics period in hours Nullable Example: `"72"`
`deposit_amount`	string Not marked required	High-frequency deposit in TRX Nullable Example: `1000`
`min_energy_count`	string Not marked required	Minimum Energy usage in high-frequency mode Nullable Example: `200000`

jisu_frequency

object Not marked required

Fast-mode pricing, deposit and statistics period.

Nested field	Type / required	Description and constraints
`65k_price`	string Not marked required	Fast-mode 65K price. Nullable Example: `"0.8000"`
`131k_price`	string Not marked required	Fast-mode 131K price. Nullable Example: `"1.5000"`
`deposit_period`	string Not marked required	Fast-mode statistics period in hours Nullable Example: `"72"`
`deposit_amount`	string Not marked required	Fast-mode deposit in TRX Nullable Example: `1000`
`min_energy_count`	string Not marked required	Minimum Energy usage in fast mode Nullable Example: `200000`

guangsu_frequency

object Not marked required

Light-speed pricing, deposit and statistics period.

Nested field	Type / required	Description and constraints
`65k_price`	string Not marked required	Light-speed 65K price. Nullable Example: `"0.8000"`
`131k_price`	string Not marked required	Light-speed 131K price. Nullable Example: `"1.5000"`
`deposit_period`	string Not marked required	Light-speed statistics period in hours Nullable Example: `"72"`
`deposit_amount`	string Not marked required	Light-speed deposit in TRX Nullable Example: `1000`
`min_energy_count`	string Not marked required	Minimum Energy usage in light-speed mode Nullable Example: `200000`

Original model definition

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

TimesPriceData Unit-based Energy pricing.

Unit-based Energy pricing.

Field	Type / required	Description and constraints
`price`	string Required	TRX price per Energy delegation. Example: `"0.6000"`
`remark`	string Not marked required	Nullable Example: `"价格单位：TRX/笔"`

Original model definition

OpenAPI · JSON

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

EnergyTimesDelegateResponseData Unit delegation success data.

Unit delegation success data.

Field	Type / required	Description and constraints
`address`	string Required	Target delegation address
`remain_times`	integer Required	Units remaining after operation
`status`	string Required	Current service status Enum: `"start"` / `"stop"`

Original model definition

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 Energy unit usage record

Energy unit usage record

Field	Type / required	Description and constraints
`remain_times`	integer Not marked required	Units remaining after this usage Nullable
`status`	string Not marked required	Energy status Nullable Enum: `"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`speed_mode`	string Not marked required	Energy mode Nullable Enum: `"normal"` / `"low_speed"`
`used_tx_id`	string Not marked required	Transaction hash that consumed Energy Nullable
`used_energy`	integer Not marked required	Energy consumed Nullable
`delegate_tx_id`	string Not marked required	Energy delegation transaction hash Nullable
`delegate_time`	integer Not marked required	Delegation timestamp Nullable
`un_delegate_tx_id`	string Not marked required	Energy reclaim transaction hash Nullable
`un_delegate_time`	integer Not marked required	Reclaim timestamp Nullable
`createtime`	integer Not marked required	Record creation timestamp Nullable

Original model definition

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": "记录创建时间戳"
    }
  }
}

EnergyTimesQueryResponseData Unit-based service address query result.

Unit-based service address query result.

Field	Type / required	Description and constraints
`address`	string Required	TRON address
`remain_times`	integer Required	Available units remaining
`status`	string Required	Service status: enabled / paused Enum: `"start"` / `"stop"`
`order_count`	integer Required	Total usage record count
`page_size`	integer Required	Records per page
`page`	integer Required	Current page number
`orders`	array<EnergyTimesOrderItem> Required	Usage records on the current page

Original model definition

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

EnergyTimesData Address status after a unit-service update.

Address status after a unit-service update.

Field	Type / required	Description and constraints
`address`	string Required	TRON address
`remain_times`	integer Required	Available units remaining
`status`	string Required	Service status: enabled / paused Enum: `"start"` / `"stop"`

Original model definition

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 Smart delegation success data.

Smart delegation success data.

Field	Type / required	Description and constraints
`address`	string Required	Target delegation address
`balance`	string Required	Total balance after operation, formatted string
`status`	string Required	Current service status Enum: `"start"` / `"stop"`
`net_protect`	string Not marked required	Bandwidth mode Enum: `"open"` / `"close"`

Original model definition

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 Smart delegation usage record

Smart delegation usage record

Field	Type / required	Description and constraints
`energy_type`	string Not marked required	Energy type: 65k = 65K, 131k = 131K Nullable
`amount`	number · float Not marked required	Amount spent Nullable
`balance`	number · float Not marked required	Balance after usage Nullable
`currency`	string Not marked required	Currency Nullable Enum: `"trx"` / `"usdt"`
`status`	string Not marked required	Energy status Nullable Enum: `"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`used_tx_id`	string Not marked required	Transaction hash that consumed Energy Nullable
`speed_mode`	string Not marked required	Energy mode Nullable Enum: `"normal"` / `"low_speed"`
`used_energy`	integer Not marked required	Energy consumed Nullable
`used_times`	integer Not marked required	Units used Nullable
`remain_times`	integer Not marked required	Total units remaining for the address Nullable
`delegate_count`	integer Not marked required	Delegated Energy amount Nullable
`delegate_tx_id`	string Not marked required	Energy delegation transaction hash Nullable
`delegate_time`	integer Not marked required	Delegation timestamp Nullable
`un_delegate_tx_id`	string Not marked required	Energy reclaim transaction hash Nullable
`un_delegate_time`	integer Not marked required	Reclaim timestamp Nullable
`createtime`	integer Not marked required	Record creation timestamp Nullable

Original model definition

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 Smart delegation address query result.

Smart delegation address query result.

Field	Type / required	Description and constraints
`address`	string Required	TRON address
`balance`	string Required	Available credit remaining, formatted string
`status`	string Required	Service status: enabled / paused Enum: `"start"` / `"stop"`
`order_count`	integer Required	Total usage record count
`page_size`	integer Required	Records per page
`page`	integer Required	Current page number
`orders`	array<EnergySmartOrderItem> Required	Usage records on the current page

Original model definition

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 status after a smart delegation update.

Address status after a smart delegation update.

Field	Type / required	Description and constraints
`address`	string Required	TRON address
`balance`	string Required	Available credit remaining, formatted string
`status`	string Required	Service status: enabled / paused Enum: `"start"` / `"stop"`
`net_protect`	string Not marked required	Bandwidth mode Enum: `"open"` / `"close"`

Original model definition

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 Smart delegation statistics for one period.

Smart delegation statistics for one period.

Field	Type / required	Description and constraints
`65k`	integer Required	65k operation count Example: `8`
`131k`	integer Required	131k operation count Example: `15`

Original model definition

OpenAPI · JSON

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

StatisticsSmartData Smart delegation statistics by address.

Smart delegation statistics by address.

Field	Type / required	Description and constraints
`days`	object Required	Statistics for the last 5 days, keyed by YYYY-MM-DD. Dynamic key value: StatisticsDetail
`today`	StatisticsDetail Required	Today's statistics
`yesterday`	StatisticsDetail Required	Yesterday's statistics
`this_week`	StatisticsDetail Required	This week, Monday to now
`this_month`	StatisticsDetail Required	This month, from the 1st to now

Original model definition

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

StatisticsTimesData Energy unit statistics by address.

Energy unit statistics by address.

Field	Type / required	Description and constraints
`days`	object Required	Statistics for the last 5 days, keyed by YYYY-MM-DD. Dynamic key value: integer
`today`	integer Required	Total units today Example: `5`
`yesterday`	integer Required	Total units yesterday Example: `8`
`this_week`	integer Required	Total units this week, since Monday Example: `30`
`this_month`	integer Required	Total units this month, since the 1st Example: `150`

Original model definition

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 Field definition

Field	Type / required	Description and constraints
`username`	string Required	Target Telegram username, without @. Example: `"telegram_user"`
`month`	integer Required	Number of months to purchase. Enum: `3` / `6` / `12` Example: `3`

Original model definition

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 Field definition

Field	Type / required	Description and constraints
`username`	string Required	Target Telegram username, without @. Example: `"channel_owner"`
`count`	integer Required	Number of Stars, 50–10000. Minimum: `50` Maximum: `10000` Example: `100`

Original model definition

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

PremiumOrderResponseData Premium order submission result.

Premium order submission result.

Field	Type / required	Description and constraints
`username`	string Required	Target username
`period`	string Required	Purchase period, e.g. "3month"
`order_id`	integer Required	Internal order ID
`amount`	number · float Required	Order amount in TRX
`price`	number · float Required	Price information
`pay_status`	string Required	Payment status
`status`	string Required	Order processing status

Original model definition

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 Stars order submission result.

Stars order submission result.

Field	Type / required	Description and constraints
`username`	string Required	Target username
`count`	integer Required	Number of Stars purchased
`order_id`	integer Required	Internal order ID
`amount`	number · float Required	Order amount in TRX
`price`	number · float Required	Price information
`pay_status`	string Required	Payment status
`status`	string Required	Order processing status

Original model definition

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

PremiumQueryResultData Premium order query result.

Premium order query result.

Field	Type / required	Description and constraints
`username`	string Not marked required	Target username Nullable
`nickname`	string Not marked required	Target user's display name Nullable
`period`	string Not marked required	Purchase period Nullable
`order_id`	integer Required	Order ID
`amount`	number · float Required	Order amount in TRX
`price`	number · float Required	Price information
`pay_status`	string Required	Payment status
`status`	string Required	Order processing status
`remark`	string Not marked required	Truncated note or failure reason Nullable
`create_time`	string · date-time Not marked required	Order creation time Nullable

Original model definition

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 Stars order query result.

Stars order query result.

Field	Type / required	Description and constraints
`username`	string Not marked required	Target username Nullable
`nickname`	string Not marked required	Target user's display name Nullable
`count`	integer Not marked required	Number of Stars purchased Nullable
`order_id`	integer Required	Order ID
`amount`	number · float Required	Order amount in TRX
`price`	number · float Required	Price information
`pay_status`	string Required	Payment status
`status`	string Required	Order processing status
`remark`	string Not marked required	Truncated note or failure reason Nullable
`create_time`	string · date-time Not marked required	Order creation time Nullable

Original model definition

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 Field definition

Field	Type / required	Description and constraints
`address`	string Required	TRON address receiving resources Example: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer Required	Amount of Energy or Bandwidth to top up Example: `65000`
`resource_type`	string Required	Resource type Enum: `"energy"` / `"net"` Example: `"energy"`

Original model definition

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 Recharge order query result.

Recharge order query result.

Field	Type / required	Description and constraints
`order_id`	integer Required	Internal order ID
`address`	string Required	Target address
`energy_count`	integer Required	Requested Energy or Bandwidth amount
`price`	number · float Not marked required	Unit price in SUN Nullable
`fee`	number · float Not marked required	Fee in TRX Nullable
`resource_type`	string Required	Resource type Enum: `"energy"` / `"net"`
`amount`	number · float Not marked required	Total amount in TRX Nullable
`status`	string Required	Order status Enum: `"waiting"` / `"success"` / `"failed"`
`delegate_txid`	string Not marked required	Delegation transaction hash Nullable
`reclaim_txid`	string Not marked required	Reclaim transaction hash Nullable
`actual_recover_count`	integer Not marked required	Actual top-up amount Nullable

Original model definition

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

API version 2.1.0 · Verified 2026-09-30

API definition source: API V2 documentation . This site provides setup guidance and preserves the full definition. Recheck it when the upstream service changes.

Download the full OpenAPI file

Bring Energy services into your application

Open an account before integrating

Three headers and one signature

Node.js: sign and query balance

Check the available balance after a deposit

Use each endpoint's specified method

Example: rent Energy for 1 hour

Find the right endpoints

Instant recharge

Smart delegation

Timed rental

Complete API reference 25

Account management

Activate a TRON address

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Get user information

Headers and parameters

Responses

Resource orders

Buy timed Energy

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Buy timed Bandwidth

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Reclaim Energy

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Query order result

Headers and parameters

Responses

Query resource price

Headers and parameters

Responses

Instant recharge

Query recharge price

Headers and parameters

Responses

Recharge Energy or Bandwidth

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Query recharge order

Headers and parameters

Responses

Smart delegation

Get smart delegation prices

Headers and parameters

Responses

Add smart delegation credit

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Query smart delegation status

Headers and parameters

Responses

Update smart delegation status

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Get smart delegation statistics

Headers and parameters

Responses

Energy units

Get unit-based Energy price

Headers and parameters

Responses

Add Energy units

Headers and parameters

Body · application/x-www-form-urlencoded

Responses

Query Energy unit status

Headers and parameters

Responses

Update address unit-service status

Bring Energy services
into your application