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

介绍:

适用于接入 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  
        }  
    ]  
}