Instant recharge
Check recharge prices, purchase Energy or Bandwidth, then track the order.
/query_fast_recover_price/buy_fast_recover/query_fast_recover_orderDUIYA DEVELOPERS / API V2
DuiYa API integration: check balances, rent Energy and manage delegated addresses.
From account setup to your first request, start here.
/user_infobalance_trx TRX balance
balance_usdt USDT balance
API V2 2.1.0 API reference 25 ENDPOINTSapi.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
00 / PUBLIC QUOTES
Developers and comparison services can read DuiYa's public retail quotes through the website's existing read-only endpoint: GET https://duiya.org/public/market
This is separate from the signed API V2 business endpoints below. It returns public quotes only: it cannot place orders or debit balances, and returns no account details, orders or credentials.
const response = await fetch('https://duiya.org/public/market', {
signal: AbortSignal.timeout(5000)
});
if (!response.ok) throw new Error('Public quotes unavailable');
const data = await response.json();
const collectedAt = Date.parse(data.updatedAt);
const ageMs = Date.now() - collectedAt;
if (data.version !== 1 || !['ready', 'partial'].includes(data.status)
|| !Number.isFinite(collectedAt) || ageMs < 0 || ageMs > 300000
|| !Array.isArray(data.prices)) {
throw new Error('No valid current quote');
}
const quote = data.prices.find(item => item.id === 'timed-65000-15minutes');
if (!quote || quote.updatedAt !== data.updatedAt
|| typeof quote.priceTrx !== 'string'
|| !/^\d+\.\d{2}$/.test(quote.priceTrx) || Number(quote.priceTrx) <= 0) {
throw new Error('Requested quote is unavailable');
}
console.log({ priceTrx: quote.priceTrx, quantity: quote.quantity,
period: quote.period, unit: quote.unit, updatedAt: data.updatedAt });| Field | Meaning |
|---|---|
status | ready means a complete set of quotes; partial means a partial set; stale means expired; unavailable means unavailable; unconfirmed means unconfirmed. Only ready and partial can proceed to further quote validation. |
updatedAt | An ISO 8601 UTC timestamp showing when the cached quotes were collected, not when a trade occurred. |
prices[].priceTrx | A decimal string representing the public retail price in TRX, not the wholesale cost. |
quantity / period / unit | Energy quantity, validity period and billing unit. Energy quantity does not guarantee a transaction count. Confirm any missing values on the order confirmation screen. |
channel / conditions | Service tier and applicable conditions, which may include the managed tier, assessment period in hours, deposit in TRX and minimum Energy quantity. A missing field does not mean zero. |
id / mode | Quote item ID and service type. Per-use API pricing must not be treated as the retail price of the bot's command rental service. |
01 / GET STARTED
After activation, log in at the backend address provided by support. Confirm deposits, available balance, API permissions and current prices before integration.
Manage deposits and IP allowlisting in the backend. The public V2 definition has no endpoint to add IPs or query deposit history; /user_info returns the currently available balance.
02 / AUTHENTICATION
The API V2 business endpoints below use API Key and signature authentication. Use API Secret only to calculate signatures on your server; do not send it as a request parameter.
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
HMAC-SHA256(API Secret, API Key + timestamp)Concatenate API Key and timestamp without a separator. Output lowercase hex. The timestamp is in seconds and must be within ±5 minutes of server time.
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://api.invalid/api/v2/user_info', {
method: 'GET',
headers: {
'x-api-key': apiKey,
'x-timestamp': timestamp,
'x-signature': signature
}
});
const result = await response.json();
if (!response.ok || result.code !== 1) {
throw new Error(result.msg || '');
}
console.log(result.data.balance_trx, result.data.balance_usdt);Store keys in server environment variables. The header timestamp must match the timestamp used for the signature.
03 / ACCOUNT BALANCE
https://api.invalid/api/v2/user_info No business query parameters are needed; include the three authentication headers. Read data.balance_trx and data.balance_usdt , both formatted strings.
{
"code": 1,
"msg": "",
"time": "1711961879",
"data": {
"balance_trx": "100.5000",
"balance_usdt": "500.0000"
}
} For deposits, backend access or IP allowlisting, contact @wanglei . Full response fields: /user_info .
04 / REQUEST FORMAT
https://api.invalid/api/v2/buy_energyhttps://api.invalid/api/v2/buy_energyGET query parameters go in the URL. For POST, use form fields or query parameters as defined here. Energy purchase requires POST, not GET. Authentication always belongs in the headers.
Note: /query_fast_recover_price uses POST, but resource_type and count are URL query parameters in the current definition.
curl --request POST 'https://api.invalid/api/v2/buy_energy' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'x-timestamp: CURRENT_UNIX_SECONDS' \
--header 'x-signature: HMAC_SHA256_HEX' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'count=65000' \
--data-urlencode 'period=1h' \
--data-urlencode 'address=YOUR_TRON_ADDRESS' This request creates a paid order. First use /query_price to check the price, address, quantity, duration and balance. After submitting an asynchronous order, use /query_result to check the execution result.
duiya.org hosts these docs; API requests go to the service URL above. Example prices, balances and amounts illustrate structure and are not live quotes.
These HTTP statuses come from the /buy_energy responses in this site's OpenAPI V2 definition. Check each endpoint's own responses for other operations, and also inspect code and msg.
| HTTP status | Meaning and suggested action |
|---|---|
| 400 | invalid parameters or an inactive address. Check count, period and address against the endpoint documentation. |
| 401 | unauthorized. Check the API Key, signature and matching timestamp in seconds, then review API settings in the account dashboard. |
| 403 | forbidden; the definition lists insufficient balance or abnormal user status. Check available funds and account status; contact @wanglei if needed. |
| 500 | internal server error. Save the request time and error details with sensitive data removed. Do not immediately create the paid order again. |
HTTP success does not establish business success: code=1 means success and code=0 means failure. After an asynchronous Energy order is submitted, use the returned order_sn with /query_result as documented. Submission alone does not establish delivery.
For a timeout, non-JSON response or unclear result, check order records first. Query an existing order number; if none was returned, ask support to verify before resubmitting a paid order.
The public V2 definition provides these pricing endpoints. They require an activated account and authentication. This table explains their purpose and does not contain live account quotes.
| Purpose | Method and endpoint | Request details |
|---|---|---|
| Timed Energy or Bandwidth | GET /query_price | type, count and period; use period=1h for one hour. |
| Energy or Bandwidth fast recharge | POST /query_fast_recover_price | resource_type and count are URL query parameters. |
| Smart management | GET /get_smart_price | Get current 65K and 131K management prices. |
| API transfer units | GET /get_times_price | Get the current per-unit API price. |
Quoting, ordering and checking the result are separate steps. Confirm the quote and fees, submit the order, then query its execution result as documented. Bot retail prices and API account quotes are not interchangeable. Check the selected service and account settings to establish whether automatic Bandwidth protection applies.
Each tier has separate 65K and 131K quotes. High frequency, Jisu and Guangsu may have a deposit, a measurement period and minimum energy usage. Confirm the conditions in the bot or account dashboard.
| Tier | 65K price field | 131K price field |
|---|---|---|
Regular normal | data.65K_price | data.131K_price |
High frequency high_frequency | data.high_frequency.65k_price | data.high_frequency.131k_price / data.high_frequency.131K_price |
Jisu jisu_frequency | data.jisu_frequency.65k_price | data.jisu_frequency.131k_price / data.jisu_frequency.131K_price |
Guangsu guangsu_frequency | data.guangsu_frequency.65k_price | data.guangsu_frequency.131k_price / data.guangsu_frequency.131K_price |
GET /get_smart_price returns supplier prices for all four tiers. This website displays smart delegation retail prices at supplier price × 1.02, rounded to two decimals. Actual API account charges follow the API and dashboard.
deposit_period: measurement period in hours; deposit_amount: deposit in TRX; min_energy_count: minimum energy usage, not a transfer count. Missing or null prices are never replaced with another tier.
POST /delegate_energy_smart selects a tier using its channel value. Confirm deposits and net_protect bandwidth protection against the account configuration.
05 / ENERGY SERVICES
Check recharge prices, purchase Energy or Bandwidth, then track the order.
/query_fast_recover_price/buy_fast_recover/query_fast_recover_orderCheck delegation prices, allocate credit and manage addresses and usage records.
/get_smart_price/delegate_energy_smart/query_energy_smartGet a quote by quantity and duration, then check the order result.
/query_price/buy_energy/query_resultUnit-based Energy, account activation, address consolidation and Fragment services are also documented. Availability and pricing depend on account permissions and actual API responses.
06 / ENDPOINT REFERENCE
Expand an endpoint for parameters, response fields and the full definition. Click a type name to view its data model.
Showing all 25 endpoints
User information and account activation.
/active_account Activate a TRON address Submit an address activation request. The corresponding fee is deducted from your balance.
Full URL: https://api.invalid/api/v2/active_account
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address to activate Example: "TNewAddressxxxxxxxxxxxxxxxxxxxxxxx" |
HTTP 200 Activation request submitted. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | ActivationData Not marked required | Response data after submitting account activation. |
HTTP 400 Bad request, e.g. invalid address format application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized: authentication failed application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 403 Forbidden, e.g. insufficient balance application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/user_info Get user information Get basic details for the authenticated user, including balances.
Full URL: https://api.invalid/api/v2/user_info
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
HTTP 200 User information retrieved. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | UserInfoData Not marked required | User information result. |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}Buy TRON Energy or Bandwidth for a duration; query and manage orders.
/buy_energy Buy timed Energy Submit an asynchronous order to delegate Energy to an address for the selected period.
Full URL: https://api.invalid/api/v2/buy_energy
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
count | integer Required | Energy amount to delegate, minimum 30000 Example: 50000 |
period | string Required | Period, e.g. "15minutes", "1h", "1day", "3day" Example: "1day" |
address | string Required | TRON address receiving Energy Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx" |
HTTP 200 Order submitted successfully. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | EnergyOrderResponseData Not marked required | Data returned after an Energy order is submitted. |
HTTP 400 Bad request: invalid parameters, inactive address, etc. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 403 Forbidden: insufficient balance or abnormal user status application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/buy_net Buy timed Bandwidth Submit an asynchronous order to delegate Bandwidth to an address for the selected period.
Full URL: https://api.invalid/api/v2/buy_net
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
count | integer Required | Bandwidth bytes to delegate, minimum 100 Example: 5000 |
period | string Required | Period, e.g. "1day", "3day" Example: "3day" |
address | string Required | TRON address receiving Bandwidth Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx" |
HTTP 200 Order submitted successfully. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | NetOrderResponseData Not marked required | Data returned after a Bandwidth order is submitted. |
HTTP 400 Bad request application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 403 Forbidden application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/reclaim_energy Reclaim Energy Asynchronously reclaim delegated resources using a completed order's serial number and target address.
Full URL: https://api.invalid/api/v2/reclaim_energy
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
order_sn | string Required | Original delegation order serial number Example: "EN2025040217175512345" |
address | string Required | Original resource receiving address Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx" |
HTTP 200 Reclaim request submitted. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Response data payload. Nullable |
HTTP 400 Bad request: invalid order number or address application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: missing order, wrong owner or no matching reclaimable resources application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/query_result Query order result Get a resource order's processing status and details.
Full URL: https://api.invalid/api/v2/query_result
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
order_sn Required | query string | Unique serial number of the order Example: "EN2025040217175512345" |
HTTP 200 Order details retrieved. The data structure contains success details or failure information depending on status. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | QueryResultDataSuccess or QueryResultDataFailed Not marked required |
HTTP 400 Bad request: invalid order number application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: order missing or belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server or query error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/query_price Query resource price Estimate the order price by resource type (energy or net), quantity and period.
Full URL: https://api.invalid/api/v2/query_price
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
type Required | query string | Resource type ("energy", "net") Enum: "energy" / "net"Example: "energy" |
count Required | query integer | Energy points or Bandwidth bytes Example: 50000 |
period Required | query string | Period, e.g. "15minutes", "1h", "1day", "3day" Example: "1day" |
HTTP 200 Price calculated. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | ResourcePriceData Not marked required | Resource price result. |
HTTP 400 Bad request: invalid parameters application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: price unavailable or not configured application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}Fast Energy and Bandwidth top-up services.
/query_fast_recover_price Query recharge price Get the recharge price.
Full URL: https://api.invalid/api/v2/query_fast_recover_price
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
resource_type Required | query string | Resource type ("energy", "net") Enum: "energy" / "net"Example: "energy" |
count Required | query integer | Quantity of Energy or Bandwidth Example: 100000 |
HTTP 200 Price calculated. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | FastRecoverPriceData Not marked required | Recharge price result |
HTTP 400 Bad request: invalid parameters application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: price unavailable or not configured application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/buy_fast_recover Recharge Energy or Bandwidth Provide a one-time Energy or Bandwidth top-up to an address.
Full URL: https://api.invalid/api/v2/buy_fast_recover
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address receiving resources Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx" |
count | integer Required | Amount of Energy or Bandwidth to top up Example: 65000 |
resource_type | string Required | Resource type Enum: "energy" / "net"Example: "energy" |
HTTP 200 Recharge request submitted; query its status later. application/json · Click a type for full fields
| Field | Type / required | Description and constraints | ||||||
|---|---|---|---|---|---|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 | ||||||
msg | string Required | Response message. Example: "" | ||||||
time | string Required | Server response timestamp. Example: "1711961879" | ||||||
data | object Not marked required |
|
HTTP 400 Bad request: invalid parameters application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 403 Forbidden, e.g. insufficient balance application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/query_fast_recover_order Query recharge order Get a recharge order's status and details.
Full URL: https://api.invalid/api/v2/query_fast_recover_order
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
order_id Required | query integer | Recharge order ID to query Example: 123 |
HTTP 200 Query successful. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | FastRecoverOrderResponseData Not marked required | Recharge order query result. |
HTTP 400 Bad request: invalid order ID application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: order missing or belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"tags": [
" (Fast Recover)"
],
"summary": "",
"description": "。",
"operationId": "queryFastRecoverOrderV2",
"parameters": [
{
"$ref": "#/components/parameters/XApiKeyHeader"
},
{
"$ref": "#/components/parameters/XTimestampHeader"
},
{
"$ref": "#/components/parameters/XSignatureHeader"
},
{
"name": "order_id",
"in": "query",
"required": true,
"description": " ID",
"schema": {
"type": "integer",
"example": 123
}
}
],
"responses": {
"200": {
"description": "。",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/BaseResponse"
},
{
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/FastRecoverOrderResponseData"
}
}
}
]
}
}
}
},
"400": {
"description": " ( ID )",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"401": {
"description": "",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"404": {
"description": " ( ID )",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"500": {
"description": "",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}Smart Energy delegation operations.
/get_smart_price Get smart delegation prices Get current smart delegation prices for 65K and 131K Energy.
Full URL: https://api.invalid/api/v2/get_smart_price
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
HTTP 200 Prices retrieved. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | SmartPriceData Not marked required | Smart delegation pricing. |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: some or all prices unavailable application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/delegate_energy_smart Add smart delegation credit Increase an address's available smart delegation credit (balance).
Full URL: https://api.invalid/api/v2/delegate_energy_smart
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address to credit Example: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx" |
balance | number · float Required | Positive credit amount, e.g. a TRX amount Example: 10.5 |
channel | string Not marked required | Mode: normal = standard; high_frequency = high frequency; jisu_frequency = fast; guangsu_frequency = light speed Enum: "normal" / "high_frequency" / "jisu_frequency" / "guangsu_frequency"Example: "high_frequency" |
hf_deposit | number Not marked required | High-frequency deposit: -1 follows system settings; 0 means no deposit; other amounts deduct that deposit Example: "0" |
net_protect | string Not marked required | Address Bandwidth protection mode Enum: "open" / "close"Example: "open" |
HTTP 200 Delegation or credit increase successful application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | EnergySmartDelegateResponseData Not marked required | Smart delegation success data. |
HTTP 400 Bad request: invalid address or credit amount application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 429 Too many requests, if locking is implemented application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/query_energy_smart Query smart delegation status Get an address's remaining credit, service status and paginated usage history.
Full URL: https://api.invalid/api/v2/query_energy_smart
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
address Required | query string | TRON address to query Example: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx" |
page Required | query integer | Page number, starting at 1 Minimum: 1Example: 1 |
HTTP 200 Query successful. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | EnergySmartQueryResponseData Not marked required | Smart delegation address query result. |
HTTP 400 Bad request: invalid address or page application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: service inactive or address belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/update_energy_smart Update smart delegation status Start ("start") or pause ("stop") smart delegation for an address.
Full URL: https://api.invalid/api/v2/update_energy_smart
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address to update Example: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx" |
status | string Required | Target status Enum: "start" / "stop"Example: "start" |
net_protect | string Not marked required | Address Bandwidth protection mode Enum: "open" / "close"Example: "open" |
HTTP 200 Status updated; returns the current status. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | EnergySmartData Not marked required | Address status after a smart delegation update. |
HTTP 400 Bad request: invalid address or status application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: service inactive or address belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 409 Conflict: already in the target status application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 429 Too many requests, if locking is implemented application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/statistics_smart_by_address Get smart delegation statistics Usage by address for today, yesterday, this week, this month and the last 5 days, split into 65k/131k.
Full URL: https://api.invalid/api/v2/statistics_smart_by_address
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
address Required | query string | TRON address for statistics Example: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx" |
HTTP 200 Statistics retrieved. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | StatisticsSmartData Not marked required | Smart delegation statistics by address. |
HTTP 400 Bad request: invalid address format application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}Unit-based Energy API operations.
/get_times_price Get unit-based Energy price Get the current per-transaction unit price.
Full URL: https://api.invalid/api/v2/get_times_price
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
HTTP 200 Prices retrieved. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | TimesPriceData Not marked required | Unit-based Energy pricing. |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: price unavailable application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/delegate_energy_times Add Energy units Add Energy transaction units to an address, billed per use.
Full URL: https://api.invalid/api/v2/delegate_energy_times
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address receiving units Example: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx" |
times | integer Required | Units to add; positive integer Example: 100 |
HTTP 200 Delegation successful. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | EnergyTimesDelegateResponseData Not marked required | Unit delegation success data. |
HTTP 400 Bad request: invalid address or unit count application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 429 Too many requests, if locking is implemented application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error, e.g. database error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/query_energy_times Query Energy unit status Get remaining units, service status and paginated usage records for an address.
Full URL: https://api.invalid/api/v2/query_energy_times
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
address Required | query string | TRON address to query Example: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx" |
page Required | query integer | Page number, starting at 1 Minimum: 1Example: 1 |
HTTP 200 Query successful. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | EnergyTimesQueryResponseData Not marked required | Unit-based service address query result. |
HTTP 400 Bad request: invalid address or page application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: service inactive or address belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/update_energy_times Update address unit-service status Start ("start") or pause ("stop") unit-based Energy for an address.
Full URL: https://api.invalid/api/v2/update_energy_times
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address to update Example: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx" |
status | string Required | Target status Enum: "start" / "stop"Example: "stop" |
HTTP 200 Status updated; returns the current status. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | EnergyTimesData Not marked required | Address status after a unit-service update. |
HTTP 400 Bad request: invalid address or status application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: service inactive or address belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 409 Conflict: already in the target status application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 429 Too many requests, if locking is implemented application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/statistics_times_by_address Get Energy unit statistics Energy units consumed by address for today, yesterday, this week, this month and the last 5 days.
Full URL: https://api.invalid/api/v2/statistics_times_by_address
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
address Required | query string | TRON address for statistics Example: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx" |
HTTP 200 Statistics retrieved. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | StatisticsTimesData Not marked required | Energy unit statistics by address. |
HTTP 400 Bad request: invalid address format application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}Order Telegram Premium and Stars via Fragment.
/buy_premium Buy Telegram Premium Create an order to gift Premium to a Telegram user.
Full URL: https://api.invalid/api/v2/buy_premium
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
username | string Required | Target Telegram username, without @. Example: "telegram_user" |
month | integer Required | Number of months to purchase. Enum: 3 / 6 / 12Example: 3 |
HTTP 200 Order submitted. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | PremiumOrderResponseData Not marked required | Premium order submission result. |
HTTP 400 Bad request: invalid username or months application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 403 Forbidden: insufficient balance application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/query_premium_order Query Premium order Get a Premium order's status and details.
Full URL: https://api.invalid/api/v2/query_premium_order
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
order_id Required | query integer | Internal order ID to query Example: 5678 |
HTTP 200 Order details retrieved. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | PremiumQueryResultData Not marked required | Premium order query result. |
HTTP 400 Bad request: invalid order ID application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: order missing or belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/buy_star Buy Telegram Stars Create an order to send Stars to a Telegram user.
Full URL: https://api.invalid/api/v2/buy_star
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
username | string Required | Target Telegram username, without @. Example: "channel_owner" |
count | integer Required | Number of Stars, 50–10000. Minimum: 50Maximum: 10000Example: 100 |
HTTP 200 Order submitted. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | StarOrderResponseData Not marked required | Stars order submission result. |
HTTP 400 Bad request: invalid username or quantity application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 403 Forbidden: insufficient balance application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}/query_star_order Query Stars order Get a Stars order's status and details.
Full URL: https://api.invalid/api/v2/query_star_order
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
order_id Required | query integer | Internal order ID to query Example: 91011 |
HTTP 200 Order details retrieved. application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | StarQueryResultData Not marked required | Stars order query result. |
HTTP 400 Bad request: invalid order ID application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 404 Not found: order missing or belongs to another user application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}Manage automatic USDT consolidation addresses.
/submit_converge_address Submit consolidation settings Configure automatic USDT consolidation rules for a TRON address.
Full URL: https://api.invalid/api/v2/submit_converge_address
| Parameter | Location / type | Description and constraints |
|---|---|---|
x-api-key Required | header string | Your API Key. |
x-timestamp Required | header integer | Current UNIX timestamp in seconds. Example: 1711961879 |
x-signature Required | header string | Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ). Example: "a1b2c3d4e5f6..." |
Request body required
| Form field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address to configure Example: "TConvergeAddressxxxxxxxxxxxxxxxxxx" |
mode | string Required | Consolidation mode Enum: "once" / "keep"Example: "keep" |
transfer_threshold | number · float Required | Minimum balance threshold to trigger consolidation Example: 100 |
balance_min | number · float Required | Minimum balance retained after consolidation Example: 10 |
balance_max | number · float Required | Maximum retained balance, must be >= min Example: 20 |
energy_count | integer Required | Energy supplied for consolidation Example: 65000 |
type | string Required | Service type provided to the address Enum: "energy" / "all"Example: "all" |
notify_callback | string · url Not marked required | Optional callback URL for consolidation notifications Nullable Example: "https://yourcallback.com/notify" |
HTTP 200 Settings submitted application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Response data payload. Nullable |
HTTP 400 Bad request: invalid parameters application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 401 Unauthorized application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 409 Conflict: an active configuration already exists for this address application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
HTTP 500 Internal server error application/json · Click a type for full fields
| Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"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"
}
}
}
}
}
}No matching endpoint. Try another search.
07 / DATA MODELS
These fields match the current V2 definition. Successful responses usually wrap data in code , msg , time , data ; see each model for business-specific fields.
BaseResponse Field definition | Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 1 for success, 0 for failure. Enum: 1Example: 1 |
msg | string Required | Response message. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Response data payload. Nullable |
{
"type": "object",
"properties": {
"code": {
"type": "integer",
"description": ",1 ,0 。",
"enum": [
1
],
"example": 1
},
"msg": {
"type": "string",
"description": "。",
"example": ""
},
"time": {
"type": "string",
"description": "。",
"example": "1711961879"
},
"data": {
"type": "object",
"nullable": true,
"description": "。"
}
},
"required": [
"code",
"msg",
"time"
]
}ErrorResponse Field definition | Field | Type / required | Description and constraints |
|---|---|---|
code | integer Required | Status code: 0 for failure. Enum: 0Example: 0 |
msg | string Required | Error message description. Example: "" |
time | string Required | Server response timestamp. Example: "1711961879" |
data | object Not marked required | Nullable Example: null |
{
"type": "object",
"properties": {
"code": {
"type": "integer",
"description": ",0 。",
"enum": [
0
],
"example": 0
},
"msg": {
"type": "string",
"description": "。",
"example": ""
},
"time": {
"type": "string",
"description": "。",
"example": "1711961879"
},
"data": {
"type": "object",
"nullable": true,
"example": null
}
},
"required": [
"code",
"msg",
"time"
]
}ActivationData Response data after submitting account activation. Response data after submitting account activation.
| Field | Type / required | Description and constraints |
|---|---|---|
tx_id | string Required | Transaction hash; usually populated after the background job completes, initially empty. Example: "" |
order_id | integer Required | Internal order ID tracking activation. Example: 12345 |
{
"type": "object",
"description": "。",
"properties": {
"tx_id": {
"type": "string",
"description": " (,)。",
"example": ""
},
"order_id": {
"type": "integer",
"description": " ID。",
"example": 12345
}
},
"required": [
"tx_id",
"order_id"
]
}EnergyOrderResponseData Data returned after an Energy order is submitted. Data returned after an Energy order is submitted.
| Field | Type / required | Description and constraints |
|---|---|---|
order_sn | string Required | Unique order serial number. Example: "EN2025040217175512345" |
price | number · float Not marked required | Calculated unit Energy price in SUN. Nullable Example: 35000000 |
fee | number · float Not marked required | Additional fee in TRX. Nullable Example: 0.56 |
amount | number · float Not marked required | Total order cost in TRX. Nullable Example: 5.65 |
balance | number · float Not marked required | Account balance after the operation; may be inaccurate or omitted. Nullable Example: 94.35 |
{
"type": "object",
"description": "。",
"properties": {
"order_sn": {
"type": "string",
"description": "。",
"example": "EN2025040217175512345"
},
"price": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (SUN)。",
"example": 35000000
},
"fee": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)。",
"example": 0.56
},
"amount": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)。",
"example": 5.65
},
"balance": {
"type": "number",
"format": "float",
"nullable": true,
"description": " ()。",
"example": 94.35
}
},
"required": [
"order_sn"
]
}NetOrderResponseData Data returned after a Bandwidth order is submitted. Data returned after a Bandwidth order is submitted.
| Field | Type / required | Description and constraints |
|---|---|---|
order_sn | string Required | Unique order serial number. Example: "NET2025040217180012345" |
amount | number · float Not marked required | Total order cost in TRX. Nullable Example: 2.1 |
price | number · float Not marked required | Calculated unit Bandwidth price; source lists unit as SUN? Nullable Example: 420000 |
fee | number · float Not marked required | Additional fee in TRX. Nullable Example: 0 |
balance | number · float Not marked required | Account balance after the operation; may be inaccurate or omitted. Nullable Example: 97.9 |
{
"type": "object",
"description": "。",
"properties": {
"order_sn": {
"type": "string",
"description": "。",
"example": "NET2025040217180012345"
},
"amount": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)。",
"example": 2.1
},
"price": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (SUN?)。",
"example": 420000
},
"fee": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)。",
"example": 0
},
"balance": {
"type": "number",
"format": "float",
"nullable": true,
"description": " ()。",
"example": 97.9
}
},
"required": [
"order_sn"
]
}QueryResultDataSuccess Details of a successfully queried order. Details of a successfully queried order.
| Field | Type / required | Description and constraints |
|---|---|---|
order_sn | string Required | |
amount | number · float Not marked required | Order amount in TRX Nullable |
price | number · float Not marked required | Order unit price in SUN Nullable |
fee | number · float Not marked required | Order fee in TRX Nullable |
period | string Required | Period name |
status | string Required | Order status code |
orders | array<object> Required | Child delegation orders |
{
"type": "object",
"description": "。",
"properties": {
"order_sn": {
"type": "string"
},
"amount": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)"
},
"price": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (SUN)"
},
"fee": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)"
},
"period": {
"type": "string",
"description": ""
},
"status": {
"type": "string",
"description": ""
},
"orders": {
"type": "array",
"description": "()",
"items": {
"type": "object",
"properties": {
"from_address": {
"type": "string",
"description": ""
},
"tx_id": {
"type": "string",
"nullable": true,
"description": ""
},
"count": {
"type": "integer",
"description": ""
}
},
"required": [
"from_address",
"count"
]
}
}
},
"required": [
"order_sn",
"period",
"status",
"orders"
]
}QueryResultDataFailed Basic details of a failed or unfinished order. Basic details of a failed or unfinished order.
| Field | Type / required | Description and constraints |
|---|---|---|
order_sn | string Required | |
amount | number · float Not marked required | Nullable |
price | number · float Not marked required | Nullable |
fee | number · float Not marked required | Nullable |
period | string Not marked required | Nullable |
status | string Required | Order status code |
orders | array<object> Required | Empty array |
{
"type": "object",
"description": "。",
"properties": {
"order_sn": {
"type": "string"
},
"amount": {
"type": "number",
"format": "float",
"nullable": true
},
"price": {
"type": "number",
"format": "float",
"nullable": true
},
"fee": {
"type": "number",
"format": "float",
"nullable": true
},
"period": {
"type": "string",
"nullable": true
},
"status": {
"type": "string",
"description": ""
},
"orders": {
"type": "array",
"items": {},
"description": ""
}
},
"required": [
"order_sn",
"status",
"orders"
]
}UserInfoData User information result. User information result.
| Field | Type / required | Description and constraints |
|---|---|---|
balance_trx | string Required | Available TRX balance as a formatted string. Example: "100.5000" |
balance_usdt | string Required | Available USDT balance as a formatted string. Example: "500.0000" |
{
"type": "object",
"description": "。",
"properties": {
"balance_trx": {
"type": "string",
"description": " TRX ()。",
"example": "100.5000"
},
"balance_usdt": {
"type": "string",
"description": " USDT ()。",
"example": "500.0000"
}
},
"required": [
"balance_trx",
"balance_usdt"
]
}ResourcePriceData Resource price result. Resource price result.
| Field | Type / required | Description and constraints |
|---|---|---|
price | integer Required | Unit price in SUN per period. Example: 35 |
amount | string Required | Estimated total in TRX for the requested quantity, including applicable fees. Example: "5.6500" |
fee | string Required | Additional fee in TRX, e.g. a small-order fee. Example: "0.5600" |
remark | string Required | Additional pricing notes, e.g. fee details. Example: " 0.56 TRX " |
{
"type": "object",
"description": "。",
"properties": {
"price": {
"type": "integer",
"description": " (SUN / )。",
"example": 35
},
"amount": {
"type": "string",
"description": " (:TRX),。",
"example": "5.6500"
},
"fee": {
"type": "string",
"description": " (:TRX),。",
"example": "0.5600"
},
"remark": {
"type": "string",
"description": " ()。",
"example": " 0.56 TRX "
}
},
"required": [
"price",
"amount",
"fee",
"remark"
]
}FastRecoverPriceData Recharge price result Recharge price result
| Field | Type / required | Description and constraints |
|---|---|---|
price | integer Required | Unit price in SUN. Example: 100 |
amount | string Required | Estimated total in TRX for the requested quantity, including applicable fees. Example: "5.6500" |
fee | string Required | Additional fee in TRX, e.g. a small-order fee. Example: "0.5600" |
{
"type": "object",
"description": "",
"properties": {
"price": {
"type": "integer",
"description": " (SUN)。",
"example": 100
},
"amount": {
"type": "string",
"description": " (:TRX),。",
"example": "5.6500"
},
"fee": {
"type": "string",
"description": " (:TRX),。",
"example": "0.5600"
}
},
"required": [
"price",
"amount",
"fee",
"remark"
]
}SmartPriceData Smart delegation pricing. Smart delegation pricing.
| Field | Type / required | Description and constraints | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
65K_price | string Required | TRX price per 65K Energy delegation. Example: "0.5000" | ||||||||||||||||||
131K_price | string Required | TRX price per 131K Energy delegation. Example: "0.9500" | ||||||||||||||||||
remark | string Not marked required | Nullable Example: ":TRX/" | ||||||||||||||||||
high_frequency | object Not marked required | High-frequency pricing, deposit and statistics period.
| ||||||||||||||||||
jisu_frequency | object Not marked required | Fast-mode pricing, deposit and statistics period.
| ||||||||||||||||||
guangsu_frequency | object Not marked required | Light-speed pricing, deposit and statistics period.
|
{
"type": "object",
"description": "。",
"properties": {
"65K_price": {
"type": "string",
"description": " 65K (TRX)。",
"example": "0.5000"
},
"131K_price": {
"type": "string",
"description": " 131K (TRX)。",
"example": "0.9500"
},
"remark": {
"type": "string",
"nullable": true,
"example": ":TRX/"
},
"high_frequency": {
"type": "object",
"description": ",、。",
"properties": {
"65k_price": {
"type": "string",
"nullable": true,
"description": "65K。",
"example": "0.8000"
},
"131k_price": {
"type": "string",
"nullable": true,
"description": "131K。",
"example": "1.5000"
},
"deposit_period": {
"type": "string",
"nullable": true,
"description": ",:",
"example": "72"
},
"deposit_amount": {
"type": "string",
"nullable": true,
"description": ",: TRX",
"example": 1000
},
"min_energy_count": {
"type": "string",
"nullable": true,
"description": "",
"example": 200000
}
}
},
"jisu_frequency": {
"type": "object",
"description": ",、。",
"properties": {
"65k_price": {
"type": "string",
"nullable": true,
"description": "65K。",
"example": "0.8000"
},
"131k_price": {
"type": "string",
"nullable": true,
"description": "131K。",
"example": "1.5000"
},
"deposit_period": {
"type": "string",
"nullable": true,
"description": ",:",
"example": "72"
},
"deposit_amount": {
"type": "string",
"nullable": true,
"description": ",: TRX",
"example": 1000
},
"min_energy_count": {
"type": "string",
"nullable": true,
"description": "",
"example": 200000
}
}
},
"guangsu_frequency": {
"type": "object",
"description": ",、。",
"properties": {
"65k_price": {
"type": "string",
"nullable": true,
"description": "65K。",
"example": "0.8000"
},
"131k_price": {
"type": "string",
"nullable": true,
"description": "131K。",
"example": "1.5000"
},
"deposit_period": {
"type": "string",
"nullable": true,
"description": ",:",
"example": "72"
},
"deposit_amount": {
"type": "string",
"nullable": true,
"description": ",: TRX",
"example": 1000
},
"min_energy_count": {
"type": "string",
"nullable": true,
"description": "",
"example": 200000
}
}
}
},
"required": [
"65K_price",
"131K_price"
]
}TimesPriceData Unit-based Energy pricing. Unit-based Energy pricing.
| Field | Type / required | Description and constraints |
|---|---|---|
price | string Required | TRX price per Energy delegation. Example: "0.6000" |
remark | string Not marked required | Nullable Example: ":TRX/" |
{
"type": "object",
"description": "API。",
"properties": {
"price": {
"type": "string",
"description": " (TRX)。",
"example": "0.6000"
},
"remark": {
"type": "string",
"nullable": true,
"example": ":TRX/"
}
},
"required": [
"price"
]
}EnergyTimesDelegateResponseData Unit delegation success data. Unit delegation success data.
| Field | Type / required | Description and constraints |
|---|---|---|
address | string Required | Target delegation address |
remain_times | integer Required | Units remaining after operation |
status | string Required | Current service status Enum: "start" / "stop" |
{
"type": "object",
"description": "API。",
"properties": {
"address": {
"type": "string",
"description": ""
},
"remain_times": {
"type": "integer",
"description": ""
},
"status": {
"type": "string",
"description": "",
"enum": [
"start",
"stop"
]
}
},
"required": [
"address",
"remain_times",
"status"
]
}EnergyTimesOrderItem Energy unit usage record Energy unit usage record
| Field | Type / required | Description and constraints |
|---|---|---|
remain_times | integer Not marked required | Units remaining after this usage Nullable |
status | string Not marked required | Energy status Nullable Enum: "init" / "waiting_delegate" / "delegate_success" / "delegate_failed" / "waiting_un_delegate" / "un_delegate_success" / "un_delegate_failed" |
speed_mode | string Not marked required | Energy mode Nullable Enum: "normal" / "low_speed" |
used_tx_id | string Not marked required | Transaction hash that consumed Energy Nullable |
used_energy | integer Not marked required | Energy consumed Nullable |
delegate_tx_id | string Not marked required | Energy delegation transaction hash Nullable |
delegate_time | integer Not marked required | Delegation timestamp Nullable |
un_delegate_tx_id | string Not marked required | Energy reclaim transaction hash Nullable |
un_delegate_time | integer Not marked required | Reclaim timestamp Nullable |
createtime | integer Not marked required | Record creation timestamp Nullable |
{
"type": "object",
"description": "",
"properties": {
"remain_times": {
"type": "integer",
"nullable": true,
"description": ""
},
"status": {
"type": "string",
"nullable": true,
"description": "",
"enum": [
"init",
"waiting_delegate",
"delegate_success",
"delegate_failed",
"waiting_un_delegate",
"un_delegate_success",
"un_delegate_failed"
]
},
"speed_mode": {
"type": "string",
"nullable": true,
"description": "",
"enum": [
"normal",
"low_speed"
]
},
"used_tx_id": {
"type": "string",
"nullable": true,
"description": ""
},
"used_energy": {
"type": "integer",
"nullable": true,
"description": ""
},
"delegate_tx_id": {
"type": "string",
"nullable": true,
"description": ""
},
"delegate_time": {
"type": "integer",
"nullable": true,
"description": ""
},
"un_delegate_tx_id": {
"type": "string",
"nullable": true,
"description": ""
},
"un_delegate_time": {
"type": "integer",
"nullable": true,
"description": ""
},
"createtime": {
"type": "integer",
"nullable": true,
"description": ""
}
}
}EnergyTimesQueryResponseData Unit-based service address query result. Unit-based service address query result.
| Field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address |
remain_times | integer Required | Available units remaining |
status | string Required | Service status: enabled / paused Enum: "start" / "stop" |
order_count | integer Required | Total usage record count |
page_size | integer Required | Records per page |
page | integer Required | Current page number |
orders | array<EnergyTimesOrderItem> Required | Usage records on the current page |
{
"type": "object",
"description": "API。",
"properties": {
"address": {
"type": "string",
"description": "TRON "
},
"remain_times": {
"type": "integer",
"description": ""
},
"status": {
"type": "string",
"enum": [
"start",
"stop"
],
"description": " (/)"
},
"order_count": {
"type": "integer",
"description": ""
},
"page_size": {
"type": "integer",
"description": ""
},
"page": {
"type": "integer",
"description": ""
},
"orders": {
"type": "array",
"description": "",
"items": {
"$ref": "#/components/schemas/EnergyTimesOrderItem"
}
}
},
"required": [
"address",
"remain_times",
"status",
"order_count",
"page_size",
"page",
"orders"
]
}EnergyTimesData Address status after a unit-service update. Address status after a unit-service update.
| Field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address |
remain_times | integer Required | Available units remaining |
status | string Required | Service status: enabled / paused Enum: "start" / "stop" |
{
"type": "object",
"description": "API()。",
"properties": {
"address": {
"type": "string",
"description": "TRON "
},
"remain_times": {
"type": "integer",
"description": ""
},
"status": {
"type": "string",
"enum": [
"start",
"stop"
],
"description": " (/)"
}
},
"required": [
"address",
"remain_times",
"status"
]
}EnergySmartDelegateResponseData Smart delegation success data. Smart delegation success data.
| Field | Type / required | Description and constraints |
|---|---|---|
address | string Required | Target delegation address |
balance | string Required | Total balance after operation, formatted string |
status | string Required | Current service status Enum: "start" / "stop" |
net_protect | string Not marked required | Bandwidth mode Enum: "open" / "close" |
{
"type": "object",
"description": "。",
"properties": {
"address": {
"type": "string",
"description": ""
},
"balance": {
"type": "string",
"description": " ()"
},
"status": {
"type": "string",
"description": "",
"enum": [
"start",
"stop"
]
},
"net_protect": {
"type": "string",
"description": "",
"enum": [
"open",
"close"
]
}
},
"required": [
"address",
"balance",
"status"
]
}EnergySmartOrderItem Smart delegation usage record Smart delegation usage record
| Field | Type / required | Description and constraints |
|---|---|---|
energy_type | string Not marked required | Energy type: 65k = 65K, 131k = 131K Nullable |
amount | number · float Not marked required | Amount spent Nullable |
balance | number · float Not marked required | Balance after usage Nullable |
currency | string Not marked required | Currency Nullable Enum: "trx" / "usdt" |
status | string Not marked required | Energy status Nullable Enum: "init" / "waiting_delegate" / "delegate_success" / "delegate_failed" / "waiting_un_delegate" / "un_delegate_success" / "un_delegate_failed" |
used_tx_id | string Not marked required | Transaction hash that consumed Energy Nullable |
speed_mode | string Not marked required | Energy mode Nullable Enum: "normal" / "low_speed" |
used_energy | integer Not marked required | Energy consumed Nullable |
used_times | integer Not marked required | Units used Nullable |
remain_times | integer Not marked required | Total units remaining for the address Nullable |
delegate_count | integer Not marked required | Delegated Energy amount Nullable |
delegate_tx_id | string Not marked required | Energy delegation transaction hash Nullable |
delegate_time | integer Not marked required | Delegation timestamp Nullable |
un_delegate_tx_id | string Not marked required | Energy reclaim transaction hash Nullable |
un_delegate_time | integer Not marked required | Reclaim timestamp Nullable |
createtime | integer Not marked required | Record creation timestamp Nullable |
{
"type": "object",
"description": "",
"properties": {
"energy_type": {
"type": "string",
"nullable": true,
"description": ": 65k=65K, 131k=131K"
},
"amount": {
"type": "number",
"format": "float",
"nullable": true,
"description": ""
},
"balance": {
"type": "number",
"format": "float",
"nullable": true,
"description": ""
},
"currency": {
"type": "string",
"nullable": true,
"description": "",
"enum": [
"trx",
"usdt"
]
},
"status": {
"type": "string",
"nullable": true,
"description": "",
"enum": [
"init",
"waiting_delegate",
"delegate_success",
"delegate_failed",
"waiting_un_delegate",
"un_delegate_success",
"un_delegate_failed"
]
},
"used_tx_id": {
"type": "string",
"nullable": true,
"description": ""
},
"speed_mode": {
"type": "string",
"nullable": true,
"description": "",
"enum": [
"normal",
"low_speed"
]
},
"used_energy": {
"type": "integer",
"nullable": true,
"description": ""
},
"used_times": {
"type": "integer",
"nullable": true,
"description": ""
},
"remain_times": {
"type": "integer",
"nullable": true,
"description": ""
},
"delegate_count": {
"type": "integer",
"nullable": true,
"description": ""
},
"delegate_tx_id": {
"type": "string",
"nullable": true,
"description": ""
},
"delegate_time": {
"type": "integer",
"nullable": true,
"description": ""
},
"un_delegate_tx_id": {
"type": "string",
"nullable": true,
"description": ""
},
"un_delegate_time": {
"type": "integer",
"nullable": true,
"description": ""
},
"createtime": {
"type": "integer",
"nullable": true,
"description": ""
}
}
}EnergySmartQueryResponseData Smart delegation address query result. Smart delegation address query result.
| Field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address |
balance | string Required | Available credit remaining, formatted string |
status | string Required | Service status: enabled / paused Enum: "start" / "stop" |
order_count | integer Required | Total usage record count |
page_size | integer Required | Records per page |
page | integer Required | Current page number |
orders | array<EnergySmartOrderItem> Required | Usage records on the current page |
{
"type": "object",
"description": "。",
"properties": {
"address": {
"type": "string",
"description": "TRON "
},
"balance": {
"type": "string",
"description": " ()"
},
"status": {
"type": "string",
"enum": [
"start",
"stop"
],
"description": " (/)"
},
"order_count": {
"type": "integer",
"description": ""
},
"page_size": {
"type": "integer",
"description": ""
},
"page": {
"type": "integer",
"description": ""
},
"orders": {
"type": "array",
"description": "",
"items": {
"$ref": "#/components/schemas/EnergySmartOrderItem"
}
}
},
"required": [
"address",
"balance",
"status",
"order_count",
"page_size",
"page",
"orders"
]
}EnergySmartData Address status after a smart delegation update. Address status after a smart delegation update.
| Field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address |
balance | string Required | Available credit remaining, formatted string |
status | string Required | Service status: enabled / paused Enum: "start" / "stop" |
net_protect | string Not marked required | Bandwidth mode Enum: "open" / "close" |
{
"type": "object",
"description": "()。",
"properties": {
"address": {
"type": "string",
"description": "TRON "
},
"balance": {
"type": "string",
"description": " ()"
},
"status": {
"type": "string",
"enum": [
"start",
"stop"
],
"description": " (/)"
},
"net_protect": {
"type": "string",
"description": "",
"enum": [
"open",
"close"
]
}
},
"required": [
"address",
"balance",
"status"
]
}StatisticsDetail Smart delegation statistics for one period. Smart delegation statistics for one period.
| Field | Type / required | Description and constraints |
|---|---|---|
65k | integer Required | 65k operation count Example: 8 |
131k | integer Required | 131k operation count Example: 15 |
{
"type": "object",
"description": "。",
"properties": {
"65k": {
"type": "integer",
"description": "65k ",
"example": 8
},
"131k": {
"type": "integer",
"description": "131k ",
"example": 15
}
},
"required": [
"65k",
"131k"
]
}StatisticsSmartData Smart delegation statistics by address. Smart delegation statistics by address.
| Field | Type / required | Description and constraints |
|---|---|---|
days | object Required | Statistics for the last 5 days, keyed by YYYY-MM-DD. Dynamic key value: StatisticsDetail |
today | StatisticsDetail Required | Today's statistics |
yesterday | StatisticsDetail Required | Yesterday's statistics |
this_week | StatisticsDetail Required | This week, Monday to now |
this_month | StatisticsDetail Required | This month, from the 1st to now |
{
"type": "object",
"description": "。",
"properties": {
"days": {
"type": "object",
"description": " 5 ( YYYY-MM-DD)。",
"additionalProperties": {
"$ref": "#/components/schemas/StatisticsDetail"
}
},
"today": {
"$ref": "#/components/schemas/StatisticsDetail",
"description": ""
},
"yesterday": {
"$ref": "#/components/schemas/StatisticsDetail",
"description": ""
},
"this_week": {
"$ref": "#/components/schemas/StatisticsDetail",
"description": " ()"
},
"this_month": {
"$ref": "#/components/schemas/StatisticsDetail",
"description": " (1)"
}
},
"required": [
"days",
"today",
"yesterday",
"this_week",
"this_month"
]
}StatisticsTimesData Energy unit statistics by address. Energy unit statistics by address.
| Field | Type / required | Description and constraints |
|---|---|---|
days | object Required | Statistics for the last 5 days, keyed by YYYY-MM-DD. Dynamic key value: integer |
today | integer Required | Total units today Example: 5 |
yesterday | integer Required | Total units yesterday Example: 8 |
this_week | integer Required | Total units this week, since Monday Example: 30 |
this_month | integer Required | Total units this month, since the 1st Example: 150 |
{
"type": "object",
"description": "API 。",
"properties": {
"days": {
"type": "object",
"description": " 5 ( YYYY-MM-DD)。",
"additionalProperties": {
"type": "integer",
"example": 25,
"description": ""
}
},
"today": {
"type": "integer",
"example": 5,
"description": ""
},
"yesterday": {
"type": "integer",
"example": 8,
"description": ""
},
"this_week": {
"type": "integer",
"example": 30,
"description": " ()"
},
"this_month": {
"type": "integer",
"example": 150,
"description": " (1)"
}
},
"required": [
"days",
"today",
"yesterday",
"this_week",
"this_month"
]
}PremiumOrderRequest Field definition | Field | Type / required | Description and constraints |
|---|---|---|
username | string Required | Target Telegram username, without @. Example: "telegram_user" |
month | integer Required | Number of months to purchase. Enum: 3 / 6 / 12Example: 3 |
{
"type": "object",
"properties": {
"username": {
"type": "string",
"description": " Telegram ( @)。",
"example": "telegram_user"
},
"month": {
"type": "integer",
"description": "。",
"enum": [
3,
6,
12
],
"example": 3
}
},
"required": [
"username",
"month"
]
}StarOrderRequest Field definition | Field | Type / required | Description and constraints |
|---|---|---|
username | string Required | Target Telegram username, without @. Example: "channel_owner" |
count | integer Required | Number of Stars, 50–10000. Minimum: 50Maximum: 10000Example: 100 |
{
"type": "object",
"properties": {
"username": {
"type": "string",
"description": " Telegram ( @)。",
"example": "channel_owner"
},
"count": {
"type": "integer",
"description": " (50-10000)。",
"minimum": 50,
"maximum": 10000,
"example": 100
}
},
"required": [
"username",
"count"
]
}PremiumOrderResponseData Premium order submission result. Premium order submission result.
| Field | Type / required | Description and constraints |
|---|---|---|
username | string Required | Target username |
period | string Required | Purchase period, e.g. "3month" |
order_id | integer Required | Internal order ID |
amount | number · float Required | Order amount in TRX |
price | number · float Required | Price information |
pay_status | string Required | Payment status |
status | string Required | Order processing status |
{
"type": "object",
"description": "Premium 。",
"properties": {
"username": {
"type": "string",
"description": ""
},
"period": {
"type": "string",
"description": " ( \"3month\")"
},
"order_id": {
"type": "integer",
"description": " ID"
},
"amount": {
"type": "number",
"format": "float",
"description": " (TRX)"
},
"price": {
"type": "number",
"format": "float",
"description": ""
},
"pay_status": {
"type": "string",
"description": ""
},
"status": {
"type": "string",
"description": ""
}
},
"required": [
"username",
"period",
"order_id",
"amount",
"price",
"pay_status",
"status"
]
}StarOrderResponseData Stars order submission result. Stars order submission result.
| Field | Type / required | Description and constraints |
|---|---|---|
username | string Required | Target username |
count | integer Required | Number of Stars purchased |
order_id | integer Required | Internal order ID |
amount | number · float Required | Order amount in TRX |
price | number · float Required | Price information |
pay_status | string Required | Payment status |
status | string Required | Order processing status |
{
"type": "object",
"description": "。",
"properties": {
"username": {
"type": "string",
"description": ""
},
"count": {
"type": "integer",
"description": ""
},
"order_id": {
"type": "integer",
"description": " ID"
},
"amount": {
"type": "number",
"format": "float",
"description": " (TRX)"
},
"price": {
"type": "number",
"format": "float",
"description": ""
},
"pay_status": {
"type": "string",
"description": ""
},
"status": {
"type": "string",
"description": ""
}
},
"required": [
"username",
"count",
"order_id",
"amount",
"price",
"pay_status",
"status"
]
}PremiumQueryResultData Premium order query result. Premium order query result.
| Field | Type / required | Description and constraints |
|---|---|---|
username | string Not marked required | Target username Nullable |
nickname | string Not marked required | Target user's display name Nullable |
period | string Not marked required | Purchase period Nullable |
order_id | integer Required | Order ID |
amount | number · float Required | Order amount in TRX |
price | number · float Required | Price information |
pay_status | string Required | Payment status |
status | string Required | Order processing status |
remark | string Not marked required | Truncated note or failure reason Nullable |
create_time | string · date-time Not marked required | Order creation time Nullable |
{
"type": "object",
"description": "Premium 。",
"properties": {
"username": {
"type": "string",
"nullable": true,
"description": ""
},
"nickname": {
"type": "string",
"nullable": true,
"description": ""
},
"period": {
"type": "string",
"nullable": true,
"description": ""
},
"order_id": {
"type": "integer",
"description": " ID"
},
"amount": {
"type": "number",
"format": "float",
"description": " (TRX)"
},
"price": {
"type": "number",
"format": "float",
"description": ""
},
"pay_status": {
"type": "string",
"description": ""
},
"status": {
"type": "string",
"description": ""
},
"remark": {
"type": "string",
"nullable": true,
"description": "/ ()"
},
"create_time": {
"type": "string",
"format": "date-time",
"nullable": true,
"description": ""
}
},
"required": [
"order_id",
"amount",
"price",
"pay_status",
"status"
]
}StarQueryResultData Stars order query result. Stars order query result.
| Field | Type / required | Description and constraints |
|---|---|---|
username | string Not marked required | Target username Nullable |
nickname | string Not marked required | Target user's display name Nullable |
count | integer Not marked required | Number of Stars purchased Nullable |
order_id | integer Required | Order ID |
amount | number · float Required | Order amount in TRX |
price | number · float Required | Price information |
pay_status | string Required | Payment status |
status | string Required | Order processing status |
remark | string Not marked required | Truncated note or failure reason Nullable |
create_time | string · date-time Not marked required | Order creation time Nullable |
{
"type": "object",
"description": "。",
"properties": {
"username": {
"type": "string",
"nullable": true,
"description": ""
},
"nickname": {
"type": "string",
"nullable": true,
"description": ""
},
"count": {
"type": "integer",
"nullable": true,
"description": ""
},
"order_id": {
"type": "integer",
"description": " ID"
},
"amount": {
"type": "number",
"format": "float",
"description": " (TRX)"
},
"price": {
"type": "number",
"format": "float",
"description": ""
},
"pay_status": {
"type": "string",
"description": ""
},
"status": {
"type": "string",
"description": ""
},
"remark": {
"type": "string",
"nullable": true,
"description": "/ ()"
},
"create_time": {
"type": "string",
"format": "date-time",
"nullable": true,
"description": ""
}
},
"required": [
"order_id",
"amount",
"price",
"pay_status",
"status"
]
}FastRecoverOrderRequest Field definition | Field | Type / required | Description and constraints |
|---|---|---|
address | string Required | TRON address receiving resources Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx" |
count | integer Required | Amount of Energy or Bandwidth to top up Example: 65000 |
resource_type | string Required | Resource type Enum: "energy" / "net"Example: "energy" |
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": " TRON ",
"example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
},
"count": {
"type": "integer",
"description": "",
"example": 65000
},
"resource_type": {
"type": "string",
"description": "",
"enum": [
"energy",
"net"
],
"example": "energy"
}
},
"required": [
"address",
"count",
"resource_type"
]
}FastRecoverOrderResponseData Recharge order query result. Recharge order query result.
| Field | Type / required | Description and constraints |
|---|---|---|
order_id | integer Required | Internal order ID |
address | string Required | Target address |
energy_count | integer Required | Requested Energy or Bandwidth amount |
price | number · float Not marked required | Unit price in SUN Nullable |
fee | number · float Not marked required | Fee in TRX Nullable |
resource_type | string Required | Resource type Enum: "energy" / "net" |
amount | number · float Not marked required | Total amount in TRX Nullable |
status | string Required | Order status Enum: "waiting" / "success" / "failed" |
delegate_txid | string Not marked required | Delegation transaction hash Nullable |
reclaim_txid | string Not marked required | Reclaim transaction hash Nullable |
actual_recover_count | integer Not marked required | Actual top-up amount Nullable |
{
"type": "object",
"description": "。",
"properties": {
"order_id": {
"type": "integer",
"description": " ID"
},
"address": {
"type": "string",
"description": ""
},
"energy_count": {
"type": "integer",
"description": "/"
},
"price": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (SUN)"
},
"fee": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)"
},
"resource_type": {
"type": "string",
"description": "",
"enum": [
"energy",
"net"
]
},
"amount": {
"type": "number",
"format": "float",
"nullable": true,
"description": " (TRX)"
},
"status": {
"type": "string",
"description": "",
"enum": [
"waiting",
"success",
"failed"
]
},
"delegate_txid": {
"type": "string",
"nullable": true,
"description": ""
},
"reclaim_txid": {
"type": "string",
"nullable": true,
"description": ""
},
"actual_recover_count": {
"type": "integer",
"nullable": true,
"description": ""
}
},
"required": [
"order_id",
"address",
"energy_count",
"resource_type",
"status"
]
}API version 2.1.0 · Verified 2026-09-30
API definition source: API V2 documentation . This site provides setup guidance and preserves the full definition. Recheck it when the upstream service changes.
Download the full OpenAPI file