Skip to content

Query Personal Top-up Records ​

Endpoint Path ​

http
GET /api/open/user/topup/self

Quota Calculation ​

amount is the quota change (internal unit). Convert to CNY as follows:

Amount (¥) = amount ÷ quota_per_unit × usd_exchange_rate

Where:

  • amount: from data.items[].amount returned by this endpoint
  • quota_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 ​

FieldTypeRequiredDescriptionConstraintsExample
pintNoPage numberDefault 11
page_sizeintNoRecords per pageDefault 10, max 10020
keywordstringNoSearch keywordSearch transaction number or remark"trade_123"
record_typestringNoRecord type filterSee 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 ​

FieldTypeRequiredDescriptionRemarks
successboolYesRequest success indicatorFixed value
messagestringYesError message (empty if successful)Fixed value
data[]RechargeRecordYesRecharge record arraySee table below

RechargeRecord Object

FieldTypeRequiredDescriptionRemarks
idintYesRecord IDUnique identifier
user_idintYesUser IDOwner user ID
amountint64YesRecharge amountQuota amount recharged; see Quota Calculation above
balance_beforeint64YesBalance beforePrevious balance
balance_afterint64YesBalance afterNew balance
order_idstringYesOrder IDTransaction order ID
statusintYesStatus1=Completed; 2=Pending; 3=Failed
created_timeint64YesCreation timeUnix second timestamp
remarkstringNoRemarkAdditional 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": ""
      }
    ]
  }
}