玩家余额查询

查询玩家在指定币种的钱包余额。

接口信息

属性	值
路径	POST /papi/v1/player/balance
认证	Agent Token（Bearer）
Content-Type	application/x-www-form-urlencoded

请求参数

参数名	类型	必填	说明
member_id	string	是	玩家唯一标识（Agent 侧 ID），会被强制转为大写
currency	string	是	货币代码（如 MYR、USD），必须为平台支持的货币，会被强制转为大写

请求示例

curl -X POST https://api.example.com/papi/v1/player/balance \
  -H "Authorization: Bearer {agent_token}" \
  -d "member_id=PLAYER_001&currency=MYR"

响应字段

字段	类型	说明
member_id	string	玩家标识（大写）
currency	string	货币代码
balance	decimal	余额（精确到 4 位小数）

响应示例

{
  "status": true,
  "code": 0,
  "data": {
    "member_id": "PLAYER_001",
    "currency": "MYR",
    "balance": 0.0000
  },
  "msg": "success"
}

错误码

code	message	说明
1001	err.param.invalid	member_id 或 currency 缺失
1002	err.signature.invalid	Agent Token 验证失败
2001	err.player.not_found	玩家不存在（需先调用注册接口）
3005	err.fund.currency_not_supported	不支持的货币代码