Skip to main content

​
Endpoint

GET /v1/account/order/history

​
Request Parameters

ParameterTypeRequiredDescription
typeStringYesOrder type. Supported values: Deposit, Payment, Withdraw.
timestampLongYesUNIX timestamp (in milliseconds).
tokenNameStringNoToken name. Defaults to querying all tokens.
startTimeLongNoStart time for the query. Defaults to 30 days before the current time.
endTimeLongNoEnd 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

ParameterTypeRequiredDescription
idStringYesOrder ID
chainNameStringYesBlockchain name
tokenNameStringYesToken name
amountStringYesDeposit amount
fromAddressStringYesSender’s address
toAddressStringYesRecipient’s address
txHashStringYesOn-chain transaction hash
createdTimeLongYesCreation time (UTC)
completeTimeLongYesCompletion time (UTC)
statusStringYesOrder status. See “Enum Definitions” for details.

​
Response Parameters: Payment

ParameterTypeRequiredDescription
idStringYesOrder ID
businessIdStringNoMerchant-defined order ID
chainNameStringYesBlockchain name
tokenNameStringYesToken name
amountStringNoMerchant-defined payment amount
amountActualStringNoActual payment amount
fromAddressStringNoSender’s address
toAddressStringYesRecipient’s address
txHashStringNoOn-chain transaction hash
createdTimeLongYesCreation time (UTC)
expiryTimeLongYesExpiration time (UTC)
completeTimeLongNoCompletion time (UTC)
statusStringYesOrder status. See “Enum Definitions” for details.

​
Response Parameters: Withdraw

ParameterTypeRequiredDescription
idStringYesOrder ID
businessIdStringNoMerchant-defined order ID
chainNameStringYesBlockchain name
tokenNameStringYesToken name
amountStringYesWithdrawal amount
toAddressStringYesRecipient’s address
txHashStringYesOn-chain transaction hash
networkFeeStringYesNetwork transaction fee
platformFeeStringYesPlatform commission fee
totalFeeStringYesTotal fee (network + platform)
createdTimeLongYesCreation time (UTC)
completeTimeLongYesCompletion time (UTC)
statusStringYesOrder 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"
        }
    ]
}