DUIYA DEVELOPERS / API V2

Integra energía
en tu aplicación

API DuiYa: consulta saldos, alquila energía y gestiona direcciones.
Desde abrir la cuenta hasta tu primera solicitud.

duiya.org / api
GET/user_info

balance_trx Saldo TRX

balance_usdt Saldo USDT

API V2 2.1.0 Referencia API 25 ENDPOINTS

api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.

00 / PUBLIC QUOTES

Precios públicos sin API Key

Los desarrolladores y las plataformas de comparación de precios pueden consultar los precios públicos de venta de DuiYa mediante el recurso existente de solo lectura del sitio oficial. GET https://duiya.org/public/market

Este endpoint es distinto de las interfaces operativas de API V2 descritas más abajo, que requieren firma. Solo permite leer precios públicos: no crea pedidos, no realiza cargos ni devuelve datos de cuentas, pedidos o claves.

Ejemplo de solicitud

Node.js en el servidor, sin 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 });

Campos y significado de los precios

CampoDescripción
statusready indica datos completos; partial, datos parciales; stale, datos caducados; unavailable, datos no disponibles; unconfirmed, datos pendientes de confirmación. Solo se puede considerar el uso de datos con estado ready o partial.
updatedAtFecha y hora de recopilación de los datos para la caché, en formato ISO 8601 y UTC. No es la fecha y hora de una operación realizada.
prices[].priceTrxCadena decimal que representa el precio de venta al público en TRX. No es el coste del proveedor.
quantity / period / unitCantidad de energía, periodo de uso y unidad. La cantidad de energía no garantiza un número de transferencias. Si un valor está vacío, consulte la pantalla de confirmación del pedido.
channel / conditionsCanal del servicio y condiciones: nivel del servicio gestionado, periodo de cómputo en horas, depósito en TRX y cantidad mínima de energía. La ausencia de un campo no equivale a un valor de 0.
id / modeID de la entrada de precios y tipo de servicio. El precio de la API basado en el número de transferencias no debe tratarse como el precio de un servicio solicitado mediante un comando del bot.

Reglas de uso

  • Utilice GET y HEAD sin parámetros de consulta. La respuesta HEAD no tiene cuerpo. El código 400 indica parámetros no admitidos; 405, un método no admitido; y 503, indisponibilidad temporal.
  • Compruebe primero version=1, status y updatedAt. No considere válidos los precios con datos de más de 5 minutos, con una fecha futura o con campos obligatorios ausentes. Con partial, utilice solo las entradas de precios devueltas.
  • Consulte desde el servidor con un intervalo mínimo de 60 segundos y respete Cache-Control. No se ofrece CORS para acceso entre orígenes desde el navegador. No hay SLA de disponibilidad ni garantía de existencias.
  • El importe final, la vigencia de la energía, los servicios adicionales como el ancho de banda y los requisitos del servicio gestionado se determinan en la pantalla de confirmación del pedido del bot. Los precios públicos no representan operaciones realmente ejecutadas.

Ver los precios actuales del sitio oficial

01 / GET STARTED

Abre una cuenta antes de integrar

Primero contacta en Telegram con @wanglei para obtener acceso a la cuenta de administración.

Tras la activación, inicia sesión en la dirección facilitada por soporte. Confirma depósitos, saldo, permisos y precios antes de integrar.

  1. Inicia sesión en el panel Abre los ajustes de usuario API y revisa los datos y el saldo disponible tras depositar.
  2. Añade IP permitidas Añade la IP pública de salida del servidor que llama a la API y actualízala si cambia.
  3. Activa el acceso API Guarda los ajustes y confirma los permisos necesarios.
  4. Obtén API Key y API Secret Firma las solicitudes en tu servidor. Empieza consultando el saldo para verificar la configuración.

Los depósitos y las IP permitidas se gestionan en el panel. V2 no publica endpoints para añadir IP o consultar historial de depósitos; /user_info devuelve el saldo disponible actual.

02 / AUTHENTICATION

Tres cabeceras y una firma

Las interfaces operativas de API V2 descritas a continuación utilizan API Key y una firma. API Secret se utiliza únicamente para cálculos en el servidor y no se envía como parámetro.

Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
HMAC-SHA256(API Secret, API Key + timestamp)

Concatena API Key y timestamp sin separador. Usa hexadecimal en minúsculas. El tiempo es en segundos, dentro de ±5 minutos del servidor.

Node.js: firma y saldo

Node.js · Ejemplo de servidor · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
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);

Guarda las claves en variables de entorno del servidor. El timestamp de la cabecera debe coincidir con el de la firma.

03 / ACCOUNT BALANCE

Consultar saldo tras depositar

GEThttps://api.invalid/api/v2/user_info

No requiere parámetros de consulta; incluye las tres cabeceras de autenticación. Lee data.balance_trx y data.balance_usdt , ambos como cadenas formateadas.

JSON · Ejemplo, no es saldo real · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "code": 1,
  "msg": "操作成功",
  "time": "1711961879",
  "data": {
    "balance_trx": "100.5000",
    "balance_usdt": "500.0000"
  }
}

Para depósitos, acceso o IP permitidas, contacta con @wanglei . Campos completos: /user_info .

04 / REQUEST FORMAT

Usa el método indicado por endpoint

URL de documentación
https://duiya.org/api/
URL base de la API
https://api.invalid/api/v2
Ruta de compra de energía
/buy_energy
URL completa de solicitud
https://api.invalid/api/v2/buy_energy

Los parámetros GET van en la URL. Para POST usa formulario o query según la definición. La compra de energía usa POST, no GET. La autenticación siempre va en las cabeceras.

Nota: /query_fast_recover_price usa POST, pero resource_type y count son parámetros de la URL en la definición actual.

Ejemplo: alquilar energía por 1 hora

cURL · Sustituye todos los marcadores · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
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'

Esta solicitud crea un pedido de pago. Primero usa /query_price para revisar precio, dirección, cantidad, duración y saldo. Tras enviar un pedido asíncrono, usa /query_result para consultar el resultado.

duiya.org aloja la documentación; las solicitudes van a la URL del servicio indicada. Los precios, saldos y cantidades de ejemplo no son cotizaciones actuales.

Errores API y resultados de pedidos

Estos estados HTTP proceden de las respuestas de /buy_energy en la definición OpenAPI V2 del sitio. Para otras operaciones, revisa sus propias respuestas y comprueba también code y msg.

Errores API y resultados de pedidos
Estado HTTPSignificado y acción sugerida
400parámetros no válidos o dirección sin activar. Comprueba count, period y address según la documentación.
401sin autorización. Comprueba API Key, firma y la misma marca de tiempo en segundos, y después los ajustes API del panel.
403acceso prohibido; la definición incluye saldo insuficiente o estado anómalo del usuario. Comprueba saldo y cuenta; contacta con @wanglei si hace falta.
500error interno del servidor. Guarda la hora de la petición y el error sin datos sensibles. No vuelvas a crear inmediatamente el pedido de pago.

Un HTTP correcto no prueba el éxito de la operación: code=1 indica éxito y code=0 fallo. Tras enviar un pedido de energía asíncrono, utiliza el order_sn recibido con /query_result según la documentación. El envío no confirma la entrega.

Ante un tiempo de espera agotado, respuesta no JSON o resultado incierto, revisa primero los pedidos. Consulta el número de pedido existente; si no se recibió ninguno, pide verificación al soporte antes de reenviar un pedido de pago.

/query_result · OpenAPI V2

Delegación automática: cuatro niveles separados

Cada nivel ofrece precios separados para 65K y 131K. Alta frecuencia, Ultrarrápido y Velocidad de la luz pueden requerir depósito, periodo de medición y consumo mínimo de energía. Confirma las condiciones en el bot o panel.

NivelCampo de precio 65KCampo de precio 131K
Normal normaldata.65K_pricedata.131K_price
Alta frecuencia high_frequencydata.high_frequency.65k_pricedata.high_frequency.131k_price / data.high_frequency.131K_price
Ultrarrápido jisu_frequencydata.jisu_frequency.65k_pricedata.jisu_frequency.131k_price / data.jisu_frequency.131K_price
Velocidad de la luz guangsu_frequencydata.guangsu_frequency.65k_pricedata.guangsu_frequency.131k_price / data.guangsu_frequency.131K_price

GET /get_smart_price devuelve precios de proveedor para los cuatro niveles. El precio de venta mostrado para la delegación automática es el precio de proveedor × 1.02, redondeado a dos decimales. Los cargos API reales siguen el API y panel.

deposit_period: periodo de medición en horas; deposit_amount: depósito en TRX; min_energy_count: consumo mínimo de energía, no número de transferencias. Los precios ausentes o null no se sustituyen por otro nivel.

POST /delegate_energy_smart selecciona el nivel mediante channel. Confirma el depósito y la protección de ancho de banda net_protect según la configuración de la cuenta.

05 / ENERGY SERVICES

Encuentra los endpoints adecuados

También se documentan unidades, activación, consolidación y Fragment. Disponibilidad y precios dependen de permisos y respuestas reales de la API.

06 / ENDPOINT REFERENCE

Referencia API completa 25

Despliega un endpoint para ver parámetros, respuestas y definición. Pulsa un tipo para ver su modelo.

Gestión de cuenta

Información de usuario y activación.

POST/active_account Activar dirección TRON

Activar dirección TRON

Solicita activar una dirección. Se descuenta la tarifa del saldo.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON a activar
Ejemplo: "TNewAddressxxxxxxxxxxxxxxxxxxxxxxx"
Respuestas
HTTP 200 Solicitud de activación enviada.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataActivationData No marcado obligatorio Datos tras solicitar activación.
HTTP 400 Solicitud incorrecta, p. ej. formato de dirección

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado: autenticación fallida

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 403 Prohibido, p. ej. saldo insuficiente

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Obtener datos de usuario

Obtener datos de usuario

Obtiene datos básicos del usuario autenticado, incluidos saldos.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Respuestas
HTTP 200 Datos de usuario obtenidos.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataUserInfoData No marcado obligatorio Resultado de datos de usuario.
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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"
          }
        }
      }
    }
  }
}

Pedidos de recursos

Compra energía o ancho de banda por tiempo y gestiona pedidos.

POST/buy_energy Comprar energía por tiempo

Comprar energía por tiempo

Envía un pedido asíncrono para delegar energía a una dirección durante el periodo elegido.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
countinteger Obligatorio Energía a delegar, mínimo 30000
Ejemplo: 50000
periodstring Obligatorio Periodo: "15minutes", "1h", "1day", "3day"
Ejemplo: "1day"
addressstring Obligatorio Dirección TRON receptora de energía
Ejemplo: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
Respuestas
HTTP 200 Pedido enviado correctamente.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataEnergyOrderResponseData No marcado obligatorio Datos tras enviar el pedido de energía.
HTTP 400 Solicitud incorrecta: parámetros, dirección inactiva, etc.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 403 Prohibido: saldo insuficiente o estado anómalo

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Comprar ancho de banda por tiempo

Comprar ancho de banda por tiempo

Envía un pedido asíncrono de ancho de banda a una dirección por el periodo elegido.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
countinteger Obligatorio Bytes a delegar, mínimo 100
Ejemplo: 5000
periodstring Obligatorio Periodo: "1day", "3day"
Ejemplo: "3day"
addressstring Obligatorio Dirección TRON receptora de ancho de banda
Ejemplo: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
Respuestas
HTTP 200 Pedido enviado correctamente.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataNetOrderResponseData No marcado obligatorio Datos tras enviar el pedido de ancho de banda.
HTTP 400 Solicitud incorrecta

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 403 Prohibido

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Recuperar energía

Recuperar energía

Recupera recursos de forma asíncrona con el número del pedido completado y la dirección.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
order_snstring Obligatorio Número del pedido original
Ejemplo: "EN2025040217175512345"
addressstring Obligatorio Dirección receptora original
Ejemplo: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
Respuestas
HTTP 200 Solicitud de recuperación enviada.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio Datos de respuesta.
Admite null
HTTP 400 Solicitud incorrecta: número o dirección

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 No encontrado: pedido, propietario o recursos recuperables

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Consultar resultado del pedido

Consultar resultado del pedido

Obtiene el estado y los detalles de un pedido de recursos.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
order_sn Obligatorio query
string
Número único del pedido
Ejemplo: "EN2025040217175512345"
Respuestas
HTTP 200 Detalles obtenidos. La estructura data contiene datos de éxito o error según el estado.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataQueryResultDataSuccess o QueryResultDataFailed No marcado obligatorio
HTTP 400 Solicitud incorrecta: número de pedido

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Pedido no encontrado o de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error del servidor o de consulta

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Consultar precio de recursos

Consultar precio de recursos

Estima el precio por tipo (energy o net), cantidad y periodo.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
type Obligatorio query
string
Tipo de recurso ("energy", "net")
Valores: "energy" / "net"
Ejemplo: "energy"
count Obligatorio query
integer
Puntos de energía o bytes de ancho de banda
Ejemplo: 50000
period Obligatorio query
string
Periodo: "15minutes", "1h", "1day", "3day"
Ejemplo: "1day"
Respuestas
HTTP 200 Precio calculado.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataResourcePriceData No marcado obligatorio Resultado del precio.
HTTP 400 Solicitud incorrecta: parámetros inválidos

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Precio no configurado o no disponible

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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"
          }
        }
      }
    }
  }
}

Recarga rápida

Recarga rápida de energía y ancho de banda.

POST/query_fast_recover_price Consultar precio de recarga

Consultar precio de recarga

Obtiene el precio de recarga.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
resource_type Obligatorio query
string
Tipo de recurso ("energy", "net")
Valores: "energy" / "net"
Ejemplo: "energy"
count Obligatorio query
integer
Cantidad de energía o ancho de banda
Ejemplo: 100000
Respuestas
HTTP 200 Precio calculado.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataFastRecoverPriceData No marcado obligatorio Resultado del precio de recarga
HTTP 400 Solicitud incorrecta: parámetros inválidos

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Precio no configurado o no disponible

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Recargar energía o ancho de banda

Recargar energía o ancho de banda

Realiza una recarga única de energía o ancho de banda a una dirección.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON receptora
Ejemplo: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
countinteger Obligatorio Cantidad de energía o ancho de banda a recargar
Ejemplo: 65000
resource_typestring Obligatorio Tipo de recurso
Valores: "energy" / "net"
Ejemplo: "energy"
Respuestas
HTTP 200 Recarga solicitada; consulta el estado después.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Subcampo Tipo / obligatorio Descripción y restricciones
order_idinteger No marcado obligatorio ID de pedido de recarga
HTTP 400 Solicitud incorrecta: parámetros inválidos

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 403 Prohibido, p. ej. saldo insuficiente

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Consultar pedido de recarga

Consultar pedido de recarga

Obtiene el estado y detalles de una recarga.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
order_id Obligatorio query
integer
ID de recarga a consultar
Ejemplo: 123
Respuestas
HTTP 200 Consulta correcta.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataFastRecoverOrderResponseData No marcado obligatorio Resultado de consulta de recarga.
HTTP 400 Solicitud incorrecta: ID inválido

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Pedido inexistente o de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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"
          }
        }
      }
    }
  }
}

Gestión automática

Operaciones de gestión automática de energía.

GET/get_smart_price Obtener precios de gestión automática

Obtener precios de gestión automática

Obtiene precios actuales de gestión para 65K y 131K de energía.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Respuestas
HTTP 200 Precios obtenidos.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataSmartPriceData No marcado obligatorio Precios de gestión automática.
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Parte o todos los precios no disponibles

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Añadir saldo de gestión automática

Añadir saldo de gestión automática

Aumenta el saldo disponible de gestión de una dirección.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON a acreditar
Ejemplo: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
balancenumber · float Obligatorio Importe positivo a añadir, p. ej. TRX
Ejemplo: 10.5
channelstring No marcado obligatorio Modo: normal = normal; high_frequency = alta frecuencia; jisu_frequency = rápido; guangsu_frequency = velocidad luz
Valores: "normal" / "high_frequency" / "jisu_frequency" / "guangsu_frequency"
Ejemplo: "high_frequency"
hf_depositnumber No marcado obligatorio Depósito: -1 usa el del sistema; 0 sin depósito; otro importe se descuenta
Ejemplo: "0"
net_protectstring No marcado obligatorio Modo de protección de ancho de banda
Valores: "open" / "close"
Ejemplo: "open"
Respuestas
HTTP 200 Delegación o aumento de saldo correcto

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataEnergySmartDelegateResponseData No marcado obligatorio Datos de delegación correcta.
HTTP 400 Solicitud incorrecta: dirección o importe

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 429 Demasiadas solicitudes, si hay bloqueo

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Consultar estado de gestión

Consultar estado de gestión

Obtiene saldo restante, estado e historial paginado de una dirección.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
address Obligatorio query
string
Dirección TRON a consultar
Ejemplo: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
page Obligatorio query
integer
Página, desde 1
Mínimo: 1
Ejemplo: 1
Respuestas
HTTP 200 Consulta correcta.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataEnergySmartQueryResponseData No marcado obligatorio Resultado de consulta de gestión.
HTTP 400 Solicitud incorrecta: dirección o página

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Servicio inactivo o dirección de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Actualizar estado de gestión

Actualizar estado de gestión

Inicia ("start") o pausa ("stop") la gestión de una dirección.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON a actualizar
Ejemplo: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
statusstring Obligatorio Estado deseado
Valores: "start" / "stop"
Ejemplo: "start"
net_protectstring No marcado obligatorio Modo de protección de ancho de banda
Valores: "open" / "close"
Ejemplo: "open"
Respuestas
HTTP 200 Estado actualizado; devuelve el actual.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataEnergySmartData No marcado obligatorio Estado de la dirección tras actualizar gestión.
HTTP 400 Solicitud incorrecta: dirección o estado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Servicio inactivo o dirección de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 409 Conflicto: ya tiene ese estado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 429 Demasiadas solicitudes, si hay bloqueo

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Estadísticas de gestión

Estadísticas de gestión

Uso por dirección hoy, ayer, semana, mes y últimos 5 días, separado en 65k/131k.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
address Obligatorio query
string
Dirección TRON para estadísticas
Ejemplo: "TSmartAddressxxxxxxxxxxxxxxxxxxxxx"
Respuestas
HTTP 200 Estadísticas obtenidas.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataStatisticsSmartData No marcado obligatorio Estadísticas de gestión por dirección.
HTTP 400 Solicitud incorrecta: formato de dirección

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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"
          }
        }
      }
    }
  }
}

Unidades de energía

API de energía por unidades.

GET/get_times_price Precio de energía por unidad

Precio de energía por unidad

Obtiene el precio actual por operación.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Respuestas
HTTP 200 Precios obtenidos.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataTimesPriceData No marcado obligatorio Precios de energía por unidades.
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Precio no disponible

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Añadir unidades de energía

Añadir unidades de energía

Añade unidades de energía a una dirección, con cobro por uso.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON que recibe unidades
Ejemplo: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
timesinteger Obligatorio Unidades a añadir; entero positivo
Ejemplo: 100
Respuestas
HTTP 200 Delegación correcta.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataEnergyTimesDelegateResponseData No marcado obligatorio Datos de asignación de unidades.
HTTP 400 Solicitud incorrecta: dirección o unidades

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 429 Demasiadas solicitudes, si hay bloqueo

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno, p. ej. base de datos

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Consultar estado de unidades

Consultar estado de unidades

Obtiene unidades restantes, estado e historial paginado de una dirección.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
address Obligatorio query
string
Dirección TRON a consultar
Ejemplo: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
page Obligatorio query
integer
Página, desde 1
Mínimo: 1
Ejemplo: 1
Respuestas
HTTP 200 Consulta correcta.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataEnergyTimesQueryResponseData No marcado obligatorio Resultado de consulta de unidades.
HTTP 400 Solicitud incorrecta: dirección o página

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Servicio inactivo o dirección de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Actualizar estado de unidades

Actualizar estado de unidades

Inicia ("start") o pausa ("stop") la energía por unidades de una dirección.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON a actualizar
Ejemplo: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
statusstring Obligatorio Estado deseado
Valores: "start" / "stop"
Ejemplo: "stop"
Respuestas
HTTP 200 Estado actualizado; devuelve el actual.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataEnergyTimesData No marcado obligatorio Estado tras actualizar el servicio por unidades.
HTTP 400 Solicitud incorrecta: dirección o estado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Servicio inactivo o dirección de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 409 Conflicto: ya tiene ese estado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 429 Demasiadas solicitudes, si hay bloqueo

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Estadísticas de unidades

Estadísticas de unidades

Unidades consumidas por dirección hoy, ayer, semana, mes y últimos 5 días.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
address Obligatorio query
string
Dirección TRON para estadísticas
Ejemplo: "TDelAddressxxxxxxxxxxxxxxxxxxxxxxx"
Respuestas
HTTP 200 Estadísticas obtenidas.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataStatisticsTimesData No marcado obligatorio Estadísticas de unidades por dirección.
HTTP 400 Solicitud incorrecta: formato de dirección

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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"
          }
        }
      }
    }
  }
}

Servicios Fragment

Pedidos de Telegram Premium y Stars mediante Fragment.

POST/buy_premium Comprar Telegram Premium

Comprar Telegram Premium

Crea un pedido para regalar Premium a un usuario.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
usernamestring Obligatorio Usuario de Telegram sin @.
Ejemplo: "telegram_user"
monthinteger Obligatorio Meses a comprar.
Valores: 3 / 6 / 12
Ejemplo: 3
Respuestas
HTTP 200 Pedido enviado.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataPremiumOrderResponseData No marcado obligatorio Resultado del pedido Premium.
HTTP 400 Solicitud incorrecta: usuario o meses

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 403 Prohibido: saldo insuficiente

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Consultar pedido Premium

Consultar pedido Premium

Obtiene estado y detalles del pedido Premium.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
order_id Obligatorio query
integer
ID interno del pedido a consultar
Ejemplo: 5678
Respuestas
HTTP 200 Detalles del pedido obtenidos.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataPremiumQueryResultData No marcado obligatorio Resultado de consulta Premium.
HTTP 400 Solicitud incorrecta: ID inválido

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Pedido inexistente o de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Comprar Telegram Stars

Comprar Telegram Stars

Crea un pedido para enviar Stars a un usuario.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
usernamestring Obligatorio Usuario de Telegram sin @.
Ejemplo: "channel_owner"
countinteger Obligatorio Cantidad de Stars: 50–10000.
Mínimo: 50
Máximo: 10000
Ejemplo: 100
Respuestas
HTTP 200 Pedido enviado.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataStarOrderResponseData No marcado obligatorio Resultado del pedido Stars.
HTTP 400 Solicitud incorrecta: usuario o cantidad

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 403 Prohibido: saldo insuficiente

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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 Consultar pedido Stars

Consultar pedido Stars

Obtiene estado y detalles del pedido Stars.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
order_id Obligatorio query
integer
ID interno del pedido a consultar
Ejemplo: 91011
Respuestas
HTTP 200 Detalles del pedido obtenidos.

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataStarQueryResultData No marcado obligatorio Resultado de consulta Stars.
HTTP 400 Solicitud incorrecta: ID inválido

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 404 Pedido inexistente o de otro usuario

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "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"
          }
        }
      }
    }
  }
}

Consolidación de direcciones

Gestionar direcciones de consolidación automática USDT.

POST/submit_converge_address Enviar ajustes de consolidación

Enviar ajustes de consolidación

Configura reglas de consolidación USDT para una dirección TRON.

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

Cabeceras y parámetros
Parámetro Ubicación / tipo Descripción y restricciones
x-api-key Obligatorio header
string
Tu API Key.
x-timestamp Obligatorio header
integer
Marca de tiempo UNIX actual en segundos.
Ejemplo: 1711961879
x-signature Obligatorio header
string
Firma (HMAC-SHA256 hexadecimal en minúsculas de x-api-key + x-timestamp ).
Ejemplo: "a1b2c3d4e5f6..."
Cuerpo · application/x-www-form-urlencoded

Cuerpo obligatorio

Campo de formulario Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON a configurar
Ejemplo: "TConvergeAddressxxxxxxxxxxxxxxxxxx"
modestring Obligatorio Modo de consolidación
Valores: "once" / "keep"
Ejemplo: "keep"
transfer_thresholdnumber · float Obligatorio Saldo mínimo para activar la consolidación
Ejemplo: 100
balance_minnumber · float Obligatorio Saldo mínimo retenido después
Ejemplo: 10
balance_maxnumber · float Obligatorio Saldo máximo retenido, >= min
Ejemplo: 20
energy_countinteger Obligatorio Energía para la consolidación
Ejemplo: 65000
typestring Obligatorio Tipo de servicio para la dirección
Valores: "energy" / "all"
Ejemplo: "all"
notify_callbackstring · url No marcado obligatorio URL opcional para notificar la consolidación
Admite null
Ejemplo: "https://yourcallback.com/notify"
Respuestas
HTTP 200 Ajustes enviados

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio Datos de respuesta.
Admite null
HTTP 400 Solicitud incorrecta: parámetros inválidos

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 401 No autorizado

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 409 Conflicto: ya existe una configuración activa

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
HTTP 500 Error interno del servidor

application/json · Pulsa un tipo para ver campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Ver definición OpenAPI completa
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

Modelos de datos completos

Los campos coinciden con V2. Las respuestas correctas suelen incluir code , msg , time , data ; consulta cada modelo para los campos específicos.

BaseResponse Definición de campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código: 1 éxito, 0 error.
Valores: 1
Ejemplo: 1
msgstring Obligatorio Mensaje de respuesta.
Ejemplo: "操作成功"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio Datos de respuesta.
Admite null
Definición original
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 Definición de campos

Campo Tipo / obligatorio Descripción y restricciones
codeinteger Obligatorio Código 0: error.
Valores: 0
Ejemplo: 0
msgstring Obligatorio Descripción del error.
Ejemplo: "参数错误"
timestring Obligatorio Marca de tiempo de respuesta.
Ejemplo: "1711961879"
dataobject No marcado obligatorio
Admite null
Ejemplo: null
Definición original
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 Datos tras solicitar activación.

Datos tras solicitar activación.

Campo Tipo / obligatorio Descripción y restricciones
tx_idstring Obligatorio Hash de transacción; suele aparecer al terminar la tarea, inicialmente vacío.
Ejemplo: ""
order_idinteger Obligatorio ID interno para seguir la activación.
Ejemplo: 12345
Definición original
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 Datos tras enviar el pedido de energía.

Datos tras enviar el pedido de energía.

Campo Tipo / obligatorio Descripción y restricciones
order_snstring Obligatorio Número único de pedido.
Ejemplo: "EN2025040217175512345"
pricenumber · float No marcado obligatorio Precio unitario de energía en SUN.
Admite null
Ejemplo: 35000000
feenumber · float No marcado obligatorio Cargo adicional en TRX.
Admite null
Ejemplo: 0.56
amountnumber · float No marcado obligatorio Coste total del pedido en TRX.
Admite null
Ejemplo: 5.65
balancenumber · float No marcado obligatorio Saldo posterior; puede ser inexacto u omitirse.
Admite null
Ejemplo: 94.35
Definición original
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 Datos tras enviar el pedido de ancho de banda.

Datos tras enviar el pedido de ancho de banda.

Campo Tipo / obligatorio Descripción y restricciones
order_snstring Obligatorio Número único de pedido.
Ejemplo: "NET2025040217180012345"
amountnumber · float No marcado obligatorio Coste total del pedido en TRX.
Admite null
Ejemplo: 2.1
pricenumber · float No marcado obligatorio Precio unitario de ancho de banda; el original indica SUN?
Admite null
Ejemplo: 420000
feenumber · float No marcado obligatorio Cargo adicional en TRX.
Admite null
Ejemplo: 0
balancenumber · float No marcado obligatorio Saldo posterior; puede ser inexacto u omitirse.
Admite null
Ejemplo: 97.9
Definición original
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 Detalles del pedido consultado correctamente.

Detalles del pedido consultado correctamente.

Campo Tipo / obligatorio Descripción y restricciones
order_snstring Obligatorio
amountnumber · float No marcado obligatorio Importe del pedido en TRX
Admite null
pricenumber · float No marcado obligatorio Precio unitario en SUN
Admite null
feenumber · float No marcado obligatorio Comisión del pedido en TRX
Admite null
periodstring Obligatorio Nombre del periodo
statusstring Obligatorio Código de estado del pedido
ordersarray<object> Obligatorio Subpedidos de delegación
Definición original
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 Datos básicos de pedido fallido o pendiente.

Datos básicos de pedido fallido o pendiente.

Campo Tipo / obligatorio Descripción y restricciones
order_snstring Obligatorio
amountnumber · float No marcado obligatorio
Admite null
pricenumber · float No marcado obligatorio
Admite null
feenumber · float No marcado obligatorio
Admite null
periodstring No marcado obligatorio
Admite null
statusstring Obligatorio Código de estado del pedido
ordersarray<object> Obligatorio Array vacío
Definición original
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 Resultado de datos de usuario.

Resultado de datos de usuario.

Campo Tipo / obligatorio Descripción y restricciones
balance_trxstring Obligatorio Saldo TRX disponible como cadena formateada.
Ejemplo: "100.5000"
balance_usdtstring Obligatorio Saldo USDT disponible como cadena formateada.
Ejemplo: "500.0000"
Definición original
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 Resultado del precio.

Resultado del precio.

Campo Tipo / obligatorio Descripción y restricciones
priceinteger Obligatorio Precio unitario SUN por periodo.
Ejemplo: 35
amountstring Obligatorio Total estimado en TRX para la cantidad, con cargos aplicables.
Ejemplo: "5.6500"
feestring Obligatorio Cargo adicional en TRX, p. ej. por pedido pequeño.
Ejemplo: "0.5600"
remarkstring Obligatorio Notas de cálculo, p. ej. detalle de comisiones.
Ejemplo: "包含 0.56 TRX 带宽手续费"
Definición original
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 Resultado del precio de recarga

Resultado del precio de recarga

Campo Tipo / obligatorio Descripción y restricciones
priceinteger Obligatorio Precio unitario en SUN.
Ejemplo: 100
amountstring Obligatorio Total estimado en TRX para la cantidad, con cargos aplicables.
Ejemplo: "5.6500"
feestring Obligatorio Cargo adicional en TRX, p. ej. por pedido pequeño.
Ejemplo: "0.5600"
Definición original
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 Precios de gestión automática.

Precios de gestión automática.

Campo Tipo / obligatorio Descripción y restricciones
65K_pricestring Obligatorio Precio TRX por delegación de 65K.
Ejemplo: "0.5000"
131K_pricestring Obligatorio Precio TRX por delegación de 131K.
Ejemplo: "0.9500"
remarkstring No marcado obligatorio
Admite null
Ejemplo: "价格单位:TRX/次"
high_frequencyobject No marcado obligatorio Alta frecuencia: precios, depósito y periodo estadístico.
Subcampo Tipo / obligatorio Descripción y restricciones
65k_pricestring No marcado obligatorio Precio 65K en alta frecuencia.
Admite null
Ejemplo: "0.8000"
131k_pricestring No marcado obligatorio Precio 131K en alta frecuencia.
Admite null
Ejemplo: "1.5000"
deposit_periodstring No marcado obligatorio Periodo estadístico de alta frecuencia, horas
Admite null
Ejemplo: "72"
deposit_amountstring No marcado obligatorio Depósito de alta frecuencia en TRX
Admite null
Ejemplo: 1000
min_energy_countstring No marcado obligatorio Uso mínimo de energía en alta frecuencia
Admite null
Ejemplo: 200000
jisu_frequencyobject No marcado obligatorio Modo rápido: precios, depósito y periodo.
Subcampo Tipo / obligatorio Descripción y restricciones
65k_pricestring No marcado obligatorio Precio 65K en modo rápido.
Admite null
Ejemplo: "0.8000"
131k_pricestring No marcado obligatorio Precio 131K en modo rápido.
Admite null
Ejemplo: "1.5000"
deposit_periodstring No marcado obligatorio Periodo estadístico rápido, horas
Admite null
Ejemplo: "72"
deposit_amountstring No marcado obligatorio Depósito de modo rápido en TRX
Admite null
Ejemplo: 1000
min_energy_countstring No marcado obligatorio Uso mínimo de energía en modo rápido
Admite null
Ejemplo: 200000
guangsu_frequencyobject No marcado obligatorio Modo luz: precios, depósito y periodo.
Subcampo Tipo / obligatorio Descripción y restricciones
65k_pricestring No marcado obligatorio Precio 65K en modo luz.
Admite null
Ejemplo: "0.8000"
131k_pricestring No marcado obligatorio Precio 131K en modo luz.
Admite null
Ejemplo: "1.5000"
deposit_periodstring No marcado obligatorio Periodo estadístico modo luz, horas
Admite null
Ejemplo: "72"
deposit_amountstring No marcado obligatorio Depósito modo luz en TRX
Admite null
Ejemplo: 1000
min_energy_countstring No marcado obligatorio Uso mínimo de energía en modo luz
Admite null
Ejemplo: 200000
Definición original
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 Precios de energía por unidades.

Precios de energía por unidades.

Campo Tipo / obligatorio Descripción y restricciones
pricestring Obligatorio Precio TRX por delegación de energía.
Ejemplo: "0.6000"
remarkstring No marcado obligatorio
Admite null
Ejemplo: "价格单位:TRX/笔"
Definición original
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 Datos de asignación de unidades.

Datos de asignación de unidades.

Campo Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección de delegación
remain_timesinteger Obligatorio Unidades restantes tras operar
statusstring Obligatorio Estado actual del servicio
Valores: "start" / "stop"
Definición original
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 Registro de consumo de unidades

Registro de consumo de unidades

Campo Tipo / obligatorio Descripción y restricciones
remain_timesinteger No marcado obligatorio Unidades restantes tras este uso
Admite null
statusstring No marcado obligatorio Estado de energía
Admite null
Valores: "init" / "waiting_delegate" / "delegate_success" / "delegate_failed" / "waiting_un_delegate" / "un_delegate_success" / "un_delegate_failed"
speed_modestring No marcado obligatorio Modo de energía
Admite null
Valores: "normal" / "low_speed"
used_tx_idstring No marcado obligatorio Hash que consumió energía
Admite null
used_energyinteger No marcado obligatorio Energía consumida
Admite null
delegate_tx_idstring No marcado obligatorio Hash de delegación de energía
Admite null
delegate_timeinteger No marcado obligatorio Marca temporal de delegación
Admite null
un_delegate_tx_idstring No marcado obligatorio Hash de recuperación de energía
Admite null
un_delegate_timeinteger No marcado obligatorio Marca temporal de recuperación
Admite null
createtimeinteger No marcado obligatorio Marca temporal de creación
Admite null
Definición original
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 Resultado de consulta de unidades.

Resultado de consulta de unidades.

Campo Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON
remain_timesinteger Obligatorio Unidades disponibles restantes
statusstring Obligatorio Estado: activo / pausado
Valores: "start" / "stop"
order_countinteger Obligatorio Total de registros de uso
page_sizeinteger Obligatorio Registros por página
pageinteger Obligatorio Página actual
ordersarray<EnergyTimesOrderItem> Obligatorio Registros de uso de la página actual
Definición original
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 Estado tras actualizar el servicio por unidades.

Estado tras actualizar el servicio por unidades.

Campo Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON
remain_timesinteger Obligatorio Unidades disponibles restantes
statusstring Obligatorio Estado: activo / pausado
Valores: "start" / "stop"
Definición original
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 Datos de delegación correcta.

Datos de delegación correcta.

Campo Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección de delegación
balancestring Obligatorio Saldo total posterior, cadena formateada
statusstring Obligatorio Estado actual del servicio
Valores: "start" / "stop"
net_protectstring No marcado obligatorio Modo de ancho de banda
Valores: "open" / "close"
Definición original
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 Registro de uso de gestión

Registro de uso de gestión

Campo Tipo / obligatorio Descripción y restricciones
energy_typestring No marcado obligatorio Tipo: 65k = 65K, 131k = 131K
Admite null
amountnumber · float No marcado obligatorio Importe gastado
Admite null
balancenumber · float No marcado obligatorio Saldo tras el uso
Admite null
currencystring No marcado obligatorio Moneda
Admite null
Valores: "trx" / "usdt"
statusstring No marcado obligatorio Estado de energía
Admite null
Valores: "init" / "waiting_delegate" / "delegate_success" / "delegate_failed" / "waiting_un_delegate" / "un_delegate_success" / "un_delegate_failed"
used_tx_idstring No marcado obligatorio Hash que consumió energía
Admite null
speed_modestring No marcado obligatorio Modo de energía
Admite null
Valores: "normal" / "low_speed"
used_energyinteger No marcado obligatorio Energía consumida
Admite null
used_timesinteger No marcado obligatorio Unidades usadas
Admite null
remain_timesinteger No marcado obligatorio Total de unidades restantes de la dirección
Admite null
delegate_countinteger No marcado obligatorio Cantidad de energía delegada
Admite null
delegate_tx_idstring No marcado obligatorio Hash de delegación de energía
Admite null
delegate_timeinteger No marcado obligatorio Marca temporal de delegación
Admite null
un_delegate_tx_idstring No marcado obligatorio Hash de recuperación de energía
Admite null
un_delegate_timeinteger No marcado obligatorio Marca temporal de recuperación
Admite null
createtimeinteger No marcado obligatorio Marca temporal de creación
Admite null
Definición original
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 Resultado de consulta de gestión.

Resultado de consulta de gestión.

Campo Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON
balancestring Obligatorio Saldo disponible restante, cadena formateada
statusstring Obligatorio Estado: activo / pausado
Valores: "start" / "stop"
order_countinteger Obligatorio Total de registros de uso
page_sizeinteger Obligatorio Registros por página
pageinteger Obligatorio Página actual
ordersarray<EnergySmartOrderItem> Obligatorio Registros de uso de la página actual
Definición original
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 Estado de la dirección tras actualizar gestión.

Estado de la dirección tras actualizar gestión.

Campo Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON
balancestring Obligatorio Saldo disponible restante, cadena formateada
statusstring Obligatorio Estado: activo / pausado
Valores: "start" / "stop"
net_protectstring No marcado obligatorio Modo de ancho de banda
Valores: "open" / "close"
Definición original
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 Estadísticas de gestión de un periodo.

Estadísticas de gestión de un periodo.

Campo Tipo / obligatorio Descripción y restricciones
65kinteger Obligatorio Operaciones de 65k
Ejemplo: 8
131kinteger Obligatorio Operaciones de 131k
Ejemplo: 15
Definición original
OpenAPI · JSON
{
  "type": "object",
  "description": "单个时间段的智能托管统计详情。",
  "properties": {
    "65k": {
      "type": "integer",
      "description": "65k 类型操作笔数",
      "example": 8
    },
    "131k": {
      "type": "integer",
      "description": "131k 类型操作笔数",
      "example": 15
    }
  },
  "required": [
    "65k",
    "131k"
  ]
}
StatisticsSmartData Estadísticas de gestión por dirección.

Estadísticas de gestión por dirección.

Campo Tipo / obligatorio Descripción y restricciones
daysobject Obligatorio Estadísticas de 5 días, claves YYYY-MM-DD.
Valor de clave dinámica: StatisticsDetail
todayStatisticsDetail Obligatorio Estadísticas de hoy
yesterdayStatisticsDetail Obligatorio Estadísticas de ayer
this_weekStatisticsDetail Obligatorio Esta semana, desde el lunes
this_monthStatisticsDetail Obligatorio Este mes, desde el día 1
Definición original
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 Estadísticas de unidades por dirección.

Estadísticas de unidades por dirección.

Campo Tipo / obligatorio Descripción y restricciones
daysobject Obligatorio Estadísticas de 5 días, claves YYYY-MM-DD.
Valor de clave: integer
todayinteger Obligatorio Unidades totales hoy
Ejemplo: 5
yesterdayinteger Obligatorio Unidades totales ayer
Ejemplo: 8
this_weekinteger Obligatorio Unidades de la semana desde el lunes
Ejemplo: 30
this_monthinteger Obligatorio Unidades del mes desde el día 1
Ejemplo: 150
Definición original
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 Definición de campos

Campo Tipo / obligatorio Descripción y restricciones
usernamestring Obligatorio Usuario de Telegram sin @.
Ejemplo: "telegram_user"
monthinteger Obligatorio Meses a comprar.
Valores: 3 / 6 / 12
Ejemplo: 3
Definición original
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 Definición de campos

Campo Tipo / obligatorio Descripción y restricciones
usernamestring Obligatorio Usuario de Telegram sin @.
Ejemplo: "channel_owner"
countinteger Obligatorio Cantidad de Stars: 50–10000.
Mínimo: 50
Máximo: 10000
Ejemplo: 100
Definición original
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 Resultado del pedido Premium.

Resultado del pedido Premium.

Campo Tipo / obligatorio Descripción y restricciones
usernamestring Obligatorio Usuario destinatario
periodstring Obligatorio Periodo de compra, p. ej. "3month"
order_idinteger Obligatorio ID interno del pedido
amountnumber · float Obligatorio Importe del pedido en TRX
pricenumber · float Obligatorio Información de precio
pay_statusstring Obligatorio Estado del pago
statusstring Obligatorio Estado de procesamiento
Definición original
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 Resultado del pedido Stars.

Resultado del pedido Stars.

Campo Tipo / obligatorio Descripción y restricciones
usernamestring Obligatorio Usuario destinatario
countinteger Obligatorio Cantidad de Stars compradas
order_idinteger Obligatorio ID interno del pedido
amountnumber · float Obligatorio Importe del pedido en TRX
pricenumber · float Obligatorio Información de precio
pay_statusstring Obligatorio Estado del pago
statusstring Obligatorio Estado de procesamiento
Definición original
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 Resultado de consulta Premium.

Resultado de consulta Premium.

Campo Tipo / obligatorio Descripción y restricciones
usernamestring No marcado obligatorio Usuario destinatario
Admite null
nicknamestring No marcado obligatorio Nombre visible del destinatario
Admite null
periodstring No marcado obligatorio Periodo de compra
Admite null
order_idinteger Obligatorio ID del pedido
amountnumber · float Obligatorio Importe del pedido en TRX
pricenumber · float Obligatorio Información de precio
pay_statusstring Obligatorio Estado del pago
statusstring Obligatorio Estado de procesamiento
remarkstring No marcado obligatorio Nota o motivo del error, truncado
Admite null
create_timestring · date-time No marcado obligatorio Fecha de creación del pedido
Admite null
Definición original
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 Resultado de consulta Stars.

Resultado de consulta Stars.

Campo Tipo / obligatorio Descripción y restricciones
usernamestring No marcado obligatorio Usuario destinatario
Admite null
nicknamestring No marcado obligatorio Nombre visible del destinatario
Admite null
countinteger No marcado obligatorio Cantidad de Stars compradas
Admite null
order_idinteger Obligatorio ID del pedido
amountnumber · float Obligatorio Importe del pedido en TRX
pricenumber · float Obligatorio Información de precio
pay_statusstring Obligatorio Estado del pago
statusstring Obligatorio Estado de procesamiento
remarkstring No marcado obligatorio Nota o motivo del error, truncado
Admite null
create_timestring · date-time No marcado obligatorio Fecha de creación del pedido
Admite null
Definición original
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 Definición de campos

Campo Tipo / obligatorio Descripción y restricciones
addressstring Obligatorio Dirección TRON receptora
Ejemplo: "TRecAddresssxxxxxxxxxxxxxxxxxxxxxxx"
countinteger Obligatorio Cantidad de energía o ancho de banda a recargar
Ejemplo: 65000
resource_typestring Obligatorio Tipo de recurso
Valores: "energy" / "net"
Ejemplo: "energy"
Definición original
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 Resultado de consulta de recarga.

Resultado de consulta de recarga.

Campo Tipo / obligatorio Descripción y restricciones
order_idinteger Obligatorio ID interno del pedido
addressstring Obligatorio Dirección de destino
energy_countinteger Obligatorio Cantidad de energía o ancho de banda solicitada
pricenumber · float No marcado obligatorio Precio unitario en SUN
Admite null
feenumber · float No marcado obligatorio Comisión en TRX
Admite null
resource_typestring Obligatorio Tipo de recurso
Valores: "energy" / "net"
amountnumber · float No marcado obligatorio Total en TRX
Admite null
statusstring Obligatorio Estado del pedido
Valores: "waiting" / "success" / "failed"
delegate_txidstring No marcado obligatorio Hash de delegación
Admite null
reclaim_txidstring No marcado obligatorio Hash de recuperación
Admite null
actual_recover_countinteger No marcado obligatorio Cantidad real recargada
Admite null
Definición original
OpenAPI · JSON · api.invalid es un dominio de relleno para la documentación y no se puede llamar. El host real se consulta con @wanglei.
{
  "type": "object",
  "description": "速充订单查询结果数据。",
  "properties": {
    "order_id": {
      "type": "integer",
      "description": "内部订单 ID"
    },
    "address": {
      "type": "string",
      "description": "目标地址"
    },
    "energy_count": {
      "type": "integer",
      "description": "请求的能量/带宽数量"
    },
    "price": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "单价 (SUN)"
    },
    "fee": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "手续费 (TRX)"
    },
    "resource_type": {
      "type": "string",
      "description": "资源类型",
      "enum": [
        "energy",
        "net"
      ]
    },
    "amount": {
      "type": "number",
      "format": "float",
      "nullable": true,
      "description": "总金额 (TRX)"
    },
    "status": {
      "type": "string",
      "description": "订单状态",
      "enum": [
        "waiting",
        "success",
        "failed"
      ]
    },
    "delegate_txid": {
      "type": "string",
      "nullable": true,
      "description": "委托交易哈希"
    },
    "reclaim_txid": {
      "type": "string",
      "nullable": true,
      "description": "回收交易哈希"
    },
    "actual_recover_count": {
      "type": "integer",
      "nullable": true,
      "description": "实际补充数量"
    }
  },
  "required": [
    "order_id",
    "address",
    "energy_count",
    "resource_type",
    "status"
  ]
}

API 2.1.0 · Verificado 2026-09-30

Fuente de la definición API: Documentación API V2 . El sitio ofrece una guía y conserva la definición completa. Revísala si cambia el servicio original.

Descargar OpenAPI completo