资产流水

基于游标分页查询用户资产变动记录，支持按资产类型、业务类型和时间范围筛选。

接口信息

• 方法: GET
• 路径: /api/v1/assets/logs
• 鉴权: 需要签名认证（详见 公共模块 · 签名说明）

请求参数

参数	位置	类型	必填	说明
asset	query	string	否	资产类型，如 BTC、USDT
biz_type	query	string	否	业务类型（见下）
start_time	query	integer	否	开始时间（毫秒时间戳）
end_time	query	integer	否	结束时间（毫秒时间戳）
cursor	query	integer	否	游标，首次查询不传
limit	query	integer	否	每页数量，默认 20，最大 100

biz_type 枚举值

值	说明
freeze	下单冻结
unfreeze	撤单解冻
trade	成交扣减
trade_add	成交获得
fee	手续费
modify	改单调整
transfer_in	转入
transfer_out	转出

请求示例

GET /api/v1/assets/logs?asset=USDT&biz_type=trade&limit=50

响应字段

字段	类型	说明
code	integer	状态码
message	string	返回消息
data.has_more	boolean	是否有更多
data.next_cursor	integer	下一页游标
data.logs	array	流水列表
data.logs[].id	integer	主键 ID
data.logs[].user_id	integer	用户 ID
data.logs[].asset	string	资产类型
data.logs[].biz_id	string	业务 ID（如订单 ID）
data.logs[].biz_type	string	业务类型
data.logs[].change_type	integer	变动类型：1=可用增加, 2=可用减少, 3=冻结增加, 4=冻结减少
data.logs[].amount	string	变动金额
data.logs[].available_before	string	变动前可用余额
data.logs[].available_after	string	变动后可用余额
data.logs[].frozen_before	string	变动前冻结余额
data.logs[].frozen_after	string	变动后冻结余额
data.logs[].remark	string	备注
data.logs[].created_at	integer	创建时间（毫秒）

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "has_more": false,
    "next_cursor": 42,
    "logs": [
      {
        "id": 1,
        "user_id": 100001,
        "asset": "USDT",
        "biz_id": "1234567890123456",
        "biz_type": "freeze",
        "change_type": 2,
        "amount": "100",
        "available_before": "1100.5",
        "available_after": "1000.5",
        "frozen_before": "0",
        "frozen_after": "100",
        "remark": "",
        "created_at": 1704067200000
      }
    ]
  }
}