DUIYA DEVELOPERS / API V2

Bring Energy services
into your application

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

duiya.org / api
GET/user_info

balance_trx TRX balance

balance_usdt USDT balance

API V2 2.1.0 API reference 25 ENDPOINTS

api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.

00 / PUBLIC QUOTES

Public quotes (no API Key)

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.

Request example

Node.js server · no API Key
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 });

Fields and quote meaning

FieldMeaning
statusready 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.
updatedAtAn ISO 8601 UTC timestamp showing when the cached quotes were collected, not when a trade occurred.
prices[].priceTrxA decimal string representing the public retail price in TRX, not the wholesale cost.
quantity / period / unitEnergy quantity, validity period and billing unit. Energy quantity does not guarantee a transaction count. Confirm any missing values on the order confirmation screen.
channel / conditionsService 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 / modeQuote item ID and service type. Per-use API pricing must not be treated as the retail price of the bot's command rental service.

Usage rules

  • Use GET or HEAD without query parameters; HEAD has no response body. 400 means unsupported parameters, 405 means an unsupported method, and 503 means temporarily unavailable.
  • Check version=1, status and updatedAt first. Do not use data more than 5 minutes old, with a future timestamp, or with required fields missing. For partial, use only the quote items actually returned.
  • Read from your server at intervals of 60 seconds or longer and respect Cache-Control. Cross-origin browser CORS is not enabled. No availability SLA or inventory guarantee is provided.
  • Confirm the final amount, Energy validity, Bandwidth or other extras, and managed-tier eligibility on the bot's order screen. Public quotes are not completed trade records.

View current website quotes

01 / GET STARTED

Open an account before integrating

First contact Telegram @wanglei to arrange backend account access.

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

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

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

02 / AUTHENTICATION

Three headers and one signature

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.

Node.js: sign and query balance

Node.js · Server-side example · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
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

Check the available balance after a deposit

GEThttps://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.

JSON · Structure example, not a real balance · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "code": 1,
  "msg": "",
  "time": "1711961879",
  "data": {
    "balance_trx": "100.5000",
    "balance_usdt": "500.0000"
  }
}

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

04 / REQUEST FORMAT

Use each endpoint's specified method

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

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

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

Example: rent Energy for 1 hour

cURL · Replace every placeholder before use · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
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.

API errors and order results

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.

API errors and order results
HTTP statusMeaning and suggested action
400invalid parameters or an inactive address. Check count, period and address against the endpoint documentation.
401unauthorized. Check the API Key, signature and matching timestamp in seconds, then review API settings in the account dashboard.
403forbidden; the definition lists insufficient balance or abnormal user status. Check available funds and account status; contact @wanglei if needed.
500internal 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.

/query_result · OpenAPI V2

Which Energy rental prices can the API query?

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.

Which Energy rental prices can the API query?
PurposeMethod and endpointRequest details
Timed Energy or BandwidthGET /query_pricetype, count and period; use period=1h for one hour.
Energy or Bandwidth fast rechargePOST /query_fast_recover_priceresource_type and count are URL query parameters.
Smart managementGET /get_smart_priceGet current 65K and 131K management prices.
API transfer unitsGET /get_times_priceGet 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.

Smart delegation: four separate tiers

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.

Tier65K price field131K price field
Regular normaldata.65K_pricedata.131K_price
High frequency high_frequencydata.high_frequency.65k_pricedata.high_frequency.131k_price / data.high_frequency.131K_price
Jisu jisu_frequencydata.jisu_frequency.65k_pricedata.jisu_frequency.131k_price / data.jisu_frequency.131K_price
Guangsu guangsu_frequencydata.guangsu_frequency.65k_pricedata.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

Find the right endpoints

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

06 / ENDPOINT REFERENCE

Complete API reference 25

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

Account management

User information and account activation.

POST/active_account Activate a TRON address

Activate a TRON address

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

Full URL: https://api.invalid/api/v2/active_account

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

Request body required

Form field Type / required Description and constraints
addressstring Required TRON address to activate
Example: "TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"
Responses
HTTP 200 Activation request submitted.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataActivationData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Account Management)"
  ],
  "summary": " TRON ",
  "description": " TRON 。。",
  "operationId": "activeAccountV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ActivationData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " (:)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": " (:)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/user_info Get user information

Get user information

Get basic details for the authenticated user, including balances.

Full URL: https://api.invalid/api/v2/user_info

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataUserInfoData Not marked required User information result.
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Account Management)"
  ],
  "summary": "",
  "description": ",。",
  "operationId": "getUserInfoV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/UserInfoData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Resource orders

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

POST/buy_energy Buy timed Energy

Buy timed Energy

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

Full URL: https://api.invalid/api/v2/buy_energy

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

Request body required

Form field Type / required Description and constraints
countinteger Required Energy amount to delegate, minimum 30000
Example: 50000
periodstring Required Period, e.g. "15minutes", "1h", "1day", "3day"
Example: "1day"
addressstring Required TRON address receiving Energy
Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
Responses
HTTP 200 Order submitted successfully.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataEnergyOrderResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy/Bandwidth Orders)"
  ],
  "summary": "",
  "description": ",。",
  "operationId": "buyEnergyV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "count": {
              "type": "integer",
              "description": " ( 30000)",
              "example": 50000
            },
            "period": {
              "type": "string",
              "description": " (\"15minutes\",\"1h\", \"1day\", \"3day\")",
              "example": "1day"
            },
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "count",
            "period",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " (、)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": " (、)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/buy_net Buy timed Bandwidth

Buy timed Bandwidth

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

Full URL: https://api.invalid/api/v2/buy_net

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

Request body required

Form field Type / required Description and constraints
countinteger Required Bandwidth bytes to delegate, minimum 100
Example: 5000
periodstring Required Period, e.g. "1day", "3day"
Example: "3day"
addressstring Required TRON address receiving Bandwidth
Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
Responses
HTTP 200 Order submitted successfully.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataNetOrderResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 403 Forbidden

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy/Bandwidth Orders)"
  ],
  "summary": "",
  "description": ",。",
  "operationId": "buyNetV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "count": {
              "type": "integer",
              "description": " ( 100)",
              "example": 5000
            },
            "period": {
              "type": "string",
              "description": " ( \"1day\", \"3day\")",
              "example": "3day"
            },
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "count",
            "period",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/NetOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/reclaim_energy Reclaim Energy

Reclaim Energy

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

Full URL: https://api.invalid/api/v2/reclaim_energy

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

Request body required

Form field Type / required Description and constraints
order_snstring Required Original delegation order serial number
Example: "EN2025040217175512345"
addressstring Required Original resource receiving address
Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
Responses
HTTP 200 Reclaim request submitted.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy/Bandwidth Orders)"
  ],
  "summary": "",
  "description": ",()。。",
  "operationId": "reclaimEnergyV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "order_sn": {
              "type": "string",
              "description": "",
              "example": "EN2025040217175512345"
            },
            "address": {
              "type": "string",
              "description": "",
              "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
            }
          },
          "required": [
            "order_sn",
            "address"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BaseResponse"
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " (、,)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/query_result Query order result

Query order result

Get a resource order's processing status and details.

Full URL: https://api.invalid/api/v2/query_result

Headers and parameters
Parameter Location / type Description and constraints
x-api-key Required header
string
Your API Key.
x-timestamp Required header
integer
Current UNIX timestamp in seconds.
Example: 1711961879
x-signature Required header
string
Signature (lowercase hex HMAC-SHA256 of x-api-key + x-timestamp ).
Example: "a1b2c3d4e5f6..."
order_sn Required query
string
Unique serial number of the order
Example: "EN2025040217175512345"
Responses
HTTP 200 Order details retrieved. The data structure contains success details or failure information depending on status.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataQueryResultDataSuccess 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy/Bandwidth Orders)"
  ],
  "summary": "",
  "description": "。",
  "operationId": "queryResultV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_sn",
      "in": "query",
      "required": true,
      "description": "",
      "schema": {
        "type": "string",
        "example": "EN2025040217175512345"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。data 。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "oneOf": [
                      {
                        "$ref": "#/components/schemas/QueryResultDataSuccess"
                      },
                      {
                        "$ref": "#/components/schemas/QueryResultDataFailed"
                      }
                    ]
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/query_price Query resource price

Query resource price

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

Full URL: https://api.invalid/api/v2/query_price

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataResourcePriceData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy/Bandwidth Orders)"
  ],
  "summary": "",
  "description": "( energy  net)、,。",
  "operationId": "queryPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "type",
      "in": "query",
      "required": true,
      "description": " (\"energy\", \"net\")",
      "schema": {
        "type": "string",
        "enum": [
          "energy",
          "net"
        ],
        "example": "energy"
      }
    },
    {
      "name": "count",
      "in": "query",
      "required": true,
      "description": " ()",
      "schema": {
        "type": "integer",
        "example": 50000
      }
    },
    {
      "name": "period",
      "in": "query",
      "required": true,
      "description": " ( \"15minutes\",\"1h\", \"1day\", \"3day\")",
      "schema": {
        "type": "string",
        "example": "1day"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/ResourcePriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Instant recharge

Fast Energy and Bandwidth top-up services.

POST/query_fast_recover_price Query recharge price

Query recharge price

Get the recharge price.

Full URL: https://api.invalid/api/v2/query_fast_recover_price

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataFastRecoverPriceData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Fast Recover)"
  ],
  "summary": "/",
  "description": "",
  "operationId": "queryFastRecoverPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "resource_type",
      "in": "query",
      "required": true,
      "description": " (\"energy\", \"net\")",
      "schema": {
        "type": "string",
        "enum": [
          "energy",
          "net"
        ],
        "example": "energy"
      }
    },
    {
      "name": "count",
      "in": "query",
      "required": true,
      "description": " ()",
      "schema": {
        "type": "integer",
        "example": 100000
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/FastRecoverPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/buy_fast_recover Recharge Energy or Bandwidth

Recharge Energy or Bandwidth

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

Full URL: https://api.invalid/api/v2/buy_fast_recover

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

Request body required

Form field Type / required Description and constraints
addressstring Required TRON address receiving resources
Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
countinteger Required Amount of Energy or Bandwidth to top up
Example: 65000
resource_typestring Required Resource type
Enum: "energy" / "net"
Example: "energy"
Responses
HTTP 200 Recharge request submitted; query its status later.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nested field Type / required Description and constraints
order_idinteger Not marked required Recharge order ID
HTTP 400 Bad request: invalid parameters

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Fast Recover)"
  ],
  "summary": "/",
  "description": "。",
  "operationId": "buyFastRecoverV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/FastRecoverOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": ",。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "type": "object",
                    "properties": {
                      "order_id": {
                        "type": "integer",
                        "description": "ID"
                      }
                    }
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/query_fast_recover_order Query recharge order

Query recharge order

Get a recharge order's status and details.

Full URL: https://api.invalid/api/v2/query_fast_recover_order

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataFastRecoverOrderResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Fast Recover)"
  ],
  "summary": "",
  "description": "。",
  "operationId": "queryFastRecoverOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": " ID",
      "schema": {
        "type": "integer",
        "example": 123
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/FastRecoverOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ( ID )",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ( ID )",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Smart delegation

Smart Energy delegation operations.

GET/get_smart_price Get smart delegation prices

Get smart delegation prices

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

Full URL: https://api.invalid/api/v2/get_smart_price

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataSmartPriceData Not marked required Smart delegation pricing.
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Smart Delegation)"
  ],
  "summary": "",
  "description": " 65K  131K 。",
  "operationId": "getSmartPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/SmartPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/delegate_energy_smart Add smart delegation credit

Add smart delegation credit

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

Full URL: https://api.invalid/api/v2/delegate_energy_smart

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

Request body required

Form field Type / required Description and constraints
addressstring Required TRON address to credit
Example: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
balancenumber · float Required Positive credit amount, e.g. a TRX amount
Example: 10.5
channelstring 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_depositnumber Not marked required High-frequency deposit: -1 follows system settings; 0 means no deposit; other amounts deduct that deposit
Example: "0"
net_protectstring Not marked required Address Bandwidth protection mode
Enum: "open" / "close"
Example: "open"
Responses
HTTP 200 Delegation or credit increase successful

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataEnergySmartDelegateResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Smart Delegation)"
  ],
  "summary": "",
  "description": "()。",
  "operationId": "delegateEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
            },
            "balance": {
              "type": "number",
              "format": "float",
              "description": " ( TRX ,)",
              "example": 10.5
            },
            "channel": {
              "type": "string",
              "description": ":normal->,high_frequency->,jisu_frequency->,guangsu_frequency->",
              "enum": [
                "normal",
                "high_frequency",
                "jisu_frequency",
                "guangsu_frequency"
              ],
              "example": "high_frequency"
            },
            "hf_deposit": {
              "type": "number",
              "description": ":-1:   0:     :",
              "example": "0"
            },
            "net_protect": {
              "type": "string",
              "description": "",
              "enum": [
                "open",
                "close"
              ],
              "example": "open"
            }
          },
          "required": [
            "address",
            "balance"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "/",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartDelegateResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/query_energy_smart Query smart delegation status

Query smart delegation status

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

Full URL: https://api.invalid/api/v2/query_energy_smart

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataEnergySmartQueryResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Smart Delegation)"
  ],
  "summary": "",
  "description": "()、()。",
  "operationId": "queryEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": " TRON ",
      "schema": {
        "type": "string",
        "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
      }
    },
    {
      "$ref": "#/components/parameters/PageParam"
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartQueryResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/update_energy_smart Update smart delegation status

Update smart delegation status

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

Full URL: https://api.invalid/api/v2/update_energy_smart

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

Request body required

Form field Type / required Description and constraints
addressstring Required TRON address to update
Example: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
statusstring Required Target status
Enum: "start" / "stop"
Example: "start"
net_protectstring Not marked required Address Bandwidth protection mode
Enum: "open" / "close"
Example: "open"
Responses
HTTP 200 Status updated; returns the current status.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataEnergySmartData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Smart Delegation)"
  ],
  "summary": "",
  "description": " (\"start\")  (\"stop\") 。",
  "operationId": "updateEnergySmartV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
            },
            "status": {
              "type": "string",
              "description": "",
              "enum": [
                "start",
                "stop"
              ],
              "example": "start"
            },
            "net_protect": {
              "type": "string",
              "description": "",
              "enum": [
                "open",
                "close"
              ],
              "example": "open"
            }
          },
          "required": [
            "address",
            "status"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": ",。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergySmartData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " (、)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/statistics_smart_by_address Get smart delegation statistics

Get smart delegation statistics

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

Full URL: https://api.invalid/api/v2/statistics_smart_by_address

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataStatisticsSmartData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Smart Delegation)"
  ],
  "summary": "",
  "description": "(、、、、5)( 65k/131k )。",
  "operationId": "statisticsSmartByAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": " TRON ",
      "schema": {
        "type": "string",
        "example": "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StatisticsSmartData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Energy units

Unit-based Energy API operations.

GET/get_times_price Get unit-based Energy price

Get unit-based Energy price

Get the current per-transaction unit price.

Full URL: https://api.invalid/api/v2/get_times_price

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataTimesPriceData Not marked required Unit-based Energy pricing.
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy Times)"
  ],
  "summary": "API",
  "description": "API。",
  "operationId": "getTimesPriceV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/TimesPriceData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/delegate_energy_times Add Energy units

Add Energy units

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

Full URL: https://api.invalid/api/v2/delegate_energy_times

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

Request body required

Form field Type / required Description and constraints
addressstring Required TRON address receiving units
Example: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
timesinteger Required Units to add; positive integer
Example: 100
Responses
HTTP 200 Delegation successful.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataEnergyTimesDelegateResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy Times)"
  ],
  "summary": "API",
  "description": "()。",
  "operationId": "delegateEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
            },
            "times": {
              "type": "integer",
              "description": " ()",
              "example": 100
            }
          },
          "required": [
            "address",
            "times"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesDelegateResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/query_energy_times Query Energy unit status

Query Energy unit status

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

Full URL: https://api.invalid/api/v2/query_energy_times

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataEnergyTimesQueryResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy Times)"
  ],
  "summary": "API",
  "description": "、()。",
  "operationId": "queryEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": " TRON ",
      "schema": {
        "type": "string",
        "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
      }
    },
    {
      "$ref": "#/components/parameters/PageParam"
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesQueryResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/update_energy_times Update address unit-service status

Update address unit-service status

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

Full URL: https://api.invalid/api/v2/update_energy_times

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

Request body required

Form field Type / required Description and constraints
addressstring Required TRON address to update
Example: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
statusstring Required Target status
Enum: "start" / "stop"
Example: "stop"
Responses
HTTP 200 Status updated; returns the current status.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataEnergyTimesData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy Times)"
  ],
  "summary": "API",
  "description": " (\"start\")  (\"stop\") API。",
  "operationId": "updateEnergyTimesV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
            },
            "status": {
              "type": "string",
              "description": "",
              "enum": [
                "start",
                "stop"
              ],
              "example": "stop"
            }
          },
          "required": [
            "address",
            "status"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": ",。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/EnergyTimesData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " (、)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "429": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/statistics_times_by_address Get Energy unit statistics

Get Energy unit statistics

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

Full URL: https://api.invalid/api/v2/statistics_times_by_address

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataStatisticsTimesData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    " (Energy Times)"
  ],
  "summary": " API ",
  "description": "(、、、、5) API 。",
  "operationId": "statisticsTimesByAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "address",
      "in": "query",
      "required": true,
      "description": " TRON ",
      "schema": {
        "type": "string",
        "example": "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StatisticsTimesData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Fragment services

Order Telegram Premium and Stars via Fragment.

POST/buy_premium Buy Telegram Premium

Buy Telegram Premium

Create an order to gift Premium to a Telegram user.

Full URL: https://api.invalid/api/v2/buy_premium

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

Request body required

Form field Type / required Description and constraints
usernamestring Required Target Telegram username, without @.
Example: "telegram_user"
monthinteger Required Number of months to purchase.
Enum: 3 / 6 / 12
Example: 3
Responses
HTTP 200 Order submitted.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataPremiumOrderResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    "Fragment  (Premium/Stars Service)"
  ],
  "summary": " Telegram Premium ",
  "description": " Telegram  Premium 。",
  "operationId": "buyPremiumV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/PremiumOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PremiumOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/query_premium_order Query Premium order

Query Premium order

Get a Premium order's status and details.

Full URL: https://api.invalid/api/v2/query_premium_order

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataPremiumQueryResultData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    "Fragment  (Premium/Stars Service)"
  ],
  "summary": " Premium ",
  "description": " Premium 。",
  "operationId": "queryPremiumOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": " ID",
      "schema": {
        "type": "integer",
        "example": 5678
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/PremiumQueryResultData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ( ID )",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ( ID )",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
POST/buy_star Buy Telegram Stars

Buy Telegram Stars

Create an order to send Stars to a Telegram user.

Full URL: https://api.invalid/api/v2/buy_star

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

Request body required

Form field Type / required Description and constraints
usernamestring Required Target Telegram username, without @.
Example: "channel_owner"
countinteger Required Number of Stars, 50–10000.
Minimum: 50
Maximum: 10000
Example: 100
Responses
HTTP 200 Order submitted.

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataStarOrderResponseData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    "Fragment  (Premium/Stars Service)"
  ],
  "summary": " Telegram ",
  "description": " Telegram 。",
  "operationId": "buyStarV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "$ref": "#/components/schemas/StarOrderRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StarOrderResponseData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "403": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}
GET/query_star_order Query Stars order

Query Stars order

Get a Stars order's status and details.

Full URL: https://api.invalid/api/v2/query_star_order

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

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataStarQueryResultData 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "tags": [
    "Fragment  (Premium/Stars Service)"
  ],
  "summary": "",
  "description": "。",
  "operationId": "queryStarOrderV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    },
    {
      "name": "order_id",
      "in": "query",
      "required": true,
      "description": " ID",
      "schema": {
        "type": "integer",
        "example": 91011
      }
    }
  ],
  "responses": {
    "200": {
      "description": "。",
      "content": {
        "application/json": {
          "schema": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BaseResponse"
              },
              {
                "type": "object",
                "properties": {
                  "data": {
                    "$ref": "#/components/schemas/StarQueryResultData"
                  }
                }
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": " ( ID )",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": " ( ID )",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

Address consolidation

Manage automatic USDT consolidation addresses.

POST/submit_converge_address Submit consolidation settings

Submit consolidation settings

Configure automatic USDT consolidation rules for a TRON address.

Full URL: https://api.invalid/api/v2/submit_converge_address

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

Request body required

Form field Type / required Description and constraints
addressstring Required TRON address to configure
Example: "TConvergeAddressxxxxxxxxxxxxxxxxxx"
modestring Required Consolidation mode
Enum: "once" / "keep"
Example: "keep"
transfer_thresholdnumber · float Required Minimum balance threshold to trigger consolidation
Example: 100
balance_minnumber · float Required Minimum balance retained after consolidation
Example: 10
balance_maxnumber · float Required Maximum retained balance, must be >= min
Example: 20
energy_countinteger Required Energy supplied for consolidation
Example: 65000
typestring Required Service type provided to the address
Enum: "energy" / "all"
Example: "all"
notify_callbackstring · url Not marked required Optional callback URL for consolidation notifications
Nullable
Example: "https://yourcallback.com/notify"
Responses
HTTP 200 Settings submitted

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
HTTP 401 Unauthorized

application/json · Click a type for full fields

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject 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
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
View the complete OpenAPI definition
OpenAPI · JSON
{
  "tags": [
    " (Converge Address)"
  ],
  "summary": "",
  "description": " TRON  USDT 。",
  "operationId": "submitConvergeAddressV2",
  "parameters": [
    {
      "$ref": "#/components/parameters/XApiKeyHeader"
    },
    {
      "$ref": "#/components/parameters/XTimestampHeader"
    },
    {
      "$ref": "#/components/parameters/XSignatureHeader"
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/x-www-form-urlencoded": {
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": " TRON ",
              "example": "TConvergeAddressxxxxxxxxxxxxxxxxxx"
            },
            "mode": {
              "type": "string",
              "description": "",
              "enum": [
                "once",
                "keep"
              ],
              "example": "keep"
            },
            "transfer_threshold": {
              "type": "number",
              "format": "float",
              "description": "",
              "example": 100
            },
            "balance_min": {
              "type": "number",
              "format": "float",
              "description": "",
              "example": 10
            },
            "balance_max": {
              "type": "number",
              "format": "float",
              "description": " ( >= min)",
              "example": 20
            },
            "energy_count": {
              "type": "integer",
              "description": "",
              "example": 65000
            },
            "type": {
              "type": "string",
              "description": "",
              "enum": [
                "energy",
                "all"
              ],
              "example": "all"
            },
            "notify_callback": {
              "type": "string",
              "format": "url",
              "nullable": true,
              "description": ", URL",
              "example": "https://yourcallback.com/notify"
            }
          },
          "required": [
            "address",
            "mode",
            "transfer_threshold",
            "balance_min",
            "balance_max",
            "energy_count",
            "type"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/BaseResponse"
          }
        }
      }
    },
    "400": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "409": {
      "description": " ()",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    },
    "500": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ErrorResponse"
          }
        }
      }
    }
  }
}

07 / DATA MODELS

Complete data models

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

BaseResponse Field definition

Field Type / required Description and constraints
codeinteger Required Status code: 1 for success, 0 for failure.
Enum: 1
Example: 1
msgstring Required Response message.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required Response data payload.
Nullable
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer",
      "description": ",1 ,0 。",
      "enum": [
        1
      ],
      "example": 1
    },
    "msg": {
      "type": "string",
      "description": "。",
      "example": ""
    },
    "time": {
      "type": "string",
      "description": "。",
      "example": "1711961879"
    },
    "data": {
      "type": "object",
      "nullable": true,
      "description": "。"
    }
  },
  "required": [
    "code",
    "msg",
    "time"
  ]
}
ErrorResponse Field definition

Field Type / required Description and constraints
codeinteger Required Status code: 0 for failure.
Enum: 0
Example: 0
msgstring Required Error message description.
Example: ""
timestring Required Server response timestamp.
Example: "1711961879"
dataobject Not marked required
Nullable
Example: null
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "properties": {
    "code": {
      "type": "integer",
      "description": ",0 。",
      "enum": [
        0
      ],
      "example": 0
    },
    "msg": {
      "type": "string",
      "description": "。",
      "example": ""
    },
    "time": {
      "type": "string",
      "description": "。",
      "example": "1711961879"
    },
    "data": {
      "type": "object",
      "nullable": true,
      "example": null
    }
  },
  "required": [
    "code",
    "msg",
    "time"
  ]
}
ActivationData Response data after submitting account activation.

Response data after submitting account activation.

Field Type / required Description and constraints
tx_idstring Required Transaction hash; usually populated after the background job completes, initially empty.
Example: ""
order_idinteger Required Internal order ID tracking activation.
Example: 12345
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "tx_id": {
      "type": "string",
      "description": " (,)。",
      "example": ""
    },
    "order_id": {
      "type": "integer",
      "description": " ID。",
      "example": 12345
    }
  },
  "required": [
    "tx_id",
    "order_id"
  ]
}
EnergyOrderResponseData Data returned after an Energy order is submitted.

Data returned after an Energy order is submitted.

Field Type / required Description and constraints
order_snstring Required Unique order serial number.
Example: "EN2025040217175512345"
pricenumber · float Not marked required Calculated unit Energy price in SUN.
Nullable
Example: 35000000
feenumber · float Not marked required Additional fee in TRX.
Nullable
Example: 0.56
amountnumber · float Not marked required Total order cost in TRX.
Nullable
Example: 5.65
balancenumber · float Not marked required Account balance after the operation; may be inaccurate or omitted.
Nullable
Example: 94.35
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "order_sn": {
      "type": "string",
      "description": "。",
      "example": "EN2025040217175512345"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (SUN)。",
      "example": 35000000
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (TRX)。",
      "example": 0.56
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (TRX)。",
      "example": 5.65
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " ()。",
      "example": 94.35
    }
  },
  "required": [
    "order_sn"
  ]
}
NetOrderResponseData Data returned after a Bandwidth order is submitted.

Data returned after a Bandwidth order is submitted.

Field Type / required Description and constraints
order_snstring Required Unique order serial number.
Example: "NET2025040217180012345"
amountnumber · float Not marked required Total order cost in TRX.
Nullable
Example: 2.1
pricenumber · float Not marked required Calculated unit Bandwidth price; source lists unit as SUN?
Nullable
Example: 420000
feenumber · float Not marked required Additional fee in TRX.
Nullable
Example: 0
balancenumber · float Not marked required Account balance after the operation; may be inaccurate or omitted.
Nullable
Example: 97.9
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "order_sn": {
      "type": "string",
      "description": "。",
      "example": "NET2025040217180012345"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (TRX)。",
      "example": 2.1
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (SUN?)。",
      "example": 420000
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (TRX)。",
      "example": 0
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " ()。",
      "example": 97.9
    }
  },
  "required": [
    "order_sn"
  ]
}
QueryResultDataSuccess Details of a successfully queried order.

Details of a successfully queried order.

Field Type / required Description and constraints
order_snstring Required
amountnumber · float Not marked required Order amount in TRX
Nullable
pricenumber · float Not marked required Order unit price in SUN
Nullable
feenumber · float Not marked required Order fee in TRX
Nullable
periodstring Required Period name
statusstring Required Order status code
ordersarray<object> Required Child delegation orders
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "order_sn": {
      "type": "string"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (SUN)"
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": " (TRX)"
    },
    "period": {
      "type": "string",
      "description": ""
    },
    "status": {
      "type": "string",
      "description": ""
    },
    "orders": {
      "type": "array",
      "description": "()",
      "items": {
        "type": "object",
        "properties": {
          "from_address": {
            "type": "string",
            "description": ""
          },
          "tx_id": {
            "type": "string",
            "nullable": true,
            "description": ""
          },
          "count": {
            "type": "integer",
            "description": ""
          }
        },
        "required": [
          "from_address",
          "count"
        ]
      }
    }
  },
  "required": [
    "order_sn",
    "period",
    "status",
    "orders"
  ]
}
QueryResultDataFailed Basic details of a failed or unfinished order.

Basic details of a failed or unfinished order.

Field Type / required Description and constraints
order_snstring Required
amountnumber · float Not marked required
Nullable
pricenumber · float Not marked required
Nullable
feenumber · float Not marked required
Nullable
periodstring Not marked required
Nullable
statusstring Required Order status code
ordersarray<object> Required Empty array
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "order_sn": {
      "type": "string"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true
    },
    "period": {
      "type": "string",
      "nullable": true
    },
    "status": {
      "type": "string",
      "description": ""
    },
    "orders": {
      "type": "array",
      "items": {},
      "description": ""
    }
  },
  "required": [
    "order_sn",
    "status",
    "orders"
  ]
}
UserInfoData User information result.

User information result.

Field Type / required Description and constraints
balance_trxstring Required Available TRX balance as a formatted string.
Example: "100.5000"
balance_usdtstring Required Available USDT balance as a formatted string.
Example: "500.0000"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "balance_trx": {
      "type": "string",
      "description": " TRX  ()。",
      "example": "100.5000"
    },
    "balance_usdt": {
      "type": "string",
      "description": " USDT  ()。",
      "example": "500.0000"
    }
  },
  "required": [
    "balance_trx",
    "balance_usdt"
  ]
}
ResourcePriceData Resource price result.

Resource price result.

Field Type / required Description and constraints
priceinteger Required Unit price in SUN per period.
Example: 35
amountstring Required Estimated total in TRX for the requested quantity, including applicable fees.
Example: "5.6500"
feestring Required Additional fee in TRX, e.g. a small-order fee.
Example: "0.5600"
remarkstring Required Additional pricing notes, e.g. fee details.
Example: " 0.56 TRX "
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "price": {
      "type": "integer",
      "description": " (SUN / )。",
      "example": 35
    },
    "amount": {
      "type": "string",
      "description": " (:TRX),。",
      "example": "5.6500"
    },
    "fee": {
      "type": "string",
      "description": " (:TRX),。",
      "example": "0.5600"
    },
    "remark": {
      "type": "string",
      "description": " ()。",
      "example": " 0.56 TRX "
    }
  },
  "required": [
    "price",
    "amount",
    "fee",
    "remark"
  ]
}
FastRecoverPriceData Recharge price result

Recharge price result

Field Type / required Description and constraints
priceinteger Required Unit price in SUN.
Example: 100
amountstring Required Estimated total in TRX for the requested quantity, including applicable fees.
Example: "5.6500"
feestring Required Additional fee in TRX, e.g. a small-order fee.
Example: "0.5600"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "",
  "properties": {
    "price": {
      "type": "integer",
      "description": " (SUN)。",
      "example": 100
    },
    "amount": {
      "type": "string",
      "description": " (:TRX),。",
      "example": "5.6500"
    },
    "fee": {
      "type": "string",
      "description": " (:TRX),。",
      "example": "0.5600"
    }
  },
  "required": [
    "price",
    "amount",
    "fee",
    "remark"
  ]
}
SmartPriceData Smart delegation pricing.

Smart delegation pricing.

Field Type / required Description and constraints
65K_pricestring Required TRX price per 65K Energy delegation.
Example: "0.5000"
131K_pricestring Required TRX price per 131K Energy delegation.
Example: "0.9500"
remarkstring Not marked required
Nullable
Example: ":TRX/"
high_frequencyobject Not marked required High-frequency pricing, deposit and statistics period.
Nested field Type / required Description and constraints
65k_pricestring Not marked required High-frequency 65K price.
Nullable
Example: "0.8000"
131k_pricestring Not marked required High-frequency 131K price.
Nullable
Example: "1.5000"
deposit_periodstring Not marked required High-frequency statistics period in hours
Nullable
Example: "72"
deposit_amountstring Not marked required High-frequency deposit in TRX
Nullable
Example: 1000
min_energy_countstring Not marked required Minimum Energy usage in high-frequency mode
Nullable
Example: 200000
jisu_frequencyobject Not marked required Fast-mode pricing, deposit and statistics period.
Nested field Type / required Description and constraints
65k_pricestring Not marked required Fast-mode 65K price.
Nullable
Example: "0.8000"
131k_pricestring Not marked required Fast-mode 131K price.
Nullable
Example: "1.5000"
deposit_periodstring Not marked required Fast-mode statistics period in hours
Nullable
Example: "72"
deposit_amountstring Not marked required Fast-mode deposit in TRX
Nullable
Example: 1000
min_energy_countstring Not marked required Minimum Energy usage in fast mode
Nullable
Example: 200000
guangsu_frequencyobject Not marked required Light-speed pricing, deposit and statistics period.
Nested field Type / required Description and constraints
65k_pricestring Not marked required Light-speed 65K price.
Nullable
Example: "0.8000"
131k_pricestring Not marked required Light-speed 131K price.
Nullable
Example: "1.5000"
deposit_periodstring Not marked required Light-speed statistics period in hours
Nullable
Example: "72"
deposit_amountstring Not marked required Light-speed deposit in TRX
Nullable
Example: 1000
min_energy_countstring Not marked required Minimum Energy usage in light-speed mode
Nullable
Example: 200000
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "65K_price": {
      "type": "string",
      "description": " 65K  (TRX)。",
      "example": "0.5000"
    },
    "131K_price": {
      "type": "string",
      "description": " 131K  (TRX)。",
      "example": "0.9500"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "example": ":TRX/"
    },
    "high_frequency": {
      "type": "object",
      "description": ",、。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "65K。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "131K。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": ",:",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": ",: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "",
          "example": 200000
        }
      }
    },
    "jisu_frequency": {
      "type": "object",
      "description": ",、。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "65K。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "131K。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": ",:",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": ",: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "",
          "example": 200000
        }
      }
    },
    "guangsu_frequency": {
      "type": "object",
      "description": ",、。",
      "properties": {
        "65k_price": {
          "type": "string",
          "nullable": true,
          "description": "65K。",
          "example": "0.8000"
        },
        "131k_price": {
          "type": "string",
          "nullable": true,
          "description": "131K。",
          "example": "1.5000"
        },
        "deposit_period": {
          "type": "string",
          "nullable": true,
          "description": ",:",
          "example": "72"
        },
        "deposit_amount": {
          "type": "string",
          "nullable": true,
          "description": ",: TRX",
          "example": 1000
        },
        "min_energy_count": {
          "type": "string",
          "nullable": true,
          "description": "",
          "example": 200000
        }
      }
    }
  },
  "required": [
    "65K_price",
    "131K_price"
  ]
}
TimesPriceData Unit-based Energy pricing.

Unit-based Energy pricing.

Field Type / required Description and constraints
pricestring Required TRX price per Energy delegation.
Example: "0.6000"
remarkstring Not marked required
Nullable
Example: ":TRX/"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "API。",
  "properties": {
    "price": {
      "type": "string",
      "description": " (TRX)。",
      "example": "0.6000"
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "example": ":TRX/"
    }
  },
  "required": [
    "price"
  ]
}
EnergyTimesDelegateResponseData Unit delegation success data.

Unit delegation success data.

Field Type / required Description and constraints
addressstring Required Target delegation address
remain_timesinteger Required Units remaining after operation
statusstring Required Current service status
Enum: "start" / "stop"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "API。",
  "properties": {
    "address": {
      "type": "string",
      "description": ""
    },
    "remain_times": {
      "type": "integer",
      "description": ""
    },
    "status": {
      "type": "string",
      "description": "",
      "enum": [
        "start",
        "stop"
      ]
    }
  },
  "required": [
    "address",
    "remain_times",
    "status"
  ]
}
EnergyTimesOrderItem Energy unit usage record

Energy unit usage record

Field Type / required Description and constraints
remain_timesinteger Not marked required Units remaining after this usage
Nullable
statusstring Not marked required Energy status
Nullable
Enum: "init" / "waiting_delegate" / "delegate_success" / "delegate_failed" / "waiting_un_delegate" / "un_delegate_success" / "un_delegate_failed"
speed_modestring Not marked required Energy mode
Nullable
Enum: "normal" / "low_speed"
used_tx_idstring Not marked required Transaction hash that consumed Energy
Nullable
used_energyinteger Not marked required Energy consumed
Nullable
delegate_tx_idstring Not marked required Energy delegation transaction hash
Nullable
delegate_timeinteger Not marked required Delegation timestamp
Nullable
un_delegate_tx_idstring Not marked required Energy reclaim transaction hash
Nullable
un_delegate_timeinteger Not marked required Reclaim timestamp
Nullable
createtimeinteger Not marked required Record creation timestamp
Nullable
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "",
  "properties": {
    "remain_times": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "status": {
      "type": "string",
      "nullable": true,
      "description": "",
      "enum": [
        "init",
        "waiting_delegate",
        "delegate_success",
        "delegate_failed",
        "waiting_un_delegate",
        "un_delegate_success",
        "un_delegate_failed"
      ]
    },
    "speed_mode": {
      "type": "string",
      "nullable": true,
      "description": "",
      "enum": [
        "normal",
        "low_speed"
      ]
    },
    "used_tx_id": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "used_energy": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "un_delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "un_delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "createtime": {
      "type": "integer",
      "nullable": true,
      "description": ""
    }
  }
}
EnergyTimesQueryResponseData Unit-based service address query result.

Unit-based service address query result.

Field Type / required Description and constraints
addressstring Required TRON address
remain_timesinteger Required Available units remaining
statusstring Required Service status: enabled / paused
Enum: "start" / "stop"
order_countinteger Required Total usage record count
page_sizeinteger Required Records per page
pageinteger Required Current page number
ordersarray<EnergyTimesOrderItem> Required Usage records on the current page
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "API。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON "
    },
    "remain_times": {
      "type": "integer",
      "description": ""
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": " (/)"
    },
    "order_count": {
      "type": "integer",
      "description": ""
    },
    "page_size": {
      "type": "integer",
      "description": ""
    },
    "page": {
      "type": "integer",
      "description": ""
    },
    "orders": {
      "type": "array",
      "description": "",
      "items": {
        "$ref": "#/components/schemas/EnergyTimesOrderItem"
      }
    }
  },
  "required": [
    "address",
    "remain_times",
    "status",
    "order_count",
    "page_size",
    "page",
    "orders"
  ]
}
EnergyTimesData Address status after a unit-service update.

Address status after a unit-service update.

Field Type / required Description and constraints
addressstring Required TRON address
remain_timesinteger Required Available units remaining
statusstring Required Service status: enabled / paused
Enum: "start" / "stop"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "API()。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON "
    },
    "remain_times": {
      "type": "integer",
      "description": ""
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": " (/)"
    }
  },
  "required": [
    "address",
    "remain_times",
    "status"
  ]
}
EnergySmartDelegateResponseData Smart delegation success data.

Smart delegation success data.

Field Type / required Description and constraints
addressstring Required Target delegation address
balancestring Required Total balance after operation, formatted string
statusstring Required Current service status
Enum: "start" / "stop"
net_protectstring Not marked required Bandwidth mode
Enum: "open" / "close"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "address": {
      "type": "string",
      "description": ""
    },
    "balance": {
      "type": "string",
      "description": " ()"
    },
    "status": {
      "type": "string",
      "description": "",
      "enum": [
        "start",
        "stop"
      ]
    },
    "net_protect": {
      "type": "string",
      "description": "",
      "enum": [
        "open",
        "close"
      ]
    }
  },
  "required": [
    "address",
    "balance",
    "status"
  ]
}
EnergySmartOrderItem Smart delegation usage record

Smart delegation usage record

Field Type / required Description and constraints
energy_typestring Not marked required Energy type: 65k = 65K, 131k = 131K
Nullable
amountnumber · float Not marked required Amount spent
Nullable
balancenumber · float Not marked required Balance after usage
Nullable
currencystring Not marked required Currency
Nullable
Enum: "trx" / "usdt"
statusstring 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_idstring Not marked required Transaction hash that consumed Energy
Nullable
speed_modestring Not marked required Energy mode
Nullable
Enum: "normal" / "low_speed"
used_energyinteger Not marked required Energy consumed
Nullable
used_timesinteger Not marked required Units used
Nullable
remain_timesinteger Not marked required Total units remaining for the address
Nullable
delegate_countinteger Not marked required Delegated Energy amount
Nullable
delegate_tx_idstring Not marked required Energy delegation transaction hash
Nullable
delegate_timeinteger Not marked required Delegation timestamp
Nullable
un_delegate_tx_idstring Not marked required Energy reclaim transaction hash
Nullable
un_delegate_timeinteger Not marked required Reclaim timestamp
Nullable
createtimeinteger Not marked required Record creation timestamp
Nullable
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "",
  "properties": {
    "energy_type": {
      "type": "string",
      "nullable": true,
      "description": ": 65k=65K, 131k=131K"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": ""
    },
    "balance": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": ""
    },
    "currency": {
      "type": "string",
      "nullable": true,
      "description": "",
      "enum": [
        "trx",
        "usdt"
      ]
    },
    "status": {
      "type": "string",
      "nullable": true,
      "description": "",
      "enum": [
        "init",
        "waiting_delegate",
        "delegate_success",
        "delegate_failed",
        "waiting_un_delegate",
        "un_delegate_success",
        "un_delegate_failed"
      ]
    },
    "used_tx_id": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "speed_mode": {
      "type": "string",
      "nullable": true,
      "description": "",
      "enum": [
        "normal",
        "low_speed"
      ]
    },
    "used_energy": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "used_times": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "remain_times": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "delegate_count": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "un_delegate_tx_id": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "un_delegate_time": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "createtime": {
      "type": "integer",
      "nullable": true,
      "description": ""
    }
  }
}
EnergySmartQueryResponseData Smart delegation address query result.

Smart delegation address query result.

Field Type / required Description and constraints
addressstring Required TRON address
balancestring Required Available credit remaining, formatted string
statusstring Required Service status: enabled / paused
Enum: "start" / "stop"
order_countinteger Required Total usage record count
page_sizeinteger Required Records per page
pageinteger Required Current page number
ordersarray<EnergySmartOrderItem> Required Usage records on the current page
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON "
    },
    "balance": {
      "type": "string",
      "description": " ()"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": " (/)"
    },
    "order_count": {
      "type": "integer",
      "description": ""
    },
    "page_size": {
      "type": "integer",
      "description": ""
    },
    "page": {
      "type": "integer",
      "description": ""
    },
    "orders": {
      "type": "array",
      "description": "",
      "items": {
        "$ref": "#/components/schemas/EnergySmartOrderItem"
      }
    }
  },
  "required": [
    "address",
    "balance",
    "status",
    "order_count",
    "page_size",
    "page",
    "orders"
  ]
}
EnergySmartData Address status after a smart delegation update.

Address status after a smart delegation update.

Field Type / required Description and constraints
addressstring Required TRON address
balancestring Required Available credit remaining, formatted string
statusstring Required Service status: enabled / paused
Enum: "start" / "stop"
net_protectstring Not marked required Bandwidth mode
Enum: "open" / "close"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "()。",
  "properties": {
    "address": {
      "type": "string",
      "description": "TRON "
    },
    "balance": {
      "type": "string",
      "description": " ()"
    },
    "status": {
      "type": "string",
      "enum": [
        "start",
        "stop"
      ],
      "description": " (/)"
    },
    "net_protect": {
      "type": "string",
      "description": "",
      "enum": [
        "open",
        "close"
      ]
    }
  },
  "required": [
    "address",
    "balance",
    "status"
  ]
}
StatisticsDetail Smart delegation statistics for one period.

Smart delegation statistics for one period.

Field Type / required Description and constraints
65kinteger Required 65k operation count
Example: 8
131kinteger Required 131k operation count
Example: 15
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "65k": {
      "type": "integer",
      "description": "65k ",
      "example": 8
    },
    "131k": {
      "type": "integer",
      "description": "131k ",
      "example": 15
    }
  },
  "required": [
    "65k",
    "131k"
  ]
}
StatisticsSmartData Smart delegation statistics by address.

Smart delegation statistics by address.

Field Type / required Description and constraints
daysobject Required Statistics for the last 5 days, keyed by YYYY-MM-DD.
Dynamic key value: StatisticsDetail
todayStatisticsDetail Required Today's statistics
yesterdayStatisticsDetail Required Yesterday's statistics
this_weekStatisticsDetail Required This week, Monday to now
this_monthStatisticsDetail Required This month, from the 1st to now
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "days": {
      "type": "object",
      "description": " 5  ( YYYY-MM-DD)。",
      "additionalProperties": {
        "$ref": "#/components/schemas/StatisticsDetail"
      }
    },
    "today": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": ""
    },
    "yesterday": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": ""
    },
    "this_week": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": " ()"
    },
    "this_month": {
      "$ref": "#/components/schemas/StatisticsDetail",
      "description": " (1)"
    }
  },
  "required": [
    "days",
    "today",
    "yesterday",
    "this_week",
    "this_month"
  ]
}
StatisticsTimesData Energy unit statistics by address.

Energy unit statistics by address.

Field Type / required Description and constraints
daysobject Required Statistics for the last 5 days, keyed by YYYY-MM-DD.
Dynamic key value: integer
todayinteger Required Total units today
Example: 5
yesterdayinteger Required Total units yesterday
Example: 8
this_weekinteger Required Total units this week, since Monday
Example: 30
this_monthinteger Required Total units this month, since the 1st
Example: 150
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "API 。",
  "properties": {
    "days": {
      "type": "object",
      "description": " 5  ( YYYY-MM-DD)。",
      "additionalProperties": {
        "type": "integer",
        "example": 25,
        "description": ""
      }
    },
    "today": {
      "type": "integer",
      "example": 5,
      "description": ""
    },
    "yesterday": {
      "type": "integer",
      "example": 8,
      "description": ""
    },
    "this_week": {
      "type": "integer",
      "example": 30,
      "description": " ()"
    },
    "this_month": {
      "type": "integer",
      "example": 150,
      "description": " (1)"
    }
  },
  "required": [
    "days",
    "today",
    "yesterday",
    "this_week",
    "this_month"
  ]
}
PremiumOrderRequest Field definition

Field Type / required Description and constraints
usernamestring Required Target Telegram username, without @.
Example: "telegram_user"
monthinteger Required Number of months to purchase.
Enum: 3 / 6 / 12
Example: 3
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": " Telegram  ( @)。",
      "example": "telegram_user"
    },
    "month": {
      "type": "integer",
      "description": "。",
      "enum": [
        3,
        6,
        12
      ],
      "example": 3
    }
  },
  "required": [
    "username",
    "month"
  ]
}
StarOrderRequest Field definition

Field Type / required Description and constraints
usernamestring Required Target Telegram username, without @.
Example: "channel_owner"
countinteger Required Number of Stars, 50–10000.
Minimum: 50
Maximum: 10000
Example: 100
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "description": " Telegram  ( @)。",
      "example": "channel_owner"
    },
    "count": {
      "type": "integer",
      "description": " (50-10000)。",
      "minimum": 50,
      "maximum": 10000,
      "example": 100
    }
  },
  "required": [
    "username",
    "count"
  ]
}
PremiumOrderResponseData Premium order submission result.

Premium order submission result.

Field Type / required Description and constraints
usernamestring Required Target username
periodstring Required Purchase period, e.g. "3month"
order_idinteger Required Internal order ID
amountnumber · float Required Order amount in TRX
pricenumber · float Required Price information
pay_statusstring Required Payment status
statusstring Required Order processing status
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "Premium 。",
  "properties": {
    "username": {
      "type": "string",
      "description": ""
    },
    "period": {
      "type": "string",
      "description": " ( \"3month\")"
    },
    "order_id": {
      "type": "integer",
      "description": " ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": " (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": ""
    },
    "pay_status": {
      "type": "string",
      "description": ""
    },
    "status": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "username",
    "period",
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}
StarOrderResponseData Stars order submission result.

Stars order submission result.

Field Type / required Description and constraints
usernamestring Required Target username
countinteger Required Number of Stars purchased
order_idinteger Required Internal order ID
amountnumber · float Required Order amount in TRX
pricenumber · float Required Price information
pay_statusstring Required Payment status
statusstring Required Order processing status
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "username": {
      "type": "string",
      "description": ""
    },
    "count": {
      "type": "integer",
      "description": ""
    },
    "order_id": {
      "type": "integer",
      "description": " ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": " (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": ""
    },
    "pay_status": {
      "type": "string",
      "description": ""
    },
    "status": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "username",
    "count",
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}
PremiumQueryResultData Premium order query result.

Premium order query result.

Field Type / required Description and constraints
usernamestring Not marked required Target username
Nullable
nicknamestring Not marked required Target user's display name
Nullable
periodstring Not marked required Purchase period
Nullable
order_idinteger Required Order ID
amountnumber · float Required Order amount in TRX
pricenumber · float Required Price information
pay_statusstring Required Payment status
statusstring Required Order processing status
remarkstring Not marked required Truncated note or failure reason
Nullable
create_timestring · date-time Not marked required Order creation time
Nullable
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "Premium 。",
  "properties": {
    "username": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "nickname": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "period": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "order_id": {
      "type": "integer",
      "description": " ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": " (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": ""
    },
    "pay_status": {
      "type": "string",
      "description": ""
    },
    "status": {
      "type": "string",
      "description": ""
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "description": "/ ()"
    },
    "create_time": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": ""
    }
  },
  "required": [
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}
StarQueryResultData Stars order query result.

Stars order query result.

Field Type / required Description and constraints
usernamestring Not marked required Target username
Nullable
nicknamestring Not marked required Target user's display name
Nullable
countinteger Not marked required Number of Stars purchased
Nullable
order_idinteger Required Order ID
amountnumber · float Required Order amount in TRX
pricenumber · float Required Price information
pay_statusstring Required Payment status
statusstring Required Order processing status
remarkstring Not marked required Truncated note or failure reason
Nullable
create_timestring · date-time Not marked required Order creation time
Nullable
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "description": "。",
  "properties": {
    "username": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "nickname": {
      "type": "string",
      "nullable": true,
      "description": ""
    },
    "count": {
      "type": "integer",
      "nullable": true,
      "description": ""
    },
    "order_id": {
      "type": "integer",
      "description": " ID"
    },
    "amount": {
      "type": "number",
      "format": "float",
      "description": " (TRX)"
    },
    "price": {
      "type": "number",
      "format": "float",
      "description": ""
    },
    "pay_status": {
      "type": "string",
      "description": ""
    },
    "status": {
      "type": "string",
      "description": ""
    },
    "remark": {
      "type": "string",
      "nullable": true,
      "description": "/ ()"
    },
    "create_time": {
      "type": "string",
      "format": "date-time",
      "nullable": true,
      "description": ""
    }
  },
  "required": [
    "order_id",
    "amount",
    "price",
    "pay_status",
    "status"
  ]
}
FastRecoverOrderRequest Field definition

Field Type / required Description and constraints
addressstring Required TRON address receiving resources
Example: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
countinteger Required Amount of Energy or Bandwidth to top up
Example: 65000
resource_typestring Required Resource type
Enum: "energy" / "net"
Example: "energy"
Original model definition
OpenAPI · JSON
{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": " TRON ",
      "example": "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
    },
    "count": {
      "type": "integer",
      "description": "",
      "example": 65000
    },
    "resource_type": {
      "type": "string",
      "description": "",
      "enum": [
        "energy",
        "net"
      ],
      "example": "energy"
    }
  },
  "required": [
    "address",
    "count",
    "resource_type"
  ]
}
FastRecoverOrderResponseData Recharge order query result.

Recharge order query result.

Field Type / required Description and constraints
order_idinteger Required Internal order ID
addressstring Required Target address
energy_countinteger Required Requested Energy or Bandwidth amount
pricenumber · float Not marked required Unit price in SUN
Nullable
feenumber · float Not marked required Fee in TRX
Nullable
resource_typestring Required Resource type
Enum: "energy" / "net"
amountnumber · float Not marked required Total amount in TRX
Nullable
statusstring Required Order status
Enum: "waiting" / "success" / "failed"
delegate_txidstring Not marked required Delegation transaction hash
Nullable
reclaim_txidstring Not marked required Reclaim transaction hash
Nullable
actual_recover_countinteger Not marked required Actual top-up amount
Nullable
Original model definition
OpenAPI · JSON · api.invalid is a documentation placeholder and cannot be called. Contact @wanglei for the production API host.
{
  "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