Activator — 地址激活

激活从未在链上使用过的 TRON 地址。全新地址在链上没有账户记录，因此在激活之前无法接收代理的 Energy 或 Bandwidth。此端点将为您创建账户并返回激活交易的哈希值。

每个地址的激活操作是一次性的。如果该地址已经处于激活状态，该端点会做出相应提示并且不收取任何费用。

端点基础 URL

https://netts.io/apiv2/activator

旧路径 https://netts.io/apiv2/activation 由同一服务提供支持，行为完全相同。新集成应使用 /apiv2/activator。

请求头

请求头	必填	描述
Content-Type	是	application/json
X-API-KEY	是	来自 Netts 控制面板的 API 密钥
X-Real-IP	是	来自白名单的 IP 地址

您的 user_id 是通过 API 密钥派生的 —— 无需自行传递。

---

激活 — POST /apiv2/activator

请求体

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

字段	类型	必填	描述
targetAddress	string	是	要激活的 TRON 地址。必须匹配 ^T[A-Za-z0-9]{33}$（34 个字符，以 T 开头）。

响应 — 激活成功（200，状态码 10000）

{
    "detail": {
        "code": 10000,
        "msg": "Address activated successfully, 1.1 TRX deducted",
        "data": {
            "orderId": "A123456",
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "activation_cost": 1.1,
            "user_balance_before": 500.00,
            "user_balance_after": 498.90,
            "hash": "0000000000000000000000000000000000000000000000000000000000000000"
        }
    }
}

字段	类型	描述
orderId	string	激活订单号，格式始终为 A + 数字。可用于对账。
targetAddress	string	已激活的地址
activation_cost	float	从您的余额中扣除的金额，单位为 TRX
user_balance_before	float	扣费前的余额
user_balance_after	float	扣费后的余额
hash	string	激活交易的哈希值。可在任何 TRON 区块链浏览器上验证。

响应 — 已处于激活状态（200，状态码 2001）

当该地址已存在于链上时返回。不收取任何费用。

{
    "detail": {
        "code": 2001,
        "msg": "Address is already activated",
        "data": {
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "status": "already_activated",
            "user_balance": 500.00,
            "activation_cost": 0,
            "activation_required": false
        }
    }
}

在假定已发生扣费之前请检查 code：10000 表示已扣费，2001 表示未扣费。

示例

curl -X POST https://netts.io/apiv2/activator \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{"targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}'

---

价格

项目	金额
激活	1.1 TRX
地址已激活	0

该金额是固定的，不取决于地址本身或网络状况。仅在激活成功时从您的 Netts 余额中扣除 —— 绝不会提前扣除。激活失败不收取任何费用。

您的余额必须足以支付该费用，否则请求将被拒绝并返回 403（1004），且不会创建任何订单。

---

适用场景

• 在为新地址租赁 Energy 或 Bandwidth 之前。 向不存在的账户进行代理会失败。请先激活，然后再下单。
• 在首次向您自己生成的地址转账之前。

对于曾经接收过 TRX 或代币的地址，您无需调用此端点 —— 该地址已经处于激活状态，调用只会返回 2001。

为新地址订购 Energy

作为订单的一部分，1 小时 Energy 端点会自动激活未激活的接收地址，激活费用会计入该订单中。当您希望在进行任何租赁之前激活地址时，请显式调用激活器 —— 例如先补充 Bandwidth，这确实需要账户处于激活状态。

---

耗时说明

激活是一笔真实的链上交易。端点在交易广播并写入激活记录后返回，通常在几秒钟之内。

只有当交易被打包进区块后，地址才真正可用 —— 响应返回后最多约需 3 秒，这是 TRON 的出块间隔。如果您的下一步操作依赖于该地址处于激活状态（例如订购 Bandwidth），请通过返回的 hash 在链上确认其状态，而不是立即调用。

---

错误代码参考

代码	描述	HTTP 状态码
10000	地址已激活，余额已扣除	200
2001	地址已激活，未收取任何费用	200
-1	无效的 API 密钥 / IP 不在白名单中	401
1004	余额不足 — 提示信息会说明所需金额和当前余额	403
-	targetAddress 格式无效（必须为 34 个字符，以 T 开头）	422
5003	激活失败或服务暂时不可用 — 请稍后重试	503
5000	服务器内部错误	500

503 表示未发生扣费且未激活任何地址：可以安全地重试该请求。

速率限制

按源 IP 进行限制：

周期	限制
1 秒	5 次请求
1 分钟	60 次请求

超出速率限制 (429)

{ "message": "API rate limit exceeded" }

注意事项

• 幂等性由您自行保证。 该端点没有幂等键。对已经激活的地址重复请求是安全且免费的（2001），但针对同一全新地址并发发起两个请求可能会同时执行。请在您这一侧对每个地址的激活操作进行串行化处理。
• orderId 的格式为 A + 数字，在所有激活操作中是唯一的。
• 目前激活操作不会发送 Webhook — 响应和 hash 即为确认凭据。Webhooks 目前仅涵盖已确认的 Energy 代理，请参阅 Webhooks。