# Check order status 1. Request Url: ``` https://{host}/api/v2/queryOrderState ``` 2\. Request parameter instance | parameter | whether | explain | | ----------- | ------- | ------------------------------------------- | | equipmentNo | Yes | Equipment unique number | | sourceType | Yes | eg：ANDROID,IOS,H5 | | orderId | Yes | eg：0eg：1fc8499f-dd6d-4ff3-8b7f-7a0d74c59adc | 3\. Example of request parameters ``` { "equipmentNo":"SFjeigreEIFegjieFei", "sourceType":"H5", "orderId":"9d4a577d-fdb1-466c-8da2-a5ad3553260b" } ``` 4.Example of returned results ``` { "data": { "chainFee": "0.001", "changeType": "advanced", "choiseFeeType": "3", "completeTime": null, "createTime": "2022-03-10 18:44:21", "dealFinishTime": null, "dealReceiveCoinAmt": "", "depositCoinAmt": "2", "depositCoinCode": "ETH", "depositCoinFeeAmt": "0.004", "depositCoinFeeRate": "0.002", "depositCoinState": "wait_send", "depositHashExplore": "https://etherscan.io/tx/null", "depositTxid": "", "destinationAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071", "detailState": "wait_deposit_send", "instantRate": "6.874588522739", "isDiscount": "N", "isNft": "", "kycUrl": "", "nftUrl": "", "orderId": "f94e631b-d99b-4dd5-98f7-09bf99d16d94", "orderState": "wait_deposits", "payTokenUrl": "", "platformAddr": "0x3181af4f7cc7251a6a4eda75526c8abe10106db8", "receiveCoinAmt": "13.713109", "receiveCoinCode": "BNB(BSC)", "receiveHashExplore": "https://bscscan.com/tx/", "receiveSwftAmt": "2416.89", "refundAddr": "0xAE93FA34f728855cE663cf9FcF8e32148F079071", "refundCoinAmt": "", "refundCoinMinerFee": "", "refundDepositTxid": "", "refundHashExplore": "https://etherscan.io/tx/", "refundSwftAmt": "", "router": {}, "swftCoinFeeRate": "0.001", "swftCoinState": "", "swftReceiveAddr": "", "swftRefundAddr": "", "timeoutShowPlatformAddr": "N", "tradeState": "", "transactionId": "", "burnRate": "0", "refundReason": "" }, "resCode": "800", "resMsg": "success", "resMsgEn": "" } ``` 5.Return Parameter Description | Field Name | field | data type | remarks | | ------------------------------------------ | ------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | orderId | orderId | String | eg：d47e8b9b-c17f-432b-9285-a46c0a3ceb9a | | depositCoinCode | depositCoinCode | String | eg：ETH | | receiveCoinCode | receiveCoinCode | String | eg：BTC | | depositCoinAmt | depositCoinAmt | String | eg：1 | | receiveCoinAmt | receiveCoinAmt | String | eg：0.1 | | platformAddr | platformAddr | String | eg：123123123-232-1231232 | | destinationAddr | destinationAddr | String | "Eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY. If there are memos, please put them in the address and separate them with #, for example: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY # 1927632" | | refundAddr | refundAddr | String | "Eg: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY If there are memos, please separate them with # after placing them in the address, for example: 18orDLFMp3fGoy5Uk93LDGTGbxWEm7b7FY # 1927632" | | depositCoinFeeRate | depositCoinFeeRate | String | Eg: Handling rate | | depositCoinFeeAmt | depositCoinFeeAmt | String | Eg: The amount of original currency charged for handling charges | | refundCoinAmt | refundCoinAmt | String | eg: 0.98 | | transactionId | transactionId | String | On chain transaction ID, this field will have a value only after the exchange is completed and the currency has been issued | | refundDepositTxid | refundDepositTxid | String | On chain transaction ID, this field will have a value only after the currency has been returned in case of exchange failure | | detailState | detailState | String | "(1) wait\_deposit\_send: waiting for the deposit currency to be sent; (2) timeout: timeout; (3) wait\_exchange\_push: waiting for the exchange information to be pushed; (4) wait\_exchange\_return: waiting for the exchange information to be returned; (5.1) wait\_receive\_send: waiting for the receipt currency to be sent; wait\_receive\_confirm: waiting for the receipt currency to be confirmed; receive\_complete: waiting for the receipt currency to be confirmed. (5.2) wait\_ refund\_ Send: Wait for sending the returned original currency, wait\_ refund\_ Confirm: wait for confirmation of returning original currency, refresh\_ Complete: Confirm the return of original currency; (6) ERROR/error: Processing order (7) WAIT\_ KYC: Wait for KYC or contact customer service to provide a link“ | | dealReceiveCoinAmt | dealReceiveCoinAmt | String | The quantity obtained from the actual exchange. When the exchange is not completed, the value is an empty string | | completeTime | completeTime | String | Time when the order is issued or returned (UTC+8) | | burnRate | burnRate | String | Default 0 | | createTime | createTime | String | createTime | | Completion time | dealFinishTime | String | Completion time | | depositCoinState | depositCoinState | String | wait\_send、wait\_confirm:、already\_confirm | | depositTxid | depositTxid | String | depositTxid | | swftAmt | receiveSwftAmt | String | swftAmt | | swftRate | swftCoinFeeRate | String | swftRate | | gas fee after the exchange is completed. | chainFee | String | gas fee after the exchange is completed. | | Exchange type | changeType | String | Exchange type | | Kyc path that exceeds the quota of the day | kycUrl | String | Kyc path that exceeds the quota of the day | | Reasons for refund of coins | refundReason | String |

Returns the information below corresponding to the number.

1 illiquidity (default). 2 Amount error

3 kyc excess.

4 address blacklist. 5 goal chain

maintenance

6 The amount of redemption is not within the range
7 Deposit timeout
8 Interacting with risky addresses

| ### Request Parameter Precautions | Parameter | Explanation | | ----------- | --------------------------------------------------------------------------------------------------------------------------- | | equipmentNo | Environment number, this can be used to check numbers associted with all of the order's information, please do not disclose | ### **Code Example** #### java code example ```java OkHttpClient client = new OkHttpClient(); ​ MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\n \"equipmentNo\": \"Zasdf352943090468518\",\n \n \"sourceType\": \"ANDROID\",\n\n \"orderId\": \"de752da3-0ff7-4682-8038-d8e1f20cad95\"\n}"); Request request = new Request.Builder() .url("https://{host}/api/v2/queryOrderState") .post(body) .addHeader("Content-Type", "application/json") .addHeader("cache-control", "no-cache") .build(); ​ Response response = client.newCall(request).execute(); ``` ​ #### **C#** code example ```csharp var client = new RestClient("https://{host}/api/v2/queryOrderState"); var request = new RestRequest(Method.POST); request.AddHeader("cache-control", "no-cache"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("undefined", "{\n \"equipmentNo\": \"Zasdf352943090468518\",\n \n \"sourceType\": \"ANDROID\",\n\n \"orderId\": \"de752da3-0ff7-4682-8038-d8e1f20cad95\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ​ #### **Objective-C** code example ```objectivec #import ​ NSDictionary *headers = @{ @"Content-Type": @"application/json", @"cache-control": @"no-cache" }; NSDictionary *parameters = @{ @"equipmentNo": @"Zasdf352943090468518", @"sourceType": @"ANDROID", @"orderId": @"de752da3-0ff7-4682-8038-d8e1f20cad95" }; ​ NSData *postData = [NSJSONSerialization dataWithJSONObject:parameters options:0 error:nil]; ​ NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://{host}/api/v2/queryOrderState"] cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:10.0]; [request setHTTPMethod:@"POST"]; [request setAllHTTPHeaderFields:headers]; [request setHTTPBody:postData]; ​ NSURLSession *session = [NSURLSession sharedSession]; NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) { if (error) { NSLog(@"%@", error); } else { NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response; NSLog(@"%@", httpResponse); } }]; [dataTask resume]; ``` ​ #### **Nodejs** code example ```javascript //getToken example import axios from 'axios' const params = { equipmentNo:"zfgryh918f93a19fdg6918a68cf5", sourceType:"H5", userNo:"", sessionUuid:"", orderId:"9d4a577d-fdb1-466c-8da2-a5ad3553260b", sourceFlag:"widget" } const res = await axios.post('https://{host}/api/v2/queryOrderState', params ) console.log(res) ``` #### ​Postman example ![](/files/QU09ucZRZNWs3BmwZmWQ) ### **Response result example** ```yaml { "data": { "changeType": "advanced", "choiseFeeType": "3", "dealReceiveCoinAmt": "10.513615", "depositCoinAmt": "0.276", "depositCoinCode": "ETH", "depositCoinFeeAmt": "0.000276", "depositCoinFeeRate": "0.001", "depositCoinState": "already_confirm", "destinationAddr": "loveqyw12345", "detailState": "receive_complete", "orderId": "de752da3-0ff7-4682-8038-d8e1f20cad95", "orderState": "wait_send", "platformAddr": "0x6e76d9e78b6f4878fbe83e6985185173373f0b7e", "receiveCoinAmt": "10.403011", "receiveCoinCode": "EOS", "receiveSwftAmt": "14.06", "refundAddr": "0x189547cb7984711c2ab25b1543a784e65628a8f6", "refundCoinAmt": "", "refundCoinMinerFee": "", "refundDepositTxid": "", "refundSwftAmt": "", "swftCoinFeeRate": "0.0005", "swftCoinState": "", "swftReceiveAddr": "", "swftRefundAddr": "", "tradeState": "", "transactionId": "072a7915ac9de0e64d5131afde8f61e1cdf0cf517ffa3f8db2f2d26bf208b658", "burnRate": "0" "refundReason": "" }, "resCode": "800", "resMsg": "成功" } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.en.omnibridge.pro/cross-chain-swap-api/check-order-status.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.