积分历史记录接口文档

接口信息

• 接口路径: /api/earn/points-history
• 请求方法: GET
• 接口描述: 获取积分历史记录列表，支持分页查询

请求参数

Query 参数

参数名	类型	必填	说明
pageIndex	number	否	页码，从 1 开始，默认为 1
pageSize	number	否	每页数量，默认值根据接口实现而定
walletAddress	string	否	钱包地址，用于查询指定用户的积分历史

请求示例

GET /api/earn/points-history?pageIndex=1&pageSize=20&walletAddress=0x35487e65c8aef497fa8f29cbe9cb097c88753eb8172c0f640285921169730d38

响应数据结构

响应格式

{
  "code": 200,
  "message": "OK",
  "result": {
    "data": [
      {
        "source": "Referral reward",
        "points": 50,
        "timestamp": 1764909625554
      }
    ],
    "nextPageIndex": 2,
    "total": 100,
    "totalPoints": 165
  }
}

响应字段说明

result 对象字段

字段名	类型	必填	说明
data	array	是	积分历史记录列表
nextPageIndex	number	否	下一页页码，无下一页为空
total	number	是	总记录数
totalPoints	number	是	用户总积分

data 数组项字段

字段名	类型	必填	说明
source	string	是	积分来源，如 "Referral reward"（推荐奖励）、"Liquidity mining"（流动性挖矿）、"Trading rebate"（交易返利）、"Vault staking"（金库质押）等
points	number	是	积分数量
timestamp	number	是	获得积分的时间戳（毫秒）

响应示例

{
  "code": 200,
  "message": "OK",
  "result": {
    "data": [
      {
        "source": "Referral reward",
        "points": 50,
        "timestamp": 1764909625554
      },
      {
        "source": "Liquidity mining",
        "points": 30,
        "timestamp": 1764822220000
      },
      {
        "source": "Trading rebate",
        "points": 20,
        "timestamp": 1764735820000
      },
      {
        "source": "Referral reward",
        "points": 40,
        "timestamp": 1764649420000
      },
      {
        "source": "Vault staking",
        "points": 25,
        "timestamp": 1764563020000
      }
    ],
    "nextPageIndex": 2,
    "total": 100,
    "totalPoints": 165
  }
}

积分来源说明

source 字段可能的值包括：

• "Referral reward": 推荐奖励
• "Liquidity mining": 流动性挖矿
• "Trading rebate": 交易返利
• "Vault staking": 金库质押
• 其他来源根据实际业务而定

注意事项

1. pageIndex 从 1 开始计数
2. pageSize 为可选参数，默认值根据接口实现而定
3. walletAddress 参数为可选，传入后可以查询指定用户的积分历史
4. 当 nextPageIndex 不存在或为空时，表示没有下一页数据
5. total 字段表示符合条件的总记录数，可用于计算总页数
6. totalPoints 字段表示用户的总积分，是所有历史积分记录的总和
7. timestamp 为时间戳（毫秒），前端需要转换为可读的时间格式
8. points 为数字类型，表示获得的积分数量（通常为正数）
9. source 字段为字符串类型，前端可以根据不同的来源显示不同的图标或样式
10. 数据按时间戳降序排列（最新的记录在前）
11. 响应格式遵循 API 标准：code 为 200 表示成功，message 为状态消息