Query Order History - Bass Wallet

Endpoint

GET /v1/account/order/history

Request Parameters

Parameter	Type	Required	Description
type	`String`	Yes	Order type. Supported values: `Deposit`, `Payment`, `Withdraw`.
timestamp	`Long`	Yes	UNIX timestamp (in milliseconds).
tokenName	`String`	No	Token name. Defaults to querying all tokens.
startTime	`Long`	No	Start time for the query. Defaults to 30 days before the current time.
endTime	`Long`	No	End time for the query. Defaults to the current timestamp.

Note: The maximum query time range is 30 days, i.e., endTime - startTime <= 30 Days.

There are currently three order types, and the response parameters vary by type:

Deposit: Orders related to deposits to fixed addresses.
Payment: Orders created via payment order links. Use status to determine order completion.
Withdraw: Withdrawal orders.

Response Parameters: `Deposit`

Parameter	Type	Required	Description
id	`String`	Yes	Order ID
chainName	`String`	Yes	Blockchain name
tokenName	`String`	Yes	Token name
amount	`String`	Yes	Deposit amount
fromAddress	`String`	Yes	Sender’s address
toAddress	`String`	Yes	Recipient’s address
txHash	`String`	Yes	On-chain transaction hash
createdTime	`Long`	Yes	Creation time (UTC)
completeTime	`Long`	Yes	Completion time (UTC)
status	`String`	Yes	Order status. See “Enum Definitions” for details.

Response Parameters: `Payment`

Parameter	Type	Required	Description
id	`String`	Yes	Order ID
businessId	`String`	No	Merchant-defined order ID
chainName	`String`	Yes	Blockchain name
tokenName	`String`	Yes	Token name
amount	`String`	No	Merchant-defined payment amount
amountActual	`String`	No	Actual payment amount
fromAddress	`String`	No	Sender’s address
toAddress	`String`	Yes	Recipient’s address
txHash	`String`	No	On-chain transaction hash
createdTime	`Long`	Yes	Creation time (UTC)
expiryTime	`Long`	Yes	Expiration time (UTC)
completeTime	`Long`	No	Completion time (UTC)
status	`String`	Yes	Order status. See “Enum Definitions” for details.

Response Parameters: `Withdraw`

Parameter	Type	Required	Description
id	`String`	Yes	Order ID
businessId	`String`	No	Merchant-defined order ID
chainName	`String`	Yes	Blockchain name
tokenName	`String`	Yes	Token name
amount	`String`	Yes	Withdrawal amount
toAddress	`String`	Yes	Recipient’s address
txHash	`String`	Yes	On-chain transaction hash
networkFee	`String`	Yes	Network transaction fee
platformFee	`String`	Yes	Platform commission fee
totalFee	`String`	Yes	Total fee (network + platform)
createdTime	`Long`	Yes	Creation time (UTC)
completeTime	`Long`	Yes	Completion time (UTC)
status	`String`	Yes	Order status. See “Enum Definitions” for details.

Response Examples

{
    "code": 200,
    "msg": "success",
    "timestamp": "1725853275828",
    "data": [
        {
            "id": "588076016694595584",
            "businessId": "0909_test7",
            "chainName": "Tron",
            "tokenName": "USDT",
            "amount": "52.89",
            "toAddress": "TKjLDbk7LC9NXzRBCYahKa8pzMHRfahJjn",
            "txId": "3eeee30367dd33e257458fe34098a5ee353cc1501053d756484b8b52fdbe5795",
            "networkFee": "2",
            "platformFee": "0.1",
            "totalFee": "2.1",
            "createdTime": 1729475874520,
            "completeTime": 1729475874520,
            "status": "Success"
        }
    ]
}

    {
    "code": 200,
    "msg": "success",
    "timestamp": "1725853367355",
    "data": [
        {
            "id": "588061066492252160",
            "chainName": "Tron",
            "tokenName": "TRX",
            "amount": "20.00",
            "fromAddress": "TKjLDbk7LC9NXzRBCYahKa8pzMHRfahJjn",
            "toAddress": "TSWoFUDouEfFdGrDEvd6S6WBhQsLKs7Kqo",
            "txHash": "5efd31cca2c3e1b8a0812aa9da58dddb4c8f8421ede1778c18fe3cee6aa586ae",
            "createdTime": 1729475874520,
            "completeTime": 1729475874520,
            "status": "Success"
        }
    ]
}