Batch Query History Order of Merchant
Introduction:
Support API mode Merchant
Merchant can query all orders of a particular user for all orders.
Provide the user's email address to query all the ramp orders of this user.
Interface Description
Request Method: POST
Request Path: /open/api/v4/merchant/query/UserHistory
Header:
Parameter | Mandatory | Type | Remarks |
---|---|---|---|
appId | Y | string | App unique identifier |
timestamp | Y | string | Current UTC 13-digit timestamp, valid within 5 minutes |
sign | Y | string | Sign the appId, timeStamp, and requested parameters |
Body:
Field | Mandatory | Type | Description |
---|---|---|---|
type | Y | string | SELL or BUY |
N | string | Email; if not provided, it represents all orders of the merchant | |
beginTimestamp | N | long | Timestamp of the starting time for order creation, in UTC+0 |
endTimestamp | N | long | Timestamp of the ending time for order creation, in UTC+0 |
pageNum | N | int | Page number; default is 1 |
pageSize | N | int | Default is 100, maximum is 500 |
- "beginTime" and "endTime" are empty, return the last 30 days of data.
- "beginTime" has a value, "endTime" is null, endTime defaults to the current time.
- "beginTime" is null, "endTime" has a value, beginTime defaults to 30 days before endTime.
Buy coins response: list format, chronological sorting
{
"success": true,
"returnCode": "0000",
"returnMsg": "SUCCESS",
"extend": "",
"data": {
"total": 39,
"pageIndex": 1,
"pageSize": 39,
"result": [
{
"orderNo": "1044203173299257344",
"fiat": "USD",
"fiatAmount": "10.99",
"cryptoQuantity": "10.05000000",
"crypto": "USDT",
"network": "MATIC",
"rampFee": "0.83",
"networkFee": "0.05000000",
"cryptoPrice": "1.00",
"status": "FINISHED",
"payWayCode": "10001",
"rebateUsdAmount": "0.00",
"rebateFiatAmount": "0.00",// commission quantity, no rebate then return 0, need to be based on the account management - On Ramp - Off Ramp rebate rebate amount show, regardless of the order status, all return rebate quantity
"hash": "0x2b26d0XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX89f0e0ac",
"createTime": 1740524610000,
"updateTime": 1740528780000,
"rawRampFee": "0.838501"
}
]
}
}
Seller response: list format, reverse chronological ordering
{
"total": 166,
"pageIndex": 1,
"pageSize": 100,
"result": [{
"orderNo": "1215258435406155776",
"fiat": "EUR",
"fiatAmount": "0.0000000000",
"cryptoQuantity": "50.0000000000",
"crypto": "USDT",
"cryptoPrice": "1.0000000000", USDT/U价格
"status": "ORDER_TIMEOUT",
"hash": "",
"network": "TRX",
"rampFee": "0.0000000000",
"payWayCode": "19000",
"createTime": 1709781789000,
"updateTime": 1709954593000
}
Updated about 1 month ago