注册入驻 — API 参考

在尚未拥有任何凭据时创建账户：地址挑战、签名校验、创建账户，以及在生成首个 API 密钥前获取专属充值地址。

基于 openapi.yaml 在构建时生成。基准 URL 为 https://api.tenergy.me/v1，Nile 测试网环境为 https://api-nile.tenergy.me/v1（详见环境说明）。下述每个请求均遵循身份鉴权规范进行签名，除非鉴权行另有说明。

为 TRON 地址签发签名挑战码

POST /v1/accounts/challenge · createAccountChallenge

鉴权： 公开 —— 无需凭据。

这是基于地址挑战签名的注册与找回模型（平台唯一的注册认证模型）的步骤 1：通过脱机在用户本地使用 TRON 地址对一段随机数（nonce）进行签名来证明账户所有权。我方服务器永不接触私钥，且完全免疫网络钓鱼 —— 签名仅用于证明对该链上地址的控制权。

返回的 message 具有良好的人类可读性并绑定了域名上下文（包含品牌标识、操作意图、随机数 nonce 及过期时间），以便用户在钱包中确认签名时清楚知晓授权内容。请在钱包中以标准的 TIP-191 格式（个人签名规范）进行签名；签名必须能推导还原出原 address。

匿名调用，按 IP 及目标地址进行限流。对已有账户的地址调用和对全新地址调用在行为上完全无差别 —— 此端点刻意不暴露任何“账户是否存在”的侧信道探测信息。

请求体

JSON (AccountChallengeRequest)，必填。

来自规范的请求体示例（示意数值）：

{"address":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE","purpose":"signup"}

响应

响应字段 (AccountChallenge)

来自规范的 201 响应示例（示意数值）：

{
  "nonce": "9f2a7c1e4b6d8a0f3e5c7b9d1f3a5c7e",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "purpose": "signup",
  "message": "tenergy.me wants you to prove control of this address.\nPurpose: signup\nAddress: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE\nNonce: 9f2a7c1e4b6d8a0f3e5c7b9d1f3a5c7e\nExpires: 2026-09-11T18:14:05.123Z\nSigning this creates no transaction and moves no funds.\n",
  "issued_at": "2026-09-11T18:04:05.123Z",
  "expires_at": "2026-09-11T18:14:05.123Z"
}

校验已签名的挑战码并获取引导令牌

POST /v1/accounts/challenge/verify · verifyAccountChallenge

鉴权： 公开 —— 无需凭据。

步骤 2。验证 signature 是否由对应 address 针对 message 签名生成，并下发一个短时有效的引导令牌 (Bootstrap token) —— 作为从“无账户”跨越到“拥有首个 API 密钥”期间的过渡授权凭据。

引导令牌在请求头中以 Authorization: Bearer abt_… 传递，严格限定仅能执行四个操作：POST /v1/accounts、GET /v1/accounts/deposit-address、GET /v1/account 和 POST /v1/api-keys。有效期 15 分钟，单账户绑定，绝不可替代长期使用的 API 密钥。

若该地址已在该品牌下创建过账户，则仅向该调用方返回 account_id 与 account_status。

随机数 nonce 为单次使用。被重用、过期或签名错误的 nonce 均统一返回错误码 1010 challenge_invalid，防止泄露地址存在性信息。

请求体

JSON (AccountChallengeVerifyRequest)，必填。

来自规范的请求体示例（示意数值）：

{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "nonce": "9f2a7c1e4b6d8a0f3e5c7b9d1f3a5c7e",
  "signature": "1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b"
}

响应

响应字段 (BootstrapToken)

来自规范的 200 响应示例（示意数值）：

{
  "bootstrap_token": "abt_3f8c2d1e9b7a4c6e8f0a2b4d6e8f0a2b",
  "expires_at": "2026-09-11T18:19:05.123Z",
  "account_id": "acc_01J9Z4K2M7Q8",
  "account_status": "active"
}

创建新账户

POST /v1/accounts · createAccount

鉴权： 引导令牌 (Bootstrap token) 或公开请求。

步骤 3。创建归属于签名地址的账户，并返回账户基础信息及专属充值地址。新创建的账户初始状态为 status: "unfunded"：账户已创建，支持信息查询，可以接收充值并能签发 API 密钥；在充值到账确认前无法下单消耗资金。

认证方式二选一：可使用 POST /v1/accounts/challenge/verify 返回的引导令牌认证，亦可在请求体中同时附带 nonce 与 signature 一键完成创建。两者证明能力等同。

按地址幂等。 若该地址在该品牌平台已拥有账户，则直接返回已有账户信息与 HTTP 200 状态码，不会重复创建。

email 为选填项且在此处不进行校验 —— 仅作为后续恢复与账单接收渠道，可在控制台中绑定。邮箱魔法链接和 Telegram 登录是人类用户登录同一账户的补充凭据，而非另一套独立的注册体系。

API 密钥无需等待充值到账即可创建（自 2026-09-26 起）。资金消耗由余额控制而非阻断凭据：在账本未入账确认前，POST /v1/orders 将返回 4001 insufficient_funds。

请求体

JSON (AccountCreateRequest)，必填。

来自规范的请求体示例（示意数值）：

{"address":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}

响应

响应字段 (AccountCreated)

在首个 API 密钥创建前读取充值地址

GET /v1/accounts/deposit-address · getSignupDepositAddress

鉴权： 引导令牌 (Bootstrap token)。

充值目标地址，向其充值后账户将激活变为 active 状态并可发行密钥。支持使用引导令牌直接读取，从而允许新注册账户的 Agent 汇报充值地址及最低充值额度给用户，而无需提前持有长期敏感凭据。

创建 API 密钥后，建议调用返回相同地址信息的 GET /v1/deposit-addresses。

请求参数

响应

响应字段

来自规范的 200 响应示例（示意数值）：

{
  "account_id": "acc_01J9Z4K2M7Q8",
  "status": "unfunded",
  "data": [
    {
      "currency": "TRX",
      "address": "TDepositAddressExample1111111111111",
      "memo": null,
      "confirmations_required": 19
    }
  ],
  "min_deposit_sun": 1000000
}