v1.0.0 (2026-09-03 16:35)
获取余额与资产 (Get Balance)
获取当前会员各个币种的主钱包余额数据,同时已经将对应的体验金以及待领取红包的总额全部合并在同一个对象中返回。
接口说明
- 路径:
/client/member/getBalance - 方法:
GET - 说明: 调用此接口需要在 Headers 中提供
Authorization: Bearer <token>进行鉴权。
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
currency | string | 否 | 如果提供此参数(如 VND),则只返回该币种的钱包数据。如果不传,则返回所有币种的钱包。 |
(系统将根据 Token 自动识别当前登录的会员信息)
响应示例
json
{
"code": 0,
"data": [
{
"currency": "USD",
"balance": 1500.5,
"activity_balance": 50.0,
"unclaimed_angpao_total": 10.0,
"vip_level": 2,
"lifetime_deposit": 5000,
"current_month_deposit": 2000
},
{
"currency": "VND",
"balance": 2300000,
"activity_balance": 0,
"unclaimed_angpao_total": 0,
"vip_level": 2,
"lifetime_deposit": 10000000,
"current_month_deposit": 5000000
}
],
"msg": "Success"
}响应参数说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码,0 表示成功 |
| data | array | 钱包数据列表 |
| data[].currency | string | 币种代码 |
| data[].balance | number | 主钱包余额 |
| data[].activity_balance | number | 生效中的活动体验金余额 |
| data[].unclaimed_angpao_total | number | 待领取的红包总额 |
| data[].vip_level | number | VIP 等级 |
| data[].lifetime_deposit | number | 历史累计充值 |
| data[].current_month_deposit | number | 当月累计充值 |
| msg | string | 响应消息提示 |