核心概念
本文档为接入 API 的开发者提供核心术语表。如需查询实时数值，请直接调用 API —— 文档中的任何说明均不代表固定报价或排期。
能量与带宽 (Energy & Bandwidth)
TRON 账户在每次链上交互时会消耗两类网络资源：能量（智能合约调用消耗，包括 USDT 等 TRC-20 代币转账）和 带宽（由交易报文大小决定）。如果账户中这两类资源不足，发起方就必须直接燃烧 TRX。我们支持按需租用资源固定时长，并秒级在链上委托至您指定的接收地址 —— 资金始终停留在您的钱包中，且绝对不需要提供私钥或助记词。
时长档位 (Tiers)
档位 (Tier) 指租用能量的时长窗口，通常以时长命名：5m、15m、1h、1d、3d、30d。并非所有档位都随时处于可售状态 —— 建议通过 GET /v1/prices 实时获取当前开放销售的档位列表，切勿硬编码。
日间时段 (Day parts)
能量单价随一天中的用量高峰波动：平台定义了多个 日间时段（例如低谷时段、早间上行、高峰时段等），每个时段拥有独立的单位单价。时段边界由服务端以 UTC 时间统一定义；网页端会自动将其转换为您的本地时区展示。请务必通过 GET /v1/prices 读取当前生效的时段与单价。
订单状态机 (Order states)
每个订单都严格遵循单一的状态机流转：created → paid → allocating → delegated → confirmed → active → expired | reclaimed。若遇到异常，则流转至终止分支 failed 或 refunded。部分交付并不是一个独立的状态 —— 它由布尔标识 (partial: true) 和小于订购量的实际交付量 delivered_amount 构成，订单在业务逻辑上仍然处于正常的 confirmed 或 active 状态。
报价单有效期 (Quote TTL)
报价单可在短时间内（120 秒）锁定特定订单的总价格。在过期前传入 quote_id 下单，将严格按照锁定金额扣费；报价单过期后，请重新请求获取新报价。
基于 client_order_id 的幂等性
创建订单时，建议始终传入由您系统生成的业务单号 client_order_id。如果网络超时后使用相同的单号重新发起请求，系统将直接返回已创建的原始订单，而绝不会重复创建新订单或重复扣费 —— 这是防止网络抖动导致重复购买的安全保障。
附带 Memo 的直接链上转账
平台支持通过直接向公布的公用充值地址转账 TRX 完成免账号购买，此时需要在转账中附带用于识别您的账户的 Memo 备注信息。请严格按照指示填写 Memo，否则系统无法自动入账并完成委托。