Avistadocs

查询账户余额

GET /api/balance

GET https://api.avista.global/api/balance

需要在 Authorization 头中提供 Bearer token。请参阅 生成令牌 获取。

返回已认证账户的总余额、冻结余额和净余额。

认证

需要在 Authorization 头中提供 Bearer 令牌。


代码示例

cURL
curl -X GET "https://api.avista.global/api/balance" \
  -H "Authorization: Bearer $AVISTA_TOKEN"
const axios = require('axios');

const response = await axios.get('https://api.avista.global/api/balance', {
  headers: { 'Authorization': `Bearer ${process.env.AVISTA_TOKEN}` },
});
console.log(response.data);
import os, requests

response = requests.get(
    'https://api.avista.global/api/balance',
    headers={'Authorization': f'Bearer {os.environ["AVISTA_TOKEN"]}'},
)
print(response.json())
$ch = curl_init('https://api.avista.global/api/balance');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AVISTA_TOKEN'),
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.avista.global/api/balance"))
    .header("Authorization", "Bearer " + System.getenv("AVISTA_TOKEN"))
    .GET()
    .build();
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

响应 (200)

字段类型描述
grossBalancenumber总余额(可用金额 + 冻结金额)
blockedBalancenumber冻结余额(为待处理操作预留)
netBalancenumber净余额(可用金额)
consultedAtstring查询日期和时间(ISO 8601)
{
  "grossBalance": 48734.90,
  "blockedBalance": 0,
  "netBalance": 48734.90,
  "consultedAt": "2025-11-19T20:18:29.384Z"
}

错误

状态码描述
401令牌无效、已过期或缺失

本页目录