Query Personal Account Balance

Endpoint Path

GET /api/open/user/self

Balance Calculation

Final balance (CNY):

Final Balance (¥) = quota ÷ quota_per_unit × usd_exchange_rate

Where:

• quota: from data.quota returned by this endpoint
• quota_per_unit, usd_exchange_rate, quota_display_type: from System Status (GET /api/open/status)

If quota_display_type = USD, omit × usd_exchange_rate.

Request Parameters

No parameters required.

Request Example

GET 'https://neolink.com/backend/api/open/user/self'

Return Information

Field	Type	Required	Description	Remarks
success	bool	Yes	Whether the request succeeded	Fixed
message	string	Yes	Error message (empty on success)	Fixed
data	UserSelf	Yes	Current user details	See table below

UserSelf Object

Field	Type	Required	Description	Remarks
id	int	Yes	User ID	Unique identifier
username	string	Yes	Username	Login name
display_name	string	Yes	Display name	Nickname / real name
status	int	Yes	Account status	See status enum below
quota	int	Yes	Recharge quota balance	Recharge only, excludes vouchers
used_quota	int	Yes	Used quota	Cumulative consumed quota
voucher_quota	int	Yes	Voucher balance	Quota from redemption codes etc.
request_count	int	Yes	API call count	Cumulative request count

Account Status Enum (status)

Value	Name	Description	Available
0	Inactive	Created but not activated	❌ Unavailable
1	Active	Account is normal	✅ Available
2	Disabled	Account has been disabled	❌ Unavailable

Response Example

Success response
{
  "success": true,
  "message": "",
  "data": {
    "id": 12,
    "username": "alice",
    "display_name": "Zhang San",
    "status": 1,
    "quota": 5000000,
    "used_quota": 1000000,
    "voucher_quota": 500000,
    "request_count": 250
  }
}
Error response
{
  "success": false,
  "message": "Unauthorized, please login first"
}