GET `/wallets/{user_id}/balance-history`

Get audit trail of wallet balance changes for a user.

Wallet Service `bearerAuth` application/json

Request Parameters

Name	In	Type	Required	Default	Description
`user_id`	`path`	`string`	Yes		User ID
`page`	`query`	`integer`	No	`1`	Page number
`page_size`	`query`	`integer`	No	`20`	Items per page

Status	Description	Schema
200	OK	`dto.BalanceHistoryListResponse`
400	Invalid request parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated or invalid token	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal server error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Field	Type	Required	Example
`amount`	`string`	No	`100.50`
`balance_after`	`string`	No	`1000.50`
`balance_before`	`string`	No	`900.00`
`date`	`string`	No	`2026-04-15T10:30:00Z`
`description`	`string`	No	`Account deposit`
`transaction_id`	`string`	No	`01ARZ3NDEKTSV4RRFFQ69G5FAV`
`type`	`string`	No	`deposit`

Field	Type	Required	Description
`code`	`integer`	No
`items`	array of See `dto.BalanceHistoryEntry`	No	Use items uniformly
`message`	`string`	No
`pagination`	`object`	No	Pagination info (nested object)
`timestamp`	`string`	No
`total`	`integer`	No	Total count (flat for direct access)

Field	Type	Required	Description
`has_next`	`boolean`	No	HasNext indicates whether there is a next page
`has_prev`	`boolean`	No	HasPrev indicates whether there is a previous page
`page`	`integer`	No	Page is the current page number (1-based)
`page_size`	`integer`	No	PageSize is the number of items per page
`total`	`integer`	No	Total is the total number of items across all pages
`total_pages`	`integer`	No	TotalPages is the total number of pages

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No