tet.energy API 文档：TRON 能量 REST API

请以当前合约为准，而不是未来路线图。所有产品端点均使用 /v1 基础路径；公开市场数据无需凭证，买方和卖方操作则使用已登录的浏览器会话或具有相应权限范围的 API 密钥。

选择下一步

基础路径与响应模型

在 tet.energy 域名上使用 HTTPS，并在产品路由前添加 /v1。成功响应就是 JSON 数据本身，没有 success 外层包装。需要分页的列表路由返回包含 items、next_cursor 和 has_more 的页面。resource 等查询参数使用当前 energy 或 bandwidth 枚举值。

浏览器会话与 API 密钥是不同的凭证

浏览器签署 /v1/auth/nonce 返回的原始消息，并提交到 /v1/auth/verify；响应会建立会话，并提供会话型变更请求所需的 CSRF 值。自动化程序通过 Authorization: Bearer <api-key> 发送带权限范围的 API 密钥；read、buy 和 sell 限制可调用的功能，API 密钥变更请求不使用浏览器 CSRF。只能在已登录的浏览器会话中创建、查看和撤销密钥。切勿把密钥放入查询字符串、源代码或日志。

安全重试资金路径操作，避免重复执行

POST /v1/orders、/v1/orders/batch、/v1/multisig/sessions 与 /v1/seller/reinvestment/sessions 必须提供最长 128 个字符的非空 Idempotency-Key；续租也接受该键。每个预期操作生成一个键，仅在请求完全相同时复用。重放返回已有资源，同一键配合不同请求体会产生 conflict。

统一错误结构

所有 HTTP 失败都位于 error 对象中，并包含粗粒度 code 与安全的 message。可将 request_id 提供给支持人员，以便与服务端记录关联。details 仅在 422 验证失败时出现，只标明字段而不会回显提交值。成功响应不使用此结构。

{
  "error": {
    "code": "invalid_request",
    "message": "...",
    "request_id": "...",
    "details": [{ "field": "body.amount", "reason": "..." }]
  }
}

当前 HTTP 接口范围

公开市场数据

这些读取无需凭证，提供当前价格、深度、可成交公开订单、已结算成交、K 线、市场统计和公开卖方目录。

GET /v1/price
GET /v1/market/depth
GET /v1/market/orders
GET /v1/market/trades
GET /v1/market/ohlcv
GET /v1/market/stats
GET /v1/sellers
GET /v1/sellers/{address}

私有买方路由

读取订单、活跃租用与余额需要 read，变更操作需要 buy。单个与原子批量订单支持 extension_required，用于只匹配允许续租的卖方；smart_matching 只在同一价格层级内优先选择曾成功服务的卖方。续租创建一个同租期的幂等请求。多签会话负责准备交易并验证用户签名及其权重；服务器绝不签名或广播。

GET /v1/orders
POST /v1/orders
POST /v1/orders/batch
GET /v1/orders/{order_id}
PATCH /v1/orders/{order_id}
DELETE /v1/orders/{order_id}
GET /v1/rentals
GET /v1/rentals/incoming
POST /v1/rentals/{rental_id}/extend
POST /v1/multisig/sessions
POST /v1/multisig/sessions/{session_id}/signatures
GET /v1/multisig/sessions/{session_id}
GET /v1/balance

私有卖方路由

资金池状态、委托与收益仅向已认证卖方开放。smart_reuse 只在同一价格内影响复用优先级，auto_extend 控制买方请求的同租期续租；当当前支付策略使负债可支付时，earnings 返回 next_payout_at。再投资会从一笔已完成支付准备未签名 FreezeBalanceV2；卖方在 TronLink 中签名并广播，服务器绝不执行这两步。

GET /v1/seller/pool
PATCH /v1/seller/pool
POST /v1/seller/pool/sync
GET /v1/seller/delegations
GET /v1/seller/earnings
POST /v1/seller/reinvestment/sessions
POST /v1/seller/reinvestment/sessions/{session_id}/confirmation
GET /v1/seller/reinvestment/sessions/{session_id}

当前 API 不包含的功能

当前客户合约不提供 webhook、提现路由或客户管理 API。推荐奖励支付由运营 worker 执行，而不是客户端点。充值地址没有独立路由：经过认证的 GET /v1/balance 会在充值服务已配置并就绪时返回可为空的 deposit_address。健康检查与运营管理员路由不属于此客户接口范围。

tet.energy API 文档