用户/商户批量查询历史订单
介绍:
适用于接入 Ramp API 模式的商户。商户可以查询某个用户的所有在 ACH 的订单。提供用户的邮箱,查询这个用户所有的 ACH 的 Ramp 订单。
接口说明
路径:POST /open/api/v3/merchant/query/UserHistory
名称 | 是否必需 | 类型 | 描述 |
---|---|---|---|
appId | Y | string | App 唯一标识符 |
timestamp | Y | string | 当前 UTC 时间的 13 位时间戳,在 5 分钟内有效 |
sign | Y | string | 按字母顺序签名 appId、timestamp 和请求参数,签名方法可以参考此处 |
Body:
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
type | STRING | Y | SELL, BUY |
STRING | N | 邮箱,如果没有传,表示商户所有的订单 | |
beginTimestamp | LONG | N | 订单创建开始时间的时间戳,时间需要 UTC+0 |
endTimestamp | LONG | N | 订单创建结束时间的时间戳,时间需要 UTC+0 |
page | INT | N | 第几页,默认 1 |
rows | INT | N | 默认 100,最大 500 |
- beginTime 和 endTime 为空,返回最近 30 天数据
- beginTime 有值,endTime 为空,endTime 默认为当前时间
- beginTime 为空,endTime 有值,beginTime 默认为 endTime 之前 30 天
买币 response:list 格式,时间顺序排序
{
'success': True,
'returnCode': '0000',
'returnMsg': 'SUCCESS',
'extend': '',
'data': {
'total': 39,
'pageIndex': 1,
'pageSize': 39,
'result': [
{
'orderNo': '1164814618820165632',
'fiat': 'USD',
'fiatAmount': '150.00', // 法币交易数量
'cryptoQuantity': '11194.15000000', // 数字货币交易数量
'crypto': 'ACH',
'network': 'ETH',
'rampFee': '6.3850', // 以订单的 fiat 为单位
'networkFee': '', // 以订单的 token 为单位
'cryptoPrice': '0.00',
'status': ' ', // 订单状态或状态码
'payWayCode': '701',
'rebateFiatAmount': '0.00', // 佣金数量,没有返佣则返回 0,需要根据账务管理--On Ramp - Off Ramp 返佣的返佣金额展示,不管订单状态,都返回返佣数量
'rebateUsdAmount': '0.00'
}
]
}
}
卖币 response:list 格式,订单时间倒序
{
"total": 166,
"pageIndex": 1,
"pageSize": 100,
"result": [
{
"orderNo": "1215258435406155776",
"fiat": "EUR",
"fiatAmount": "0.0000000000",
"cryptoQuantity": "50.0000000000",
"crypto": "USDT",
"cryptoPrice": "1.0000000000", // USDT/USD 价格
"status": "ORDER_TIMEOUT",
"hash": "",
"network": "TRX",
"rampFee": "0.0000000000",
"payWayCode": "19000",
"createTime": 1709781789000,
"updateTime": 1709954593000
}
]
}
Updated 9 months ago