用户/商户批量查询历史订单

介绍:

适用于接入 Ramp API 模式的商户。商户可以查询某个用户的所有在 ACH 的订单。提供用户的邮箱,查询这个用户所有的 ACH 的 Ramp 订单。

接口说明

路径:POST /open/api/v3/merchant/query/UserHistory


名称是否必需类型描述
appIdYstringApp 唯一标识符
timestampYstring当前 UTC 时间的 13 位时间戳,在 5 分钟内有效
signYstring按字母顺序签名 appId、timestamp 和请求参数,签名方法可以参考此处

Body:

名称类型是否必需描述
typeSTRINGYSELL, BUY
emailSTRINGN邮箱,如果没有传,表示商户所有的订单
beginTimestampLONGN订单创建开始时间的时间戳,时间需要 UTC+0
endTimestampLONGN订单创建结束时间的时间戳,时间需要 UTC+0
pageINTN第几页,默认 1
rowsINTN默认 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 } ] }

Did this page help you?