◻️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

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

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

#import <Foundation/Foundation.h>
  ​
  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

//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

Response result example

{
      "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": "成功"
  }