> ## Documentation Index
> Fetch the complete documentation index at: https://custodydocs-zh.chainup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 购买TRON网络交易资源

> 通过API购买TRON交易资源，无需燃烧TRX即可完成交易。

> [!TIP]
>
> 在购买之前，请参考[购买TRON网络交易资源](/api-references/mpc-apis/apis/tron/resource-shopping-guide.md)完成所有配置。

#### 请求参数数据结构

**request\_id** `string` *required*

转账唯一标识.不可重复提交,限 32 字符,仅支持字母、数字、下划线（`_`）和短横线（`-`）.

**buy\_type** `integer`

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

> [!NOTE]
>
> **所有方式均遵守最小购买值限制：**
>
> * 带宽的最小购买数量为 300
> * 能量的最小购买数量为 32,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。

> [!NOTE]
>
> 若选择购买带宽(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`

能量数量,

> [!NOTE]
>
> 1. 若 buy\_type=1，请输入具体的能量数量，最小值为 32,000。
>
> 2. 若 buy\_type=0，该数量为系统预估的完成单笔交易所需的全部资源数，加上一定的浮动值，以确保交易顺利完成。
>
> 3. 若 buy\_type=2，该数量为系统结合地址可用资源数，预估的完成单笔交易所需的补充数量，加上一定的浮动值，以确保交易顺利完成。

**net\_num** `integer`

带宽数量,

> [!NOTE]
>
> 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*

接收资源的地址。

> [!NOTE]
>
> 当buy\_type=0或2时,请确保 address\_from 持有contract\_address对应代币，否则矿工费预估失败

**address\_to** `string`

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

> [!NOTE]
>
> 选择buy\_type=0或2时需要填写。

**contract\_address** `string`

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

> [!NOTE]
>
> 选择buy\_type=0或2时需要填写。

#### 响应参数数据结构

**object**

**trans\_id** `integer`

购买资源交易ID

```curl cURL theme={null}
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'
```

```json theme={null}
{
    "trans_id": 198012
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.