DUIYA DEVELOPERS / API V2

Добавьте энергию
в ваше приложение

API DuiYa: проверка баланса, аренда энергии и управление адресами.
От открытия аккаунта до первого запроса — всё здесь.

Открыть аккаунт · @wanglei Скачать OpenAPI

duiya.org / api

GET/user_info

balance_trx Баланс TRX

balance_usdt Баланс USDT

API V2 2.1.0 Справочник API 25 ENDPOINTS

01 / GET STARTED

Сначала откройте аккаунт

Сначала свяжитесь в Telegram с @wanglei для открытия доступа к панели.

После активации войдите по адресу панели от поддержки. Уточните пополнение, баланс, права API и цены до подключения.

Войдите в панель В настройках пользователя API проверьте аккаунт и доступный баланс после пополнения.
Добавьте разрешённые IP Укажите внешний IP сервера, выполняющего запросы. Обновляйте список при смене сервера или IP.
Включите доступ API Сохраните настройки и проверьте права нужных услуг.
Получите API Key и API Secret Подписывайте запросы на сервере по правилам ниже. Сначала проверьте настройку запросом баланса.

Пополнение и разрешённые IP настраиваются в панели. В публичном V2 нет методов добавления IP или истории пополнений; /user_info возвращает текущий доступный баланс.

02 / AUTHENTICATION

Три заголовка и подпись

Все методы используют ключ и подпись. API Secret применяется только для подписи на сервере и не отправляется как параметр.

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

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

Соедините API Key и timestamp без разделителя. Результат — нижний hex. Время в секундах, отклонение от сервера не более ±5 минут.

Node.js: подпись и баланс

Node.js · Серверный пример

import { createHmac } from 'node:crypto';

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

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

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

Храните ключи в переменных окружения сервера. Timestamp заголовка и подписи должен совпадать.

03 / ACCOUNT BALANCE

Проверка баланса после пополнения

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

Параметры не нужны; добавьте три заголовка аутентификации. Читайте data.balance_trx и data.balance_usdt , оба значения — форматированные строки.

JSON · Пример, не реальный баланс

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

По пополнению, входу и разрешённым IP обращайтесь к @wanglei . Все поля ответа: /user_info .

04 / REQUEST FORMAT

Используйте указанный метод

Адрес документации: https://duiya.org/api/
Базовый URL API: https://weidubot.cc/api/v2
Путь покупки энергии: /buy_energy
Полный URL запроса: https://weidubot.cc/api/v2/buy_energy

Параметры GET передаются в URL. Для POST используйте форму или query согласно определению. Покупка энергии требует POST, а не GET. Аутентификация всегда в заголовках.

Примечание: /query_fast_recover_price использует POST, но resource_type и count в текущем определении передаются в query URL.

Пример: аренда на 1 час

cURL · Замените все заполнители

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

Запрос создаёт платный заказ. Сначала используйте /query_price для проверки цены, адреса, объёма, срока и баланса. После отправки асинхронного заказа используйте /query_result для проверки результата исполнения.

На duiya.org размещена документация; запросы идут по адресу сервиса выше. Цены, балансы и суммы примеров не являются актуальными котировками.

05 / ENERGY SERVICES

Найдите нужные методы

01 / FAST RECOVER

Быстрое пополнение

Узнайте цену, купите энергию или пропускную способность и проверьте заказ.

/query_fast_recover_price/buy_fast_recover/query_fast_recover_order

02 / SMART DELEGATION

Автоуправление

Цены управления, выделение средств, адреса и история расхода.

/get_smart_price/delegate_energy_smart/query_energy_smart

03 / ENERGY RENTAL

Аренда на срок

Цена по объёму и сроку, затем проверка результата заказа.

/query_price/buy_energy/query_result

Также описаны энергия по единицам, активация адресов, сбор средств и Fragment. Доступность и цены зависят от прав аккаунта и ответа API.

06 / ENDPOINT REFERENCE

Полный справочник API 25

Разверните метод для параметров, полей ответа и определения. Название типа ведёт к модели данных.

Найти метод

Показаны все 25 методов

Аккаунт

Данные пользователя и активация аккаунта.

POST/active_account Активировать адрес TRON

Активировать адрес TRON

Запрос активации адреса. Соответствующая плата списывается с баланса.

Полный URL: https://weidubot.cc/api/v2/active_account

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Активируемый адрес TRON Пример: `"TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"`

Ответы

HTTP 200 Запрос активации отправлен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	ActivationData Не отмечено обязательным	Данные после запроса активации.

HTTP 400 Ошибка запроса, например формат адреса

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован: ошибка аутентификации

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 403 Запрещено, например мало средств

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/user_info Получить данные пользователя

Получить данные пользователя

Получить данные авторизованного пользователя, включая баланс.

Полный URL: https://weidubot.cc/api/v2/user_info

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Ответы

HTTP 200 Данные пользователя получены.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	UserInfoData Не отмечено обязательным	Результат запроса пользователя.

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

Заказы ресурсов

Покупка энергии и пропускной способности на срок, управление заказами.

POST/buy_energy Купить энергию на срок

Купить энергию на срок

Асинхронный заказ делегирования энергии адресу на заданный срок.

Полный URL: https://weidubot.cc/api/v2/buy_energy

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`count`	integer Обязательный	Количество энергии, минимум 30000 Пример: `50000`
`period`	string Обязательный	Период: "15minutes", "1h", "1day", "3day" Пример: `"1day"`
`address`	string Обязательный	Адрес TRON для энергии Пример: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

Ответы

HTTP 200 Заказ успешно отправлен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	EnergyOrderResponseData Не отмечено обязательным	Данные после отправки заказа энергии.

HTTP 400 Ошибка: параметры, неактивный адрес и т. п.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 403 Запрещено: мало средств или неверный статус

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/buy_net Купить пропускную способность

Купить пропускную способность

Асинхронный заказ делегирования пропускной способности на заданный срок.

Полный URL: https://weidubot.cc/api/v2/buy_net

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`count`	integer Обязательный	Байты пропускной способности, минимум 100 Пример: `5000`
`period`	string Обязательный	Период: "1day", "3day" Пример: `"3day"`
`address`	string Обязательный	Адрес TRON для пропускной способности Пример: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

Ответы

HTTP 200 Заказ успешно отправлен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	NetOrderResponseData Не отмечено обязательным	Данные после заказа пропускной способности.

HTTP 400 Ошибка запроса

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 403 Запрещено

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/reclaim_energy Отозвать энергию

Отозвать энергию

Асинхронно отозвать ресурсы по номеру выполненного заказа и адресу.

Полный URL: https://weidubot.cc/api/v2/reclaim_energy

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`order_sn`	string Обязательный	Номер исходного заказа Пример: `"EN2025040217175512345"`
`address`	string Обязательный	Исходный адрес получения ресурсов Пример: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`

Ответы

HTTP 200 Запрос отзыва отправлен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Полезная нагрузка ответа. Допускается null

HTTP 400 Ошибка: неверный номер или адрес

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Не найдено: заказ, владелец или подходящие ресурсы

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/query_result Проверить результат заказа

Проверить результат заказа

Получить состояние и детали заказа ресурсов.

Полный URL: https://weidubot.cc/api/v2/query_result

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`order_sn` Обязательный	query string	Уникальный номер заказа Пример: `"EN2025040217175512345"`

Ответы

HTTP 200 Детали получены. Структура data зависит от успеха или ошибки заказа.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	QueryResultDataSuccess или QueryResultDataFailed Не отмечено обязательным

HTTP 400 Ошибка: формат номера заказа

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Заказ не найден или принадлежит другому пользователю

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Ошибка сервера или запроса

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/query_price Узнать цену ресурса

Узнать цену ресурса

Расчёт цены по типу (energy или net), количеству и сроку.

Полный URL: https://weidubot.cc/api/v2/query_price

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`type` Обязательный	query string	Тип ресурса ("energy", "net") Значения: `"energy"` / `"net"` Пример: `"energy"`
`count` Обязательный	query integer	Единицы энергии или байты пропускной способности Пример: `50000`
`period` Обязательный	query string	Период: "15minutes", "1h", "1day", "3day" Пример: `"1day"`

Ответы

HTTP 200 Цена рассчитана.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	ResourcePriceData Не отмечено обязательным	Результат расчёта цены.

HTTP 400 Ошибка: неверные параметры

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Цена не настроена или недоступна

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

Быстрое пополнение

Быстрое пополнение энергии и пропускной способности.

POST/query_fast_recover_price Узнать цену пополнения

Узнать цену пополнения

Получить цену пополнения.

Полный URL: https://weidubot.cc/api/v2/query_fast_recover_price

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`resource_type` Обязательный	query string	Тип ресурса ("energy", "net") Значения: `"energy"` / `"net"` Пример: `"energy"`
`count` Обязательный	query integer	Количество энергии или пропускной способности Пример: `100000`

Ответы

HTTP 200 Цена рассчитана.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	FastRecoverPriceData Не отмечено обязательным	Результат цены пополнения

HTTP 400 Ошибка: неверные параметры

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Цена не настроена или недоступна

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/buy_fast_recover Пополнить ресурсы

Пополнить ресурсы

Однократно пополнить энергию или пропускную способность адреса.

Полный URL: https://weidubot.cc/api/v2/buy_fast_recover

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON для ресурсов Пример: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer Обязательный	Объём пополнения ресурсов Пример: `65000`
`resource_type`	string Обязательный	Тип ресурса Значения: `"energy"` / `"net"` Пример: `"energy"`

Ответы

HTTP 200 Запрос отправлен; проверьте статус позже.

application/json · Нажмите тип для всех полей

Поле Тип / обязательность Описание и ограничения

code

integer Обязательный

Код: 1 — успех, 0 — ошибка.

Значения: 1
Пример: 1

msg

string Обязательный

Сообщение ответа.

Пример: "操作成功"

time

string Обязательный

Timestamp ответа сервера.

Пример: "1711961879"

data

object Не отмечено обязательным

Вложенное поле	Тип / обязательность	Описание и ограничения
`order_id`	integer Не отмечено обязательным	ID заказа пополнения

HTTP 400 Ошибка: неверные параметры

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 403 Запрещено, например недостаточно средств

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/query_fast_recover_order Проверить пополнение

Проверить пополнение

Получить статус и детали пополнения.

Полный URL: https://weidubot.cc/api/v2/query_fast_recover_order

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`order_id` Обязательный	query integer	ID пополнения для запроса Пример: `123`

Ответы

HTTP 200 Запрос выполнен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	FastRecoverOrderResponseData Не отмечено обязательным	Результат запроса пополнения.

HTTP 400 Ошибка: неверный ID заказа

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Заказ отсутствует или принадлежит другому пользователю

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

Автоуправление

Операции автоматического управления энергией.

GET/get_smart_price Цены автоуправления

Цены автоуправления

Текущие цены автоуправления для 65K и 131K энергии.

Полный URL: https://weidubot.cc/api/v2/get_smart_price

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Ответы

HTTP 200 Цены получены.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	SmartPriceData Не отмечено обязательным	Цены автоуправления.

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Не найдена часть или все цены

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/delegate_energy_smart Добавить средства автоуправления

Добавить средства автоуправления

Увеличить доступный баланс автоуправления адреса.

Полный URL: https://weidubot.cc/api/v2/delegate_energy_smart

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON для пополнения Пример: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`balance`	number · float Обязательный	Положительная сумма, например в TRX Пример: `10.5`
`channel`	string Не отмечено обязательным	Режим: normal — обычный; high_frequency — частый; jisu_frequency — быстрый; guangsu_frequency — световой Значения: `"normal"` / `"high_frequency"` / `"jisu_frequency"` / `"guangsu_frequency"` Пример: `"high_frequency"`
`hf_deposit`	number Не отмечено обязательным	Депозит: -1 — системный; 0 — без депозита; иное число — сумма удержания Пример: `"0"`
`net_protect`	string Не отмечено обязательным	Режим защиты пропускной способности Значения: `"open"` / `"close"` Пример: `"open"`

Ответы

HTTP 200 Делегирование или пополнение выполнено

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	EnergySmartDelegateResponseData Не отмечено обязательным	Данные успешного делегирования.

HTTP 400 Ошибка: адрес или сумма

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 429 Слишком частые запросы, если есть блокировка

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/query_energy_smart Статус автоуправления

Статус автоуправления

Остаток средств, статус и история расхода адреса с пагинацией.

Полный URL: https://weidubot.cc/api/v2/query_energy_smart

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`address` Обязательный	query string	Адрес TRON для запроса Пример: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`page` Обязательный	query integer	Страница, начиная с 1 Минимум: `1` Пример: `1`

Ответы

HTTP 200 Запрос выполнен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	EnergySmartQueryResponseData Не отмечено обязательным	Результат запроса автоуправления адреса.

HTTP 400 Ошибка: адрес или страница

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Услуга не подключена или адрес другого пользователя

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/update_energy_smart Изменить статус автоуправления

Изменить статус автоуправления

Включить ("start") или приостановить ("stop") автоуправление адреса.

Полный URL: https://weidubot.cc/api/v2/update_energy_smart

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON для изменения Пример: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`
`status`	string Обязательный	Целевой статус Значения: `"start"` / `"stop"` Пример: `"start"`
`net_protect`	string Не отмечено обязательным	Режим защиты пропускной способности Значения: `"open"` / `"close"` Пример: `"open"`

Ответы

HTTP 200 Статус обновлён; возвращается текущее значение.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	EnergySmartData Не отмечено обязательным	Статус адреса после изменения автоуправления.

HTTP 400 Ошибка: адрес или статус

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Услуга не подключена или адрес другого пользователя

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 409 Конфликт: статус уже установлен

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 429 Слишком частые запросы, если есть блокировка

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/statistics_smart_by_address Статистика автоуправления

Статистика автоуправления

Расход адреса за сегодня, вчера, неделю, месяц и 5 дней, отдельно 65k/131k.

Полный URL: https://weidubot.cc/api/v2/statistics_smart_by_address

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`address` Обязательный	query string	Адрес TRON для статистики Пример: `"TSmartAddressxxxxxxxxxxxxxxxxxxxxx"`

Ответы

HTTP 200 Статистика получена.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	StatisticsSmartData Не отмечено обязательным	Статистика автоуправления по адресу.

HTTP 400 Ошибка: формат адреса

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

Энергия по единицам

API энергии по единицам.

GET/get_times_price Цена единицы энергии

Цена единицы энергии

Получить текущую цену за одну операцию.

Полный URL: https://weidubot.cc/api/v2/get_times_price

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Ответы

HTTP 200 Цены получены.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	TimesPriceData Не отмечено обязательным	Цена энергии по единицам.

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Цена недоступна

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/delegate_energy_times Добавить единицы энергии

Добавить единицы энергии

Добавить адресу единицы энергии с оплатой по использованию.

Полный URL: https://weidubot.cc/api/v2/delegate_energy_times

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON для добавления единиц Пример: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`times`	integer Обязательный	Добавляемые единицы, положительное целое Пример: `100`

Ответы

HTTP 200 Делегирование выполнено.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	EnergyTimesDelegateResponseData Не отмечено обязательным	Данные добавления единиц.

HTTP 400 Ошибка: адрес или количество

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 429 Слишком частые запросы, если есть блокировка

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Ошибка сервера, например базы данных

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/query_energy_times Статус единиц энергии

Статус единиц энергии

Остаток единиц, статус и история использования адреса с пагинацией.

Полный URL: https://weidubot.cc/api/v2/query_energy_times

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`address` Обязательный	query string	Адрес TRON для запроса Пример: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`page` Обязательный	query integer	Страница, начиная с 1 Минимум: `1` Пример: `1`

Ответы

HTTP 200 Запрос выполнен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	EnergyTimesQueryResponseData Не отмечено обязательным	Результат запроса единиц адреса.

HTTP 400 Ошибка: адрес или страница

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Услуга не подключена или адрес другого пользователя

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/update_energy_times Изменить статус услуги единиц

Изменить статус услуги единиц

Включить ("start") или приостановить ("stop") услугу единиц адреса.

Полный URL: https://weidubot.cc/api/v2/update_energy_times

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON для изменения Пример: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`
`status`	string Обязательный	Целевой статус Значения: `"start"` / `"stop"` Пример: `"stop"`

Ответы

HTTP 200 Статус обновлён; возвращается текущее значение.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	EnergyTimesData Не отмечено обязательным	Статус адреса после изменения услуги единиц.

HTTP 400 Ошибка: адрес или статус

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Услуга не подключена или адрес другого пользователя

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 409 Конфликт: статус уже установлен

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 429 Слишком частые запросы, если есть блокировка

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/statistics_times_by_address Статистика единиц энергии

Статистика единиц энергии

Расход единиц за сегодня, вчера, неделю, месяц и последние 5 дней.

Полный URL: https://weidubot.cc/api/v2/statistics_times_by_address

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`address` Обязательный	query string	Адрес TRON для статистики Пример: `"TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"`

Ответы

HTTP 200 Статистика получена.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	StatisticsTimesData Не отмечено обязательным	Статистика единиц по адресу.

HTTP 400 Ошибка: формат адреса

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

Услуги Fragment

Заказы Telegram Premium и Stars через Fragment.

POST/buy_premium Купить Telegram Premium

Купить Telegram Premium

Создать заказ подарка Premium пользователю Telegram.

Полный URL: https://weidubot.cc/api/v2/buy_premium

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`username`	string Обязательный	Имя пользователя Telegram без @. Пример: `"telegram_user"`
`month`	integer Обязательный	Количество месяцев. Значения: `3` / `6` / `12` Пример: `3`

Ответы

HTTP 200 Заказ отправлен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	PremiumOrderResponseData Не отмечено обязательным	Результат заказа Premium.

HTTP 400 Ошибка: имя пользователя или месяцы

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 403 Запрещено: недостаточно средств

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/query_premium_order Проверить заказ Premium

Проверить заказ Premium

Получить статус и детали заказа Premium.

Полный URL: https://weidubot.cc/api/v2/query_premium_order

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`order_id` Обязательный	query integer	Внутренний ID заказа Пример: `5678`

Ответы

HTTP 200 Детали заказа получены.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	PremiumQueryResultData Не отмечено обязательным	Результат запроса Premium.

HTTP 400 Ошибка: неверный ID заказа

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Заказ отсутствует или принадлежит другому пользователю

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

POST/buy_star Купить Telegram Stars

Купить Telegram Stars

Создать заказ отправки Stars пользователю Telegram.

Полный URL: https://weidubot.cc/api/v2/buy_star

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`username`	string Обязательный	Имя пользователя Telegram без @. Пример: `"channel_owner"`
`count`	integer Обязательный	Количество Stars: 50–10000. Минимум: `50` Максимум: `10000` Пример: `100`

Ответы

HTTP 200 Заказ отправлен.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	StarOrderResponseData Не отмечено обязательным	Результат заказа Stars.

HTTP 400 Ошибка: имя пользователя или количество

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 403 Запрещено: недостаточно средств

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

GET/query_star_order Проверить заказ Stars

Проверить заказ Stars

Получить статус и детали заказа Stars.

Полный URL: https://weidubot.cc/api/v2/query_star_order

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`
`order_id` Обязательный	query integer	Внутренний ID заказа Пример: `91011`

Ответы

HTTP 200 Детали заказа получены.

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	StarQueryResultData Не отмечено обязательным	Результат запроса Stars.

HTTP 400 Ошибка: неверный ID заказа

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 404 Заказ отсутствует или принадлежит другому пользователю

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

Сбор средств

Управление адресами автосбора USDT.

POST/submit_converge_address Настроить сбор средств

Настроить сбор средств

Настроить автосбор USDT для адреса TRON.

Полный URL: https://weidubot.cc/api/v2/submit_converge_address

Заголовки и параметры

Параметр	Расположение / тип	Описание и ограничения
`x-api-key` Обязательный	header string	Ваш API Key.
`x-timestamp` Обязательный	header integer	Текущий UNIX timestamp в секундах. Пример: `1711961879`
`x-signature` Обязательный	header string	Подпись (HMAC-SHA256 в нижнем hex от `x-api-key` + `x-timestamp` ). Пример: `"a1b2c3d4e5f6..."`

Тело · application/x-www-form-urlencoded

Тело запроса обязательно

Поле формы	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON для настройки Пример: `"TConvergeAddressxxxxxxxxxxxxxxxxxx"`
`mode`	string Обязательный	Режим сбора Значения: `"once"` / `"keep"` Пример: `"keep"`
`transfer_threshold`	number · float Обязательный	Минимальный баланс для запуска сбора Пример: `100`
`balance_min`	number · float Обязательный	Минимальный остаток после сбора Пример: `10`
`balance_max`	number · float Обязательный	Максимальный остаток, >= min Пример: `20`
`energy_count`	integer Обязательный	Энергия для сбора средств Пример: `65000`
`type`	string Обязательный	Тип услуги для адреса Значения: `"energy"` / `"all"` Пример: `"all"`
`notify_callback`	string · url Не отмечено обязательным	Необязательный URL уведомлений о сборе Допускается null Пример: `"https://yourcallback.com/notify"`

Ответы

HTTP 200 Настройки отправлены

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Полезная нагрузка ответа. Допускается null

HTTP 400 Ошибка: неверные параметры

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 401 Не авторизован

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 409 Конфликт: у адреса уже есть активная настройка

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

HTTP 500 Внутренняя ошибка сервера

application/json · Нажмите тип для всех полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Полное определение OpenAPI

OpenAPI · JSON

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

07 / DATA MODELS

Все модели данных

Поля соответствуют V2. Успешный ответ обычно обёрнут в code , msg , time , data ; поля конкретной услуги смотрите в модели.

BaseResponse Определение полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код: 1 — успех, 0 — ошибка. Значения: `1` Пример: `1`
`msg`	string Обязательный	Сообщение ответа. Пример: `"操作成功"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Полезная нагрузка ответа. Допускается null

Исходная модель

OpenAPI · JSON

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

ErrorResponse Определение полей

Поле	Тип / обязательность	Описание и ограничения
`code`	integer Обязательный	Код 0 — ошибка. Значения: `0` Пример: `0`
`msg`	string Обязательный	Описание ошибки. Пример: `"参数错误"`
`time`	string Обязательный	Timestamp ответа сервера. Пример: `"1711961879"`
`data`	object Не отмечено обязательным	Допускается null Пример: `null`

Исходная модель

OpenAPI · JSON

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

ActivationData Данные после запроса активации.

Данные после запроса активации.

Поле	Тип / обязательность	Описание и ограничения
`tx_id`	string Обязательный	Хеш транзакции: обычно появляется после фоновой задачи, сначала пустой. Пример: `""`
`order_id`	integer Обязательный	Внутренний ID отслеживания активации. Пример: `12345`

Исходная модель

OpenAPI · JSON

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

EnergyOrderResponseData Данные после отправки заказа энергии.

Данные после отправки заказа энергии.

Поле	Тип / обязательность	Описание и ограничения
`order_sn`	string Обязательный	Уникальный номер заказа. Пример: `"EN2025040217175512345"`
`price`	number · float Не отмечено обязательным	Рассчитанная цена энергии в SUN. Допускается null Пример: `35000000`
`fee`	number · float Не отмечено обязательным	Дополнительная комиссия в TRX. Допускается null Пример: `0.56`
`amount`	number · float Не отмечено обязательным	Полная стоимость в TRX. Допускается null Пример: `5.65`
`balance`	number · float Не отмечено обязательным	Баланс после операции; может быть неточным или отсутствовать. Допускается null Пример: `94.35`

Исходная модель

OpenAPI · JSON

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

NetOrderResponseData Данные после заказа пропускной способности.

Данные после заказа пропускной способности.

Поле	Тип / обязательность	Описание и ограничения
`order_sn`	string Обязательный	Уникальный номер заказа. Пример: `"NET2025040217180012345"`
`amount`	number · float Не отмечено обязательным	Полная стоимость в TRX. Допускается null Пример: `2.1`
`price`	number · float Не отмечено обязательным	Цена пропускной способности; единица в источнике: SUN? Допускается null Пример: `420000`
`fee`	number · float Не отмечено обязательным	Дополнительная комиссия в TRX. Допускается null Пример: `0`
`balance`	number · float Не отмечено обязательным	Баланс после операции; может быть неточным или отсутствовать. Допускается null Пример: `97.9`

Исходная модель

OpenAPI · JSON

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

QueryResultDataSuccess Детали успешно найденного заказа.

Детали успешно найденного заказа.

Поле	Тип / обязательность	Описание и ограничения
`order_sn`	string Обязательный
`amount`	number · float Не отмечено обязательным	Сумма заказа в TRX Допускается null
`price`	number · float Не отмечено обязательным	Цена единицы в SUN Допускается null
`fee`	number · float Не отмечено обязательным	Комиссия заказа в TRX Допускается null
`period`	string Обязательный	Название периода
`status`	string Обязательный	Код статуса заказа
`orders`	array<object> Обязательный	Дочерние заказы делегирования

Исходная модель

OpenAPI · JSON

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

QueryResultDataFailed Данные неудачного или незавершённого заказа.

Данные неудачного или незавершённого заказа.

Поле	Тип / обязательность	Описание и ограничения
`order_sn`	string Обязательный
`amount`	number · float Не отмечено обязательным	Допускается null
`price`	number · float Не отмечено обязательным	Допускается null
`fee`	number · float Не отмечено обязательным	Допускается null
`period`	string Не отмечено обязательным	Допускается null
`status`	string Обязательный	Код статуса заказа
`orders`	array<object> Обязательный	Пустой массив

Исходная модель

OpenAPI · JSON

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

UserInfoData Результат запроса пользователя.

Результат запроса пользователя.

Поле	Тип / обязательность	Описание и ограничения
`balance_trx`	string Обязательный	Доступный баланс TRX строкой. Пример: `"100.5000"`
`balance_usdt`	string Обязательный	Доступный баланс USDT строкой. Пример: `"500.0000"`

Исходная модель

OpenAPI · JSON

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

ResourcePriceData Результат расчёта цены.

Результат расчёта цены.

Поле	Тип / обязательность	Описание и ограничения
`price`	integer Обязательный	Цена единицы в SUN за период. Пример: `35`
`amount`	string Обязательный	Оценка итога в TRX для объёма, включая применимые сборы. Пример: `"5.6500"`
`fee`	string Обязательный	Дополнительный сбор в TRX, например за малый заказ. Пример: `"0.5600"`
`remark`	string Обязательный	Примечания к расчёту, например детали комиссии. Пример: `"包含 0.56 TRX 带宽手续费"`

Исходная модель

OpenAPI · JSON

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

FastRecoverPriceData Результат цены пополнения

Результат цены пополнения

Поле	Тип / обязательность	Описание и ограничения
`price`	integer Обязательный	Цена единицы в SUN. Пример: `100`
`amount`	string Обязательный	Оценка итога в TRX для объёма, включая применимые сборы. Пример: `"5.6500"`
`fee`	string Обязательный	Дополнительный сбор в TRX, например за малый заказ. Пример: `"0.5600"`

Исходная модель

OpenAPI · JSON

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

SmartPriceData Цены автоуправления.

Цены автоуправления.

Поле Тип / обязательность Описание и ограничения

65K_price

string Обязательный

Цена делегирования 65K в TRX.

Пример: "0.5000"

131K_price

string Обязательный

Цена делегирования 131K в TRX.

Пример: "0.9500"

remark

string Не отмечено обязательным

Допускается null
Пример: "价格单位：TRX/次"

high_frequency

object Не отмечено обязательным

Частый режим: цены, депозит, период статистики.

Вложенное поле	Тип / обязательность	Описание и ограничения
`65k_price`	string Не отмечено обязательным	Цена 65K частого режима. Допускается null Пример: `"0.8000"`
`131k_price`	string Не отмечено обязательным	Цена 131K частого режима. Допускается null Пример: `"1.5000"`
`deposit_period`	string Не отмечено обязательным	Период частого режима в часах Допускается null Пример: `"72"`
`deposit_amount`	string Не отмечено обязательным	Депозит частого режима в TRX Допускается null Пример: `1000`
`min_energy_count`	string Не отмечено обязательным	Минимум энергии частого режима Допускается null Пример: `200000`

jisu_frequency

object Не отмечено обязательным

Быстрый режим: цены, депозит и период.

Вложенное поле	Тип / обязательность	Описание и ограничения
`65k_price`	string Не отмечено обязательным	Цена 65K быстрого режима. Допускается null Пример: `"0.8000"`
`131k_price`	string Не отмечено обязательным	Цена 131K быстрого режима. Допускается null Пример: `"1.5000"`
`deposit_period`	string Не отмечено обязательным	Период быстрого режима в часах Допускается null Пример: `"72"`
`deposit_amount`	string Не отмечено обязательным	Депозит быстрого режима в TRX Допускается null Пример: `1000`
`min_energy_count`	string Не отмечено обязательным	Минимум энергии быстрого режима Допускается null Пример: `200000`

guangsu_frequency

object Не отмечено обязательным

Световой режим: цены, депозит и период.

Вложенное поле	Тип / обязательность	Описание и ограничения
`65k_price`	string Не отмечено обязательным	Цена 65K светового режима. Допускается null Пример: `"0.8000"`
`131k_price`	string Не отмечено обязательным	Цена 131K светового режима. Допускается null Пример: `"1.5000"`
`deposit_period`	string Не отмечено обязательным	Период светового режима в часах Допускается null Пример: `"72"`
`deposit_amount`	string Не отмечено обязательным	Депозит светового режима в TRX Допускается null Пример: `1000`
`min_energy_count`	string Не отмечено обязательным	Минимум энергии светового режима Допускается null Пример: `200000`

Исходная модель

OpenAPI · JSON

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

TimesPriceData Цена энергии по единицам.

Цена энергии по единицам.

Поле	Тип / обязательность	Описание и ограничения
`price`	string Обязательный	Цена одной делегации в TRX. Пример: `"0.6000"`
`remark`	string Не отмечено обязательным	Допускается null Пример: `"价格单位：TRX/笔"`

Исходная модель

OpenAPI · JSON

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

EnergyTimesDelegateResponseData Данные добавления единиц.

Данные добавления единиц.

Поле	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес делегирования
`remain_times`	integer Обязательный	Остаток единиц после операции
`status`	string Обязательный	Текущий статус услуги Значения: `"start"` / `"stop"`

Исходная модель

OpenAPI · JSON

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

EnergyTimesOrderItem Запись расхода единиц энергии

Запись расхода единиц энергии

Поле	Тип / обязательность	Описание и ограничения
`remain_times`	integer Не отмечено обязательным	Остаток после этого расхода Допускается null
`status`	string Не отмечено обязательным	Статус энергии Допускается null Значения: `"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`speed_mode`	string Не отмечено обязательным	Режим энергии Допускается null Значения: `"normal"` / `"low_speed"`
`used_tx_id`	string Не отмечено обязательным	Хеш транзакции расхода энергии Допускается null
`used_energy`	integer Не отмечено обязательным	Потраченная энергия Допускается null
`delegate_tx_id`	string Не отмечено обязательным	Хеш делегирования энергии Допускается null
`delegate_time`	integer Не отмечено обязательным	Время делегирования Допускается null
`un_delegate_tx_id`	string Не отмечено обязательным	Хеш отзыва энергии Допускается null
`un_delegate_time`	integer Не отмечено обязательным	Время отзыва Допускается null
`createtime`	integer Не отмечено обязательным	Время создания записи Допускается null

Исходная модель

OpenAPI · JSON

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

EnergyTimesQueryResponseData Результат запроса единиц адреса.

Результат запроса единиц адреса.

Поле	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON
`remain_times`	integer Обязательный	Доступный остаток единиц
`status`	string Обязательный	Статус: включён / пауза Значения: `"start"` / `"stop"`
`order_count`	integer Обязательный	Всего записей расхода
`page_size`	integer Обязательный	Записей на странице
`page`	integer Обязательный	Текущая страница
`orders`	array<EnergyTimesOrderItem> Обязательный	Записи расхода текущей страницы

Исходная модель

OpenAPI · JSON

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

EnergyTimesData Статус адреса после изменения услуги единиц.

Статус адреса после изменения услуги единиц.

Поле	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON
`remain_times`	integer Обязательный	Доступный остаток единиц
`status`	string Обязательный	Статус: включён / пауза Значения: `"start"` / `"stop"`

Исходная модель

OpenAPI · JSON

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

EnergySmartDelegateResponseData Данные успешного делегирования.

Данные успешного делегирования.

Поле	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес делегирования
`balance`	string Обязательный	Итоговый баланс после операции строкой
`status`	string Обязательный	Текущий статус услуги Значения: `"start"` / `"stop"`
`net_protect`	string Не отмечено обязательным	Режим пропускной способности Значения: `"open"` / `"close"`

Исходная модель

OpenAPI · JSON

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

EnergySmartOrderItem Запись расхода автоуправления

Запись расхода автоуправления

Поле	Тип / обязательность	Описание и ограничения
`energy_type`	string Не отмечено обязательным	Тип: 65k = 65K, 131k = 131K Допускается null
`amount`	number · float Не отмечено обязательным	Потраченная сумма Допускается null
`balance`	number · float Не отмечено обязательным	Баланс после расхода Допускается null
`currency`	string Не отмечено обязательным	Валюта Допускается null Значения: `"trx"` / `"usdt"`
`status`	string Не отмечено обязательным	Статус энергии Допускается null Значения: `"init"` / `"waiting_delegate"` / `"delegate_success"` / `"delegate_failed"` / `"waiting_un_delegate"` / `"un_delegate_success"` / `"un_delegate_failed"`
`used_tx_id`	string Не отмечено обязательным	Хеш транзакции расхода энергии Допускается null
`speed_mode`	string Не отмечено обязательным	Режим энергии Допускается null Значения: `"normal"` / `"low_speed"`
`used_energy`	integer Не отмечено обязательным	Потраченная энергия Допускается null
`used_times`	integer Не отмечено обязательным	Использовано единиц Допускается null
`remain_times`	integer Не отмечено обязательным	Всего единиц осталось у адреса Допускается null
`delegate_count`	integer Не отмечено обязательным	Количество делегированной энергии Допускается null
`delegate_tx_id`	string Не отмечено обязательным	Хеш делегирования энергии Допускается null
`delegate_time`	integer Не отмечено обязательным	Время делегирования Допускается null
`un_delegate_tx_id`	string Не отмечено обязательным	Хеш отзыва энергии Допускается null
`un_delegate_time`	integer Не отмечено обязательным	Время отзыва Допускается null
`createtime`	integer Не отмечено обязательным	Время создания записи Допускается null

Исходная модель

OpenAPI · JSON

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

EnergySmartQueryResponseData Результат запроса автоуправления адреса.

Результат запроса автоуправления адреса.

Поле	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON
`balance`	string Обязательный	Доступный остаток средств строкой
`status`	string Обязательный	Статус: включён / пауза Значения: `"start"` / `"stop"`
`order_count`	integer Обязательный	Всего записей расхода
`page_size`	integer Обязательный	Записей на странице
`page`	integer Обязательный	Текущая страница
`orders`	array<EnergySmartOrderItem> Обязательный	Записи расхода текущей страницы

Исходная модель

OpenAPI · JSON

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

EnergySmartData Статус адреса после изменения автоуправления.

Статус адреса после изменения автоуправления.

Поле	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON
`balance`	string Обязательный	Доступный остаток средств строкой
`status`	string Обязательный	Статус: включён / пауза Значения: `"start"` / `"stop"`
`net_protect`	string Не отмечено обязательным	Режим пропускной способности Значения: `"open"` / `"close"`

Исходная модель

OpenAPI · JSON

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

StatisticsDetail Статистика автоуправления за период.

Статистика автоуправления за период.

Поле	Тип / обязательность	Описание и ограничения
`65k`	integer Обязательный	Число операций 65k Пример: `8`
`131k`	integer Обязательный	Число операций 131k Пример: `15`

Исходная модель

OpenAPI · JSON

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

StatisticsSmartData Статистика автоуправления по адресу.

Статистика автоуправления по адресу.

Поле	Тип / обязательность	Описание и ограничения
`days`	object Обязательный	Статистика за 5 дней, ключи YYYY-MM-DD. Значение динамического ключа: StatisticsDetail
`today`	StatisticsDetail Обязательный	Статистика за сегодня
`yesterday`	StatisticsDetail Обязательный	Статистика за вчера
`this_week`	StatisticsDetail Обязательный	За неделю, с понедельника
`this_month`	StatisticsDetail Обязательный	За месяц, с 1-го числа

Исходная модель

OpenAPI · JSON

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

StatisticsTimesData Статистика единиц по адресу.

Статистика единиц по адресу.

Поле	Тип / обязательность	Описание и ограничения
`days`	object Обязательный	Статистика за 5 дней, ключи YYYY-MM-DD. Значение ключа: integer
`today`	integer Обязательный	Всего единиц сегодня Пример: `5`
`yesterday`	integer Обязательный	Всего единиц вчера Пример: `8`
`this_week`	integer Обязательный	Всего единиц с понедельника Пример: `30`
`this_month`	integer Обязательный	Всего единиц с начала месяца Пример: `150`

Исходная модель

OpenAPI · JSON

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

PremiumOrderRequest Определение полей

Поле	Тип / обязательность	Описание и ограничения
`username`	string Обязательный	Имя пользователя Telegram без @. Пример: `"telegram_user"`
`month`	integer Обязательный	Количество месяцев. Значения: `3` / `6` / `12` Пример: `3`

Исходная модель

OpenAPI · JSON

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

StarOrderRequest Определение полей

Поле	Тип / обязательность	Описание и ограничения
`username`	string Обязательный	Имя пользователя Telegram без @. Пример: `"channel_owner"`
`count`	integer Обязательный	Количество Stars: 50–10000. Минимум: `50` Максимум: `10000` Пример: `100`

Исходная модель

OpenAPI · JSON

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

PremiumOrderResponseData Результат заказа Premium.

Результат заказа Premium.

Поле	Тип / обязательность	Описание и ограничения
`username`	string Обязательный	Имя получателя
`period`	string Обязательный	Период покупки, например "3month"
`order_id`	integer Обязательный	Внутренний ID заказа
`amount`	number · float Обязательный	Сумма заказа в TRX
`price`	number · float Обязательный	Информация о цене
`pay_status`	string Обязательный	Статус оплаты
`status`	string Обязательный	Статус обработки заказа

Исходная модель

OpenAPI · JSON

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

StarOrderResponseData Результат заказа Stars.

Результат заказа Stars.

Поле	Тип / обязательность	Описание и ограничения
`username`	string Обязательный	Имя получателя
`count`	integer Обязательный	Количество купленных Stars
`order_id`	integer Обязательный	Внутренний ID заказа
`amount`	number · float Обязательный	Сумма заказа в TRX
`price`	number · float Обязательный	Информация о цене
`pay_status`	string Обязательный	Статус оплаты
`status`	string Обязательный	Статус обработки заказа

Исходная модель

OpenAPI · JSON

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

PremiumQueryResultData Результат запроса Premium.

Результат запроса Premium.

Поле	Тип / обязательность	Описание и ограничения
`username`	string Не отмечено обязательным	Имя получателя Допускается null
`nickname`	string Не отмечено обязательным	Отображаемое имя получателя Допускается null
`period`	string Не отмечено обязательным	Период покупки Допускается null
`order_id`	integer Обязательный	ID заказа
`amount`	number · float Обязательный	Сумма заказа в TRX
`price`	number · float Обязательный	Информация о цене
`pay_status`	string Обязательный	Статус оплаты
`status`	string Обязательный	Статус обработки заказа
`remark`	string Не отмечено обязательным	Примечание или причина ошибки, сокращённо Допускается null
`create_time`	string · date-time Не отмечено обязательным	Время создания заказа Допускается null

Исходная модель

OpenAPI · JSON

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

StarQueryResultData Результат запроса Stars.

Результат запроса Stars.

Поле	Тип / обязательность	Описание и ограничения
`username`	string Не отмечено обязательным	Имя получателя Допускается null
`nickname`	string Не отмечено обязательным	Отображаемое имя получателя Допускается null
`count`	integer Не отмечено обязательным	Количество купленных Stars Допускается null
`order_id`	integer Обязательный	ID заказа
`amount`	number · float Обязательный	Сумма заказа в TRX
`price`	number · float Обязательный	Информация о цене
`pay_status`	string Обязательный	Статус оплаты
`status`	string Обязательный	Статус обработки заказа
`remark`	string Не отмечено обязательным	Примечание или причина ошибки, сокращённо Допускается null
`create_time`	string · date-time Не отмечено обязательным	Время создания заказа Допускается null

Исходная модель

OpenAPI · JSON

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

FastRecoverOrderRequest Определение полей

Поле	Тип / обязательность	Описание и ограничения
`address`	string Обязательный	Адрес TRON для ресурсов Пример: `"TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"`
`count`	integer Обязательный	Объём пополнения ресурсов Пример: `65000`
`resource_type`	string Обязательный	Тип ресурса Значения: `"energy"` / `"net"` Пример: `"energy"`

Исходная модель

OpenAPI · JSON

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

FastRecoverOrderResponseData Результат запроса пополнения.

Результат запроса пополнения.

Поле	Тип / обязательность	Описание и ограничения
`order_id`	integer Обязательный	Внутренний ID заказа
`address`	string Обязательный	Целевой адрес
`energy_count`	integer Обязательный	Запрошенное количество ресурсов
`price`	number · float Не отмечено обязательным	Цена единицы в SUN Допускается null
`fee`	number · float Не отмечено обязательным	Комиссия в TRX Допускается null
`resource_type`	string Обязательный	Тип ресурса Значения: `"energy"` / `"net"`
`amount`	number · float Не отмечено обязательным	Итог в TRX Допускается null
`status`	string Обязательный	Статус заказа Значения: `"waiting"` / `"success"` / `"failed"`
`delegate_txid`	string Не отмечено обязательным	Хеш делегирования Допускается null
`reclaim_txid`	string Не отмечено обязательным	Хеш отзыва Допускается null
`actual_recover_count`	integer Не отмечено обязательным	Фактический объём пополнения Допускается null

Исходная модель

OpenAPI · JSON

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

API 2.1.0 · Проверено 2026-09-30

Источник определения API: Документация API V2 . Здесь собраны инструкции и полное определение. При изменениях исходного сервиса перепроверьте документацию.

Скачать полный OpenAPI

Добавьте энергию в ваше приложение

Сначала откройте аккаунт

Три заголовка и подпись

Node.js: подпись и баланс

Проверка баланса после пополнения

Используйте указанный метод

Пример: аренда на 1 час

Найдите нужные методы

Быстрое пополнение

Автоуправление

Аренда на срок

Полный справочник API 25

Аккаунт

Активировать адрес TRON

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Получить данные пользователя

Заголовки и параметры

Ответы

Заказы ресурсов

Купить энергию на срок

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Купить пропускную способность

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Отозвать энергию

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Проверить результат заказа

Заголовки и параметры

Ответы

Узнать цену ресурса

Заголовки и параметры

Ответы

Быстрое пополнение

Узнать цену пополнения

Заголовки и параметры

Ответы

Пополнить ресурсы

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Проверить пополнение

Заголовки и параметры

Ответы

Автоуправление

Цены автоуправления

Заголовки и параметры

Ответы

Добавить средства автоуправления

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Статус автоуправления

Заголовки и параметры

Ответы

Изменить статус автоуправления

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Статистика автоуправления

Заголовки и параметры

Ответы

Энергия по единицам

Цена единицы энергии

Заголовки и параметры

Ответы

Добавить единицы энергии

Заголовки и параметры

Тело · application/x-www-form-urlencoded

Ответы

Статус единиц энергии

Заголовки и параметры

Ответы

Изменить статус услуги единиц

Добавьте энергию
в ваше приложение