查询当前 API Key 所属用户余额

接口信息

• 接口路径：GET /v1/me/balance
• 认证方式：API Key
• 请求格式：无请求体
• 响应格式：application/json
• 用途：查询当前 API Key 所属用户的钱包余额。

认证

请求头必须携带 Authorization：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

说明：

• 支持 Bearer <API_KEY> 格式。
• 该接口是只读认证接口。
• 已耗尽额度或已过期的令牌仍可查询余额。
• 已禁用的令牌不可查询。
• 所属用户被封禁时不可查询。
• 该接口最小调用间隔为5分钟

请求参数

Header

Query 参数

无。

Body 参数

无。

成功响应

HTTP 状态码

200 OK

响应字段

响应示例

{
  "success": true,
  "message": "",
  "data": {
    "balance": 3.6,
    "currency": "CNY"
  }
}

错误响应

未提供 API Key

HTTP 状态码：401 Unauthorized

{
  "success": false,
  "message": "token is not provided"
}

API Key 无效

HTTP 状态码：401 Unauthorized

{
  "success": false,
  "message": "invalid token"
}

API Key 已禁用

HTTP 状态码：401 Unauthorized

{
  "success": false,
  "message": "token status is unavailable"
}

用户被封禁

HTTP 状态码：403 Forbidden

{
  "success": false,
  "message": "user is banned"
}