POST
/
api
/
mpc
/
tron
/
delegate
curl -X POST \
--url 'https://openapi.chainup.com/api/mpc/tron/delegate?app_id=16a9f17fc2ad61ca4339fdd6a8a37f21&data=SWYYr-LBVAmaS0eq8n-CUT_nHkM3OBxyWOsImMTe41UaqAoYI2ZghmaphXHov-7hsRsVmOhyPqC-JFuRGvonJKFd2Jirxv6Vn_8V40r_MMYTkhqcviQbZWYW5xX8Ai8CIpqas9fIWVDIYA_NKBl0UCJpwGxscxLNpjq5Z8-BTyIYDsVBquM9zEQGBCfcA7szD9n2fN_loSkoexlwqV8wg9HIZO5yQ6utZ_Kt0lNDQQb8zn8BwfAvsEsbJlOINUAqhxh1vV_AJ4bXn2uYx8TaYcBht-n_ZcBdxIDt975dbOFUiH-oCzIuDi1oLDtb4EylfCvhU5E4ozel_lQ-6cyIG0Dqiiyx0RFFOCJzPSXIoV031pvoa8pTCpkWklh8mRw1rylBgeZtqSxpnJO2_u2RIlXq6Hs8Yly9CmhIXaSrUgPir0h6xVxlf4VC6PFVCkiiTlp0kZ_H_UbKm0nUis3v3U2sflWJ2C449waSrikhuxVrFAQ6PQmrFVCAE6MYXNrFXJQuam2HAIQNSGbFQjspw8b_bXyfyZMGZ3K2oBC4I_v3eETTdPe0pfSNJb-5g37K0tOAr_UFbWK8pkC8yl56fSjn8tcR3yCRWwoi8jxTcUBiswTtvXZtzgG4dyzkaHXjsZjSGiywXSqP76VZWlyOmAx6IDSViLcPLPISdU3ruCI'
{
    "trans_id": 198012
}

在购买之前,请参考购买TRON网络交易资源完成所有配置。

请求参数数据结构

request_id
string
required

业务唯一标识。

buy_type
integer

购买资源方式 0:系统预估-完整代理 ,1:指定数量 ,2:系统预估-补充代理,不指定默认为0。

所有方式均遵守最小购买值限制:

  • 带宽的最小购买数量为 300
  • 能量的最小购买数量为 10,000

1. 系统预估-完整代理 (buy_type=0)

  • 需填写 address_to 和 contract_address。
  • 系统将自动预估当前交易所需的全部资源数量加上一定浮动值。若用户请求为一笔 USDT 转账代理能量,系统预估所需能量为 64,285,则购买数量为 64,285 + 115=64,400,以保证交易顺利完成。
  • 注意事项:系统预估值可能受到波场网络波动影响,若因预估不足导致交易失败,请切换购买方式为 指定数量 (buy_type=1)。

2. 系统预估-补充代理 (buy_type=2)

  • 需填写 address_to 和 contract_address。
  • 该方式只对能量的购买数量产生影响(带宽的购买 buy_type=2 和 buy_type=0 的预估方式一致)。
  • 系统将结合当前地址的能量余额,自动预估交易所需补充的剩余能量数量,并加上一定浮动值以保证交易成功。若用户请求为一笔 USDT 转账代理能量,系统预估所需能量为 64,285,当前地址已有 10,000 能量,则购买数量为 64,285 - 10,000 + 115=54,400,以保证交易顺利完成。
  • 注意事项:系统预估值可能受到波场网络波动影响,若因预估不足导致交易失败,请切换购买方式为 指定数量 (buy_type=1)。

3. 指定数量 (buy_type=1)

  • 用户可自定义购买的资源数量。
resource_type
integer

购买资源类型 0:能量与带宽 1:能量 不指定默认为1。

若选择购买带宽(resource_type=0),请注意以下事项:

1.最小购买数量为 300。

2.每笔带宽购买订单将固定产生 560 的附加费用,用于支付系统发起代理和回收所需的带宽成本。例如,若请求购买 600 的带宽量,则该笔购买订单的带宽数量为 600 + 560 = 1160。

service_charge_type
string
required

购买资源周期 10010:10分钟 ,20001 :1小时, 30001 :1天

energy_num
integer

能量数量,

  1. 若 buy_type=1,请输入具体的能量数量,最小值为 10,000。

  2. 若 buy_type=0,该数量为系统预估的完成单笔交易所需的全部资源数,加上一定的浮动值,以确保交易顺利完成。

  3. 若 buy_type=2,该数量为系统结合地址可用资源数,预估的完成单笔交易所需的补充数量,加上一定的浮动值,以确保交易顺利完成。

net_num
integer

带宽数量,

1.若 buy_type=1,请输入具体的带宽数量,最小值为 300。

2.请注意每笔带宽购买订单将固定产生 560 的附加费用,用于支付系统发起代理和回收所需的带宽成本。例如,若输入购买 600 的带宽量,则该笔购买订单的带宽数量为 600 + 560 = 1,160。

3.若 buy_type=0或2,该数量为系统预估的完成单笔交易所需的全部资源数,加上 560 的附加费用。例如,若系统预估交易需要 350 带宽,则购买数量为 350 + 560 = 910。

address_from
string
required

接收资源的地址。

address_to
string

转账到账地址,用于预估矿工费。

选择buy_type=0或2时需要填写。

contract_address
string

合约地址,用于预估矿工费。

选择buy_type=0或2时需要填写。

响应参数数据结构

curl -X POST \
--url 'https://openapi.chainup.com/api/mpc/tron/delegate?app_id=16a9f17fc2ad61ca4339fdd6a8a37f21&data=SWYYr-LBVAmaS0eq8n-CUT_nHkM3OBxyWOsImMTe41UaqAoYI2ZghmaphXHov-7hsRsVmOhyPqC-JFuRGvonJKFd2Jirxv6Vn_8V40r_MMYTkhqcviQbZWYW5xX8Ai8CIpqas9fIWVDIYA_NKBl0UCJpwGxscxLNpjq5Z8-BTyIYDsVBquM9zEQGBCfcA7szD9n2fN_loSkoexlwqV8wg9HIZO5yQ6utZ_Kt0lNDQQb8zn8BwfAvsEsbJlOINUAqhxh1vV_AJ4bXn2uYx8TaYcBht-n_ZcBdxIDt975dbOFUiH-oCzIuDi1oLDtb4EylfCvhU5E4ozel_lQ-6cyIG0Dqiiyx0RFFOCJzPSXIoV031pvoa8pTCpkWklh8mRw1rylBgeZtqSxpnJO2_u2RIlXq6Hs8Yly9CmhIXaSrUgPir0h6xVxlf4VC6PFVCkiiTlp0kZ_H_UbKm0nUis3v3U2sflWJ2C449waSrikhuxVrFAQ6PQmrFVCAE6MYXNrFXJQuam2HAIQNSGbFQjspw8b_bXyfyZMGZ3K2oBC4I_v3eETTdPe0pfSNJb-5g37K0tOAr_UFbWK8pkC8yl56fSjn8tcR3yCRWwoi8jxTcUBiswTtvXZtzgG4dyzkaHXjsZjSGiywXSqP76VZWlyOmAx6IDSViLcPLPISdU3ruCI'
{
    "trans_id": 198012
}