GET /apiv2/billing/rate
您当前的汇率：按您合同的币种计算的一枚 TRX 的价值。每个账户都有自己的合同币种，因此交易对和汇率都是专属于您的。可用于核对您自己记录中的金额。属于后付费计费的一部分。
接口 URL
GET https://netts.io/apiv2/billing/rate请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
X-API-KEY | 是 | 拥有 billing.read 权限的 API 密钥 |
X-Real-IP | 是 | 来自密钥白名单中的地址 |
该请求无参数。币种取自您的合同。
示例
bash
curl -s 'https://netts.io/apiv2/billing/rate' \
-H 'X-API-KEY: your-api-key' \
-H 'X-Real-IP: 203.0.113.10'json
{
"success": true,
"data": {
"asset": "<currency of your contract>",
"pair": "TRX/<currency of your contract>",
"rate": "0.331515333133553092",
"at": "2026-10-20T05:52:15.915512+00:00"
},
"timestamp": "2026-10-20T05:52:20+00:00"
}响应字段
| 字段 | 说明 |
|---|---|
asset | 您合同的币种，与账户中的 settlement.asset 相同 |
pair | TRX/ 以及您合同的币种 |
rate | 按您合同币种计算的一枚 TRX 的价值，带有 18 位小数的十进制字符串 |
at | 汇率的时间点，UTC；当您合同的币种为 TRX 时为 null |
如果您合同的币种为 TRX，rate 为 "1"。
汇率会随时间变化。它只是 at 时刻的汇率，并非对未来订单汇率的承诺：已记录的费用将保留其发生时的汇率 — 参见记录的汇率。
错误响应
| HTTP | code | 含义 |
|---|---|---|
| 401 | -1, -2 | 密钥缺失或无效，或者 IP 不在白名单中 — 由 API 网关返回，参见响应格式 |
| 403 | billing_read_required | 密钥没有 billing.read 权限 |
| 403 | postpaid_required | 该账户未开通后付费计费 |
| 503 | rate_unavailable | 汇率暂时不可用 — 请稍后重试 |
所有代码均列在后付费计费中。