介绍

此接口用于查询订单状态

接口说明

请求方式：GET

请求路径：/open/api/v4/merchant/query/trade

请求参数

Header参数：

参数名	必选	类型	说明
appid	Y	string	应用的唯一标识
timestamp	Y	string	当前 UTC 13位时间戳, 5分钟内有效
sign	Y	string	签名，签名方式可参考这里

URL参数：

参数名	必选	类型	说明
orderNo	N	string	订单编号
merchantOrderNo	N	string	商户系统订单编号
side	Y	string	订单交易方向可选：`BUY` 或 `SELL` 不传时默认查询买币订单

示例

买币请求参数：

https://openapi-test.alchemypay.org/merchant/query/trade?orderNo=1028577684629876736&side=BUY>

查询结果

订单状态说明 点击这里

买币订单查询

{
    "payTime": "2025-09-19 15:07:07",
    "txTime": "2025-09-19 15:09:06",
    "networkFee": "0",
    "rebateFiatAmount": "",
    "rawRampFee": "67.500000",
    "fiatInUSD": "52.52",
    "network": "TRX",
    "tokenAddress": "",
    "cryptoPrice": "57.97340000",
    "payType": "GCASH",
    "rampFee": "67",
    "appId": "Y0Bo*************4d9",
    "fiat": "PHP",
    "txHash": "13528*******************20",
    "rampFeeInUSD": "1.18",
    "side": "BUY",
    "amount": "3000.00000000",
    "orderNo": "1418493255*******368",
    "address": "33************402",
    "cryptoNetworkFee": "0",
    "networkFeeInUSD": "0",
    "cryptoAmountInUSDT": "51.3387",
    "rebateUsdAmount": "",
    "crypto": "USDT",
    "rampFeeUnit": "PHP",
    "cryptoQuantity": "50.58",
    "createTime": "2025-09-19 15:05:46",
    "alpha2": "PH",
    "status": "FINISHED" //PENDING, PAY_FAIL, PAY_SUCCESS, TRANSFER, CANCEL, FINISHED
}

卖币订单查询

{
    "orderNo": "1080106145537236992",
    "address": "TRqyVJbztwVhxJqHKZD6D8LxYk5cubfmvu", // wallet address user need to transfer
    "payTime": "2023-02-28 20:44:46", // transfer fiat start time
    "completeTime": "2023-02-28 20:41:08", // block confirm time
    "merchantOrderNo": "kvhl6zvvrg",
    "crypto": "USDT",
    "network": "TRX",
    "cryptoPrice": "1.0000000000", // fiat
    "cryptoAmount": "100.0000000000",
    "fiatAmount": "100.0000000000", //fiat amount contains ramp fee
    "appId": "ahzxh0klegv1fzol",
    "fiat": "USD",
    "txHash": "sdasdasdasdasdasdsad",
    "email": "[email protected]",
    "signature": "9aa9b34e950061f1bb1e9ccd6fadcedab8e354f6",
    "status": "4", // 1：order create success  2：user trnasfered token  3：start to pay fiat to user  4：payment success 5：payment fail 6：refund success 7：order expired
    "orderAddress": "https://ramp-dev.alchemytech.cc/#/sellOrder?sellOrderId\u003d1080106145537236992", // order detail page
    "cryptoActualAmount": "100.0000000000", // 
    "rampFee": "1.7500000000", // fiat
    "receiptTime": "2023-02-28 20:45:22", //transfer fiat success time
    "paymentType": "10001", //  10001 banktransfer
    "name": "asdfsfsd", // account name
    "account": "******4567", // account number
    "card": "", // card No 
    "failReason": "" // failReason
}