开发者文档

API 工作区
https://api.rentron.xyz/v1
OpenAPI 架构

余额

// GET

生产 API

账户余额

创建订单前读取可用和已预留的 TRX。

GET /v1/balance
本页内容

返回与 API 凭证关联的 Energy 账户生产环境余额。

请求

没有请求体和查询参数。签名内容为 GET、路径 /v1/balance、空查询和空请求体哈希。

curl https://api.rentron.xyz/v1/balance \
  -H 'Authorization: HMAC-SHA256 {api_key}:{base64_signature}' \
  -H 'X-Request-Timestamp: {unix_seconds}'

响应 200

{"available_trx":"120.500000","held_trx":"18.250000","status":"active"}
字段 类型 说明
available_trx string 可用于新订单的 TRX,始终保留六位小数。
held_trx string 被进行中订单预留的 TRX。
status string 当前账户状态。创建订单要求为 active

不要用二进制浮点数解析金额。请使用平台提供的十进制或大数类型。

错误

该接口可能返回 401429503。收到 429 时遵守 Retry-After;对 503 使用退避重试。