Query Personal Top-up Records
Endpoint Path
http
GET /api/open/user/topup/selfQuota Calculation
amount is the quota change (internal unit). Convert to CNY as follows:
Amount (¥) = amount ÷ quota_per_unit × usd_exchange_rateWhere:
amount: fromdata.items[].amountreturned by this endpointquota_per_unit,usd_exchange_rate,quota_display_type: from Query Conversion Parameters (GET /api/open/status)
If quota_display_type = USD, omit × usd_exchange_rate.
Note: money is already the paid amount in yuan and needs no conversion.
Request Parameters
| Field | Type | Required | Description | Constraints | Example |
|---|---|---|---|---|---|
| p | int | No | Page number | Default 1 | 1 |
| page_size | int | No | Records per page | Default 10, max 100 | 20 |
| keyword | string | No | Search keyword | Search transaction number or remark | "trade_123" |
| record_type | string | No | Record type filter | See enum below | "topup" |
Request Example
json
GET 'https://neolink.com/backend/api/open/user/topup/self?p=1&page_size=20'
GET 'https://neolink.com/backend/api/open/user/topup/self?p=1&page_size=20&record_type=redemption'
GET 'https://neolink.com/backend/api/open/user/topup/self?page_size=10&keyword=trade_123'Return Information
| Field | Type | Required | Description | Remarks |
|---|---|---|---|---|
| success | bool | Yes | Request success indicator | Fixed value |
| message | string | Yes | Error message (empty if successful) | Fixed value |
| data | []RechargeRecord | Yes | Recharge record array | See table below |
RechargeRecord Object
| Field | Type | Required | Description | Remarks |
|---|---|---|---|---|
| id | int | Yes | Record ID | Unique identifier |
| user_id | int | Yes | User ID | Owner user ID |
| amount | int64 | Yes | Recharge amount | Quota amount recharged; see Quota Calculation above |
| balance_before | int64 | Yes | Balance before | Previous balance |
| balance_after | int64 | Yes | Balance after | New balance |
| order_id | string | Yes | Order ID | Transaction order ID |
| status | int | Yes | Status | 1=Completed; 2=Pending; 3=Failed |
| created_time | int64 | Yes | Creation time | Unix second timestamp |
| remark | string | No | Remark | Additional notes |
Response Example
json
{
"success": true,
"message": "",
"data": {
"page": 1,
"page_size": 20,
"total": 45,
"items": [
{
"id": 101,
"record_type": "topup",
"trade_no": "2026070812345678",
"payment_method": "alipay",
"amount": 5000000,
"money": 500.0,
"status": "success",
"create_time": 1752028800,
"remark": ""
}
]
}
}