List Transfer Orders by Wallet

GET/web/v1/transfer/query/orders JWT

Retrieves a paginated list of transfer orders for a specific wallet by query parameter.

Authentication

Requires a valid JWT token and Turnstile verification.

Request Parameters

Name	Type	Required	In	Description
walletId	string	Required	query	Wallet ID (query 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

• Results are scoped to the current workspace context.
• If no time range is specified, defaults to the last 30 days.