List Transfer Orders by Wallet (Admin)

GET/web/v1/admin/transfer/query/orders/wallet/{walletId} JWT

Retrieves a paginated list of transfer orders for a specific wallet. Admin view without workspace scoping.

Authentication

Requires a valid JWT token and Turnstile verification.

Request Parameters

Name	Type	Required	In	Description
walletId	string	Required	path	Wallet ID (path parameter)
startTime	string	Optional	query	Start time filter (ISO 8601 format). Defaults to 30 days ago
endTime	string	Optional	query	End time filter (ISO 8601 format). Defaults to current time
page	integer	Optional	query	Page number (0-based). Default: 0
size	integer	Optional	query	Page size. Default: 20
sort	string	Optional	query	Sort field and direction (e.g. "createdAt,desc")

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "content": [
      {
        "bizId": "TRF20260321000001",
        "fromWalletId": "WLT-SRC-001",
        "toWalletId": "WLT-DST-002",
        "currency": "USD",
        "amount": 100.5,
        "feeAmount": 1,
        "totalAmount": 101.5,
        "status": 2,
        "statusName": "COMPLETED",
        "failureReason": null,
        "remark": null,
        "createdAt": "2026-03-21T10:00:00Z",
        "completedAt": "2026-03-21T10:00:05Z"
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "size": 20,
    "number": 0
  }
}

Error Responses

HTTP Status	Code	Description
401	4010	Unauthorized

Notes

• If no time range is specified, defaults to the last 30 days.
• Returns transfers where the given wallet is either source or destination.