HTTPAPI

xt为用户提供了一个简单的而又强大的API,旨在帮助用户快速高效的将xt交易功能整合到自己应用当中。

API地址域名地址

域名地址:https://www.xt.com/

使用说明

使用这些API之前首先要获取两项参数,在网站登录后,进入API功能开启然后获取Api Id和Api Secret两项参数。通过这两个参数拥有交易下单、提币等高级权限,请用户注意保密。所有http接口都需要进行签名,签名规则在后面说明。

1配置及基础功能API

1.1获取市场列表

path:https://www.xt.com/exchange/config/controller/website/MarketController/getByWebId
请求方式:get
请求报文

返回成功报文


{
  { "datas": [
    {
      "amountDecimal": 8,//数量精度
      "minAmount": "0.0001000000",//最小数量
      "buyerCurrencyId": "2",//买方币种
      "priceDecimal": 8,//价格精度
      "serverId": "entrust-server-001",//服务ID
      "marketId": "70",//市场ID
      "webId": "100", //站点ID
      "modifyTime": 0,
      "sellerCurrencyId": "19",//卖方币种
      "createTime": 1522400906009,
      "defaultFee": "0.00050000",//默认费率
      "name": "zt_btc",//市场名称
      "leverType": "1",//杠杆类型: 1现货 2杠杆
      "state": 1,//状态: 1 运行, 0 停止 -1 删除
      "openTime": 1,//开盘时间
    },
    ....
  ],
  "resMsg": {
    "code": "1",
    "method": null,
    "message": "success !"
  }
}

1.2获取币种列表

path:https://www.xt.com/exchange/config/controller/website/CurrencyController/getCurrencyList
请求方式 :get
请求报文

返回成功报文

{
  "datas": [
    {
      "totalNumber": "230000000.00000000",//总量
      "tradeSearchUrl": null,//交易查询地址
      "tokenCoinsId": 0,//如果大于0是另一种币的token,否则等于0
      "minCash": null,
      "tokenName": null,//
      "description": "比特币",//描述
      "arithmetic": null,   //共识算法
      "dailyDrawLimit": 10000,
      "remark": null,   //
      "isLegalCoin": 0, //是否是法币,比如美金 1是,0不是
      "outConfigTimes": 0,//
      "timesFreetrial": "0",//
      "hourFreetrial": "0",//
      "inConfigTimes": 6,//
      "alias": "b",//别名
      "logo": "market-btc.png",//图标
      "needBlockUrl": 0,//是否需要block地址,0不需要 1需要
      "currencyId": "2",//币种id
      "drawFlag": 1,
      "rechargeFlag": 1,
      "onceDrawLimit": 100,
      "founder": null,
      "drawFee": "0.00100000",
      "blockChainUrl": "https://blockchain.info/tx/", //blockChain查询地址(区块查询地址)
      "dayFreetrial": "0",
      "marketValue": null,//总市值
      "minFee": null,
      "teamAddress": null,
      "defaultDecimal": 2,//币种小数位(精度)-优先级低于 market中的配置
      "publishNumber": "14500000.00000000",//已发行
      "isMining": "0",//是否可挖矿
      "name": "btc",//名称
      "limitAmount": null,
      "websiteCurrencyId": "223f4d23232",
      "descriptionEnglish": "<p>The BTC is ...</p>",//英文描述
      "mark": null//符号
    },
    .....
  ],
  "resMsg": {
    "code": "1",
    "method": null,
    "message": "success !"
  }
}

2交易API

2.1新增委托:

path:https://www.xt.com/exchange/entrust/controller/website/EntrustController/addEntrust
请求方式:post
请求报文:

json
{
  "amount": 0,                          //下单数量
  "rangeType": 0,                       //委托类型,目前仅支持现价委托  0:现价委托  1 区间委托
  "type": 0,                            //买卖类型:0 卖出 1 购买
  "marketId": "90",                     //市场ID
  "price": 0                            //价格
}

返回报文:

json
{
  "datas":{
    “entrustId”:"E6419466484531482624"  //委托ID
  },
  "resMsg":{
    "code":"1",                        //1代表成功,其他为错误码见说明
    "method":null,
    "message":"success !"
  }
}

2.2取消委托

path:https://www.xt.com/exchange/entrust/controller/website/EntrustController/cancelEntrust
请求方式:post
请求报文:

json
{
  "entrustId": "E6419466484531482624",  //要取消的委托ID
  "marketId": "90"                     //市场ID
}

返回报文:

json
{
  "datas":null,
  "resMsg":{
    "code":"1",                        //1代表成功,其他为错误码见说明
    "method":null,
    "message":"success !"
  }
}

2.3查询正在进行的委托

path: https://www.xt.com/exchange/entrust/controller/website/EntrustController/getUserEntrustRecordFromCacheWithPage
请求方式:get
请求报文:

marketId: 90                    //市场ID

返回报文:

json
{
  "datas": [{
    "amount": "1.1",            //数量
    "rangeType": "0",            //区间类型 0 现价委托 1 区间委托
    "rangeLowPrice": "null",            //区间委托的最低价
    "rangeHighPrice": "null",            //区间委托的最高价
    "totalMoney": "5.555",            //总金额
    "entrustId": "E6437955999037923328",            //委托ID
    "type": "0",            //0 卖出 1 购买  -1 取消
    "userId": "test6",            //用户id
    "completeAmount": "0",            //已经成交的数量
    "marketId": "80",            //市场id
    "dealTimes": "0",            //交易处理次数
    "createTime": "1534928321609",            //下单时间
    "price": "5.05",            //单价
    "completeTotalMoney": "0",            //已完成的总金额
    "entrustType": "false",            //委托类型 0(false)普通委托单 1(true)杠杆委托单
    "status": "0",            //状态 : -2资金解冻失败 -1用户资金不足 0起始 1取消 2交易成功 3交易一部分
  }],
  "resMsg": {
    "code": "1",            //1代表成功,其他为错误码见说明
    "method": null,
    "message": "success !"
  }
}

2.4分页查询历史委托委托(只查询已经成交和已经取消的委托记录)

paht: https://www.xt.com/exchange/entrust/controller/website/EntrustController/getUserEntrustList
请求方式:get
请求报文:

marketId:   90                      //市场ID
pageIndex:  1               //页码
pageSize:   10              //每页展示条数

返回报文:

json
{
  "datas": [{
    "amount": "1.1",            //数量
    "rangeType": "0",            //区间类型 0 现价委托 1 区间委托
    "rangeLowPrice": "null",            //区间委托的最低价
    "rangeHighPrice": "null",            //区间委托的最高价
    "totalMoney": "5.555",            //总金额
    "entrustId": "E6437955999037923328",            //委托ID
    "type": "0",            //0 卖出 1 购买  -1 取消
    "userId": "test6",            //用户id
    "completeAmount": "0",            //已经成交的数量
    "marketId": "80",            //市场id
    "dealTimes": "0",            //交易处理次数
    "createTime": "1534928321609",            //下单时间
    "price": "5.05",            //单价
    "completeTotalMoney": "0",            //已完成的总金额
    "entrustType": "false",            //委托类型 0(false)普通委托单 1(true)杠杆委托单
    "status": "0",            //状态 : -2资金解冻失败 -1用户资金不足 0起始 1取消 2交易成功 3交易一部分
  }],,
  "totalPage": "2",            //委托记录总条数
  "currentPage": "1",            //当前页数
  "resMsg": {
    "code": "1",            //1代表成功,其他为错误码见说明
    "method": null,
    "message": "success !"
  }
}

2.5根据委托单id查询委托记录

path: https://www.xt.com/exchange/entrust/controller/website/EntrustController/getEntrustById
请求方式:get
请求参数:

marketId:   90                      //市场ID
entrustId:  E6419443135315070976    // 要查询的委托ID

返回报文:

{
  "datas": [{
    "amount": "1.1",            //数量
    "rangeType": "0",            //区间类型 0 现价委托 1 区间委托
    "rangeLowPrice": "null",            //区间委托的最低价
    "rangeHighPrice": "null",            //区间委托的最高价
    "totalMoney": "5.555",            //总金额
    "entrustId": "E6437955999037923328",            //委托ID
    "type": "0",            //0 卖出 1 购买  -1 取消
    "userId": "test6",            //用户id
    "completeAmount": "0",            //已经成交的数量
    "marketId": "80",            //市场id
    "dealTimes": "0",            //交易处理次数
    "createTime": "1534928321609",            //下单时间
    "price": "5.05",            //单价
    "completeTotalMoney": "0",            //已完成的总金额
    "entrustType": "false",            //委托类型 0(false)普通委托单 1(true)杠杆委托单
    "status": "0",            //状态 : -2资金解冻失败 -1用户资金不足 0起始 1取消 2交易成功 3交易一部分
  }],,
  "resMsg": {
    "code": "1",            // 1代表成功,其他为错误码见说明
    "method": null,
    "message": "success !"
  }
}

3 财务资金API

3.1 获取充币地址

path:https://www.xt.com/exchange/fund/controller/website/FundController/getPayinAddress
请求方式:get
请求报文

{
    “currencyTypeName”:"btc" // 货币类型名称(必传)
}

返回报文


{
    "datas": {
        "address": "19cdJwd3j6ArHNhiYoWpN8cJq9ash7WDDC",// 充币地址
        "wallet": "merchants014"
    },
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

3.2 查询充币记录

path:https://www.xt.com/exchange/fund/controller/website/FundController/getPayinCoinRecord
请求方式:post
请求报文

{
    “currencyTypeName”:“qtum”, // 货币类型
    “sort”:1 // 不传按充币时间倒序排,传了按升序排序
    "pageNum":1
    "pageSize":20
}

返回报文

{
    "datas": {
        "totalRow": 1,  // 总行数
        "totalPage": 1, // 总页数
        "pageSize": 20, // 每页数量
        "list": [
            {
                "currencyTypeId": 1,// 货币类型id
                "depositId": “f3342424”,// 充值主键
                "amount": "10.0",// 充币数量
                "confirmTimes": "4",// 确认次数
                "createTime": "2018-03-10 10:22:09.0",// 充币时间
                "depositAddress": "1BKd2sSPYzxC2XHurR6oQWc2wzSx2rZzck",// 充币地址
                "txId": "6378183001917882368",// 交易id
                "userId": "1",// 用户id
                "status": 1,//' 0:未到账  1:已到账  '

            }
        ],
        "pageNum": 1
    },
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

3.3 查询提币记录

path:https://www.xt.com/exchange/fund/controller/website/FundWebSiteController/getPayoutCoinRecord
请求方式:get
请求报文

currencyId=1    // 币种id(必选)
tab=all         // (必选) | all(所有), wait(已提交,未审核), success(审核通过), fail(审核失败), cancel(用户主动取消)
pageIndex=1     // 可选, 默认 1
pageSize=10     // 可选, 默认 10

返回报文

{
    "datas": {
        "totalRow": 34,                                          // 总行数
        "totalPage": 4,                                          // 总页数
        "pageSize": 10,                                          // 每页数量
        "list": [
            {
                "modifyUid": null,                               // 修改人id
                "withdrawalId": "W6419027628808093696",          // 提现id
                "fees": "0.001000000000000000",                  // 手续费
                "amount": "10.000000000000000000",               // 提现数量
                "userApplyWithdrawId": "7eBDJ5PKbSK",            // 提现记录id
                "verifyRemark": null,                            // 审核意见
                "remark": null,                                  // 备注
                "verifyTime": 0,                                 // 审核时间
                "userName": "994709373@qq.com",                  // 用户名
                "userId": "7e9ioSoVXcW",                         // 用户id
                "actuallyAmount": "10.000000000000000000",       // 实际到账数量
                "modifyTime": 0,                                 // 修改时间
                "verifyStatus": 0,                               // 审核状态(0 待审核 , 1 审核通过 -1 审核不通过)
                "createTime": 1530415446577,                    // 提币时间
                "state": 1,                                                             // 状态(-1 删除, 1 正常)
                "currencyId": "2",                                                          // 币种id
                "withdrawalAddress": "1JimMZks39eVqU6T3v6wvz1m4LtJ3tPjGL",                  // 提币地址
                "verifyUid": null                                                           // 审核人id
            }
        ],
        "pageNum": 1
    },
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

3.4 获取用户所有资金信息

path:https://www.xt.com/exchange/fund/controller/website/FundController/findByPage
请求方式:get
请求报文


{
    "pageSize":30,       #  每页行数(可选)
    "pageNum":1          #  页码(可选)
}

返回报文

{
    "datas": {
        "totalRow": null,
        "totalPage": null,
        "pageSize": 30,
        "list": [
            {
                "currencyTypeId": 1,                    // 货币类型id
                "amount": "971.174000000000000000",     // 用户当前可用资金数量
                "freeze": "122.000000000000000000",     // 用户冻结资金数量
                "createTime": "2018-02-19 10:02:33",
                "depositAddress": null,
                "userId": "1"
            },
            {
                "currencyTypeId": 2,
                "amount": "768.368000000000000000",
                "freeze": "131.000000000000000000",
                "createTime": "2018-02-19 10:02:33",
                "depositAddress": null,
                "userId": "1"
            }
        ],
        "pageNum": 1
    },
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

3.5 查询提币地址

path:https://www.xt.com/exchange/fund/controller/website/FundWebSiteController/getWithdrawAddress
请求方式:get
请求报文

currencyId=2          // (必传)
pageIndex=1           // (可选, 默认1)
pageSize=10           // (可选, 默认10)

返回报文

{
    "datas": {
        "totalRow": 2,
        "totalPage": 1,
        "pageSize": 10,
        "list": [
            {
                "address": "1DkwrD4bMtjd6kcZw8CxM9r3z4AGVFfSRz",    // 地址
                "modifyTime": 1524217688882,                        // 修改时间
                "currencyName": "btc",                              // 币种名称
                "createTime": 1523185357488,                        // 提币时间
                "userFundAddressId": "7bwK95B7jTk",                 // 地址id
                "remark": "correct",                                // 备注
                "currencyId": "2",                                  // 币种id
                "type": 1,                                          // (1-提币地址, 2-打币地址)
                "userName": "Mr.牛",                                // 用户名
                "userId": "7e8fMkzTlL6",                            // 用户id
                "status": "1"                                       // 状态(-1 删除, 1 正常)
            }
        ],
        "pageNum": 1
    },
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

4 签名规则

4.1 签名规则

签名串sign=md5(Apiid+Timestamp+参数内容拼串+签名秘钥),Timestamp是毫秒为单位的时间戳,签名秘钥为ApiSecret,和Apiid在网站打开Api功能时获取。参数拼串内容规则有三种,只有header参数的为空字符串"" ,body json格式的参数为body参数的json字符串格式,key-value以及get形式的参数内容拼串为所有参数按key值首字母排序后再按key1+value1+key2+value2...的形式拼串。签名后将Apiid、Timestamp、Sign放入到请求header中,注意首字母大写,后面全小写。
比如在网站打开API功能后拿到下面两个参数 Apiid=7eESLc0x69I7eESLc0x69J,Apisecret = 87ceba599b6d39a39deb01cf71eacd57,Timestamp=1526886847000,
a、Body json格式参数

 参数内容json字符串为:{"userId":"u111","name":"zhangsan"}
参数内容拼串为:{"userId":"u111","name":"zhangsan"}
则 Sign = md5(7eESLc0x69I7eESLc0x69J1526886847000{"userId":"u111","name":"zhangsan"}87ceba599b6d39a39deb01cf71eacd57)
= 1429945054c993ea3e22a28227bf7b25   

b、 没有任何body或get参数

 参数内容拼串为空 则
Sign = md5(7eESLc0x69I7eESLc0x69J152688684700087ceba599b6d39a39deb01cf71eacd57)
= 735aeffac07c60ddeb2d6f18115c1946 

c、formdata key-value, 或者get参数

 参数内容为:userid=10,status=1,acount = 10
参数内容拼串为:account10status1userid10
则 Sign = md5(7eESLc0x69I7eESLc0x69J1526886847000account10status1userid1087ceba599b6d39a39deb01cf71eacd57)
= 1d83cb6bde160eff50fbb13a407e7804   

提供Java版本的签名代码如下,其他语言请参考代码自行实现

package com.xt.api.demo;

import com.alibaba.fastjson.JSON;

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HashMap;
import java.util.Map;

/**
 * @Author: cai.zhenghao
 * @Description:
 * @Date: Created in 2018/6/26   下午3:48
 * @Modified By:
 */
public class SignUtils {

    /**
     * 自行根据需要设置,一般认为一个服务里使用的只有一个
     */
    public static String ID_NAME = "Apiid";
    private static final Integer CLIENT_TYPE = 5;//API调用

    /**
     * 不为空、不为空字符串、不为双引号、不为空{}
     *
     * @param source
     * @return
     */
    public static boolean isEmpty(String source) {
        return source == null || source.isEmpty() || source.equals("\"\"") || source.trim().equals("{}");
    }

    /**
     * 参数是formdata key value,或者get参数 形式的情况下获取签名header
     *
     * @param parameters
     * @return
     */
    public static Map getHeaderOfKeyValue(String id, String secret, Map parameters) {
        long time = System.currentTimeMillis();
        Map header = new HashMap();
        StringBuffer contentSb = new StringBuffer();
        if (parameters != null) {
            parameters.entrySet().stream()
                    .filter(a -> a != null && (!isEmpty(a.getKey()) || !isEmpty((String) a.getValue()))).
                    sorted(Map.Entry.comparingByKey()).forEachOrdered(e -> contentSb.append(e.getKey() + e.getValue()));
        }
        header.put(ID_NAME, id);
        header.put("Timestamp", String.valueOf(time));
        header.put("Clienttype", "" + CLIENT_TYPE);
        header.put("Sign", encryptMD5(id + time + contentSb.toString() + secret));
        return header;

    }

    /**
     * 参数为空情况下获取签名header
     *
     * @return
     */
    public static Map getHeaderOfNoParams(String id, String secret) {
        Map header = new HashMap();
        long time = System.currentTimeMillis();
        header.put(ID_NAME, id);
        header.put("Timestamp", String.valueOf(time));
        header.put("Clienttype", "" + CLIENT_TYPE);
        header.put("Sign", encryptMD5(id + time + secret));
        return header;

    }

    /**
     * 参数是body json形式的情况下获取签名header
     *
     * @param object
     * @return
     */
    public static Map getHeaderOfBodyJson(String id, String secret, Object object) {
        Map header = new HashMap();
        long time = System.currentTimeMillis();
        String params = JSON.toJSONString(object);

        header.put(ID_NAME, id);
        header.put("Timestamp", String.valueOf(time));
        header.put("Clienttype", "" + CLIENT_TYPE);
        header.put("Sign", encryptMD5(id + time + params + secret));
        return header;
    }

    public static String encryptMD5(String str) {
        System.out.println("params: " + str);
        return digest("MD5", str);
    }

    public static String digest(String code, String str) {
        try {
            MessageDigest messageDigest = MessageDigest.getInstance(code);
            messageDigest.reset();
            messageDigest.update(str.getBytes());
            byte[] byteArray = messageDigest.digest();
            StringBuffer md5StrBuff = new StringBuffer();

            for (int i = 0; i < byteArray.length; ++i) {
                if (Integer.toHexString(255 & byteArray[i]).length() == 1) {
                    md5StrBuff.append("0").append(Integer.toHexString(255 & byteArray[i]));
                } else {
                    md5StrBuff.append(Integer.toHexString(255 & byteArray[i]));
                }
            }

            return md5StrBuff.toString();
        } catch (NoSuchAlgorithmException var6) {
            var6.printStackTrace();
            return null;
        }
    }
}

5市场行情类接口

注意,市场行情类接口的域名和前面几部分HTTP接口不同,不需要签名,header不需要传签名的几个参数。一个IP一分钟内最多只能访问1000次这部分接口,请注意频率控制。

5.1 所有市场24H市场行情

这个数据服务端更新速度为10秒一次,不必太过频繁获取
path:https://kline.xt.com/api/data/v1/tickers
请求方式:get
请求报文

isUseMarketName=true          //必传,选择true则返回的结果中用BTC_USDT这样的市场名替代掉marketId,false则使用marketId

返回报文分两种格式
isUseMarketName为fasle时格式如下

{
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    },
    "datas": [
        [
            99,
            "0.0",
            "0",
            "0",
            "0",
            "0.0",
            "[]",
            "9.396",
            "9.08",
            "21469873.428"
        ],
        [
            90,
            "8249994.968",
            "8257720.9458",
            "8207608.58",
            "1080294.9779",
            "0.51",
            "[[1, 8219706.597], [2, 8249994.998]]",
            "7418805.42381067",
            "7418805.425",
            "21469873.428"
        ]
    ]
}

isUseMarketName为true时格式如下

{
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    },
    "datas": {
        "ETC_USDT": [
            99,
            "0.0",
            "0",
            "0",
            "0",
            "0.0",
            "[]",
            "9.296",
            "9.708",
            "21469873.428"
        ],
        "BTC_KRW": [
            90,
            "8245004.195",
            "8257720.93",
            "8207608.57",
            "1187226.0187",
            "0.45",
            "[[1, 8219706.597], [2, 8245004.125]]",
            "7418805.413",
            "7418805.47",
            "21469873.408"
        ]
    }
}

数据说明

[ 市场ID, 最新成交价, 最高价,最低价, 24小时成交量,24小时涨跌幅, 最近6H收盘价列表,买一价,卖一价,24小时成交额(单位是买方币种)]

最近6H收盘价列表按时间顺序排序,数据说明:

[[序号, 收盘价], [序号, 收盘价], [序号, 收盘价]]

5.2 单个市场24H市场行情

这个数据服务端更新速度为10秒一次,不必太过频繁获取
path:https://kline.xt.com/api/data/v1/ticker
请求方式:get
请求报文

marketId=90          //市场id,和市场名传一个即可
marketName=ETC_USDT          //市场名,和市场id传一个即可

返回报文格式

{
    "datas": [
        90,
        "8268227.40230003",
        "8268227.40230003",
        "8207608.58629997",
        "1725211.1401",
        "0.73",
        "[[1, 8219706.597], [2, 8266335.7998], [3, 8268227.4023]]",
        "7418805.4126",
        "7418805.4237",
        "21469873.408"
    ],
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

数据说明

[ 市场ID, 最新成交价, 最高价,最低价, 24小时成交量,24小时涨跌幅, 最近6H收盘价列表,买一价,卖一价,24小时成交额(单位是买方币种)]

最近6H收盘价列表按时间顺序排序,数据说明:

[[序号, 收盘价], [序号, 收盘价], [序号, 收盘价]]

5.3 K线

path:https://kline.xt.com/api/data/v1/klines
请求方式:get
请求报文

marketId=90                     //市场id,和市场名传一个即可
marketName=ETC_USDT             //市场名,和市场id传一个即可
type=1M                         //K线类型,支持1M,5M,15M,30M,1H,1D,1W 七种类型,分别代表1-30分钟,1小时,1日,1周
dataSize=5                      //数据量,最多为100

返回报文格式

{
    "datas": [
        [
            "K",
            "90",
            "btc_krw",
            "1532181600",
            "8266335.737",
            "8279949.6898",
            "8266003.6894",
            "8269418.0781",
            "492264.06",
            "0.04",
            "1",
            "1H",
            "false"
        ],
        ..........
    ],
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

数据说明

[数据类型, 市场ID, 市场名字, 时间戳, 开盘数据, 最高价, 最低价, 收盘价, 成交量, 涨跌幅度, 美元汇率, K线周期, 是否经过转换]

5.4 交易记录

path:https://kline.xt.com/api/data/v1/trades
请求方式:get
请求报文

marketId=90                     //市场id,和市场名传一个即可
marketName=ETC_USDT             //市场名,和市场id传一个即可
dataSize=10                     //数据量,最多为20

返回报文格式

{
    "datas": [
        [
            "T",
            "90",
            "1532183063",
            "BTC_KRW",
            "bid",
            "8271173.90",
            "515.50"
        ],
        ..........
    ],
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

数据说明

[数据类型, 市场ID, 币种信息, 时间戳, 买卖类型(asks卖bids买), 价格, 量]

5.5 盘口数据(市场深度)

本接口最多返回买卖50档的盘口数据
path:https://kline.xt.com/api/data/v1/entrusts
请求方式:get
请求报文

marketId=90                     //市场id,和市场名传一个即可
marketName=ETC_USDT             //市场名,和市场id传一个即可

返回报文格式

{
    "datas": {
        "asks": [
            [
                "8247657.898",
                "5.95"
            ],
            [
                "7418805.435",
                "4.88"
            ],
            [
                "7418805.47",
                "0.01"
            ]
        ],
        "bids": [
            [
                "0.81945643",
                "24.32"
            ],
            [
                "0.847",
                "2.064"
            ],
            [
                "0.516",
                "17.043"
            ]
        ],
        "timestamp": "1532183394"
    },
    "resMsg": {
        "code": "1",
        "method": null,
        "message": "success !"
    }
}

数据说明

asks:(卖盘)[[价格, 量]]
bids:(买盘)[[价格, 量]]

6 接口结果外部和错误码

失败时返回报文如下

{
    "datas": null,
    "resMsg": {
        "code": "1000",
        "method": null,
        "message": "param invalid"
    }
}

错误码列表:
配置及基础功能API、获取用户信息接口、交易API、财务资金API

错误码 说明
1000 系统错误
1003 无效的参数
2000 参数错误
2001 委托价格类型为空
2002 委托类型错误
2003 委托价格异常
2004 市场ID不能为空
2012 委托信息不存在或状态异常
2014 缓存中无该该委托单
2015 委托单已取消或数据库中不存在
2016 分页index,pageSize参数有误
2017 交易货币量为空
2019 委托单ID不能为空
2020 委托类型不能为空
2022 交易货币量小于最小值
2999 内部错误
6002 授权失效,需要重新登录
6021 限制提币操作
6076 交易密码错误,请重新输入
6095 用户不存在
6096 无效的参数
6114 提币地址为空!
6124 审核失败!
6126 审核通过
6115 提交提币申请失败!
6125 无效的货币类型!
6130 没有选取币种!
6894 时间过长,API签名已失效!
6895 校验API权限失败,接口不属于授权API!
6896 校验API权限失败,Userid和Apiid不匹配!
6897 校验API权限失败,请确认是否开启Api权限!
6898 多次校验API权限失败,请确认是否开启Api权限!
10012 未知异常!

行情、盘口数据(市场深度)、k线、交易记录四类API的错误码说明

错误码 说明
1000 系统错误
5010 参数错误
5016 数据不存在
5017 该市场不存在
5019 你的IP一分钟内访问次数超过1000次

币种

{
    : "TUR",
    : "EUSDT",
    : "JTT",
    : "BRE",
    : "GRIN",
    : "BEAM",
    : "RISE",
    : "ALGO",
    : "LAMB",
    : "WICC",
    : "AT",
    : "ITC",
    : "LSC",
    : "ELA",
    : "QUN",
    : "HC",
    : "SHE",
    : "GXS",
    : "MAINONT",
    : "ONT",
    : "DUSD",
    : "ESAX",
    : "EGT",
    : "NAS",
    : "GRAM",
    : "UBTC",
    : "ATOM",
    : "LSK",
    : "LEO",
    : "BTT",
    : "LRC",
    : "STORJ",
    : "VOLLAR",
    : "XMR",
    : "KNC",
    : "VSYS",
    : "ELF",
    : "MTL",
    : "RCN",
    : "BTX",
    : "TRX",
    : "ABT",
    : "TRUE",
    : "HT",
    : "ZB",
    : "1ST",
    : "BLINK",
    : "GNT",
    : "SNT",
    : "CHAT",
    : "LBTC",
    : "TUSD",
    : "BAT",
    : "PAX",
    : "KAN",
    : "DGD",
    : "BITCNY",
    : "NEO",
    : "OMG",
    : "MANA",
    : "BTM",
    : "ZRX",
    : "WNT",
    : "XDT",
    : "STAR",
    : "AE",
    : "ZEC",
    : "BSV",
    : "SCC",
    : "FIL",
    : "XTZ",
    : "DCR",
    : "SXC",
    : "SC",
    : "DOGE",
    : "XT",
    : "QTUM",
    : "QC",
    : "XWC",
    : "BTS",
    : "DASH",
    : "XEM",
    : "XLM",
    : "XRP",
    : "EOS",
    : "BCHABC",
    : "ADA",
    : "USDT",
    : "BTC",
    : "ETH",
    : "ETC",
    : "LTC",
    : "BNA"
}

交易对

{
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,
    ,

}

XT交易所API的更多相关文章

  1. XT交易所Websocket API

    WebSocketAPI xt为用户提供了一个简单的而又强大的API,旨在帮助用户快速高效的将xt交易功能整合到自己应用当中. WebSocket服务地址 xt WebSocket服务连接地址:wss ...

  2. DataPipeline丨金融行业如何统一管理单个任务下所有API的同步情况

    目前,依靠"手工人力"的电子表格数据治理模式逐渐被"自动智能"的专业工具取代.数据管理员.业务分析师开始采用"平台工具"来梳理主数据.元数据 ...

  3. 如何统一管理单个任务下所有API的同步情况?

    1. 一分钟完成单个API配置 单个API的配置包含:API名称.URL地址.请求方式.参数设置.自定义高级设置. 参数允许用户填写:Text.WebService.Timestamp.DependO ...

  4. 如何统一管理单个任务下所有API的同步情况?

    如何统一管理单个任务下所有API的同步情况 1. 一分钟完成单个API配置 单个API的配置包含:API名称.URL地址.请求方式.参数设置.自定义高级设置. 参数允许用户填写:Text.WebSer ...

  5. 各大知名区块链交易所链接及API文档链接

    区块链交易所链接 火币网(Huobi):https://www.huobi.br.com/zh-cn/ API文档:https://github.com/huobiapi/API_Docs/wiki ...

  6. Deribit交易所 websocket API 连接范例

    Deribit websocket API 连接范例,使用JavaScript语言,策略运行在FMZ发明者量化平台. 源码地址:https://www.fmz.com/strategy/147765 ...

  7. 我这么玩Web Api(一):帮助页面或用户手册(Microsoft and Swashbuckle Help Page)

    前言 你需要为客户编写Api调用手册?你需要测试你的Api接口?你需要和前端进行接口对接?那么这篇文章应该可以帮到你.本文将介绍创建Web Api 帮助文档页面的两种方式,Microsoft Help ...

  8. 反调试技术常用API,用来对付检测od和自动退出程序

    在调试一些病毒程序的时候,可能会碰到一些反调试技术,也就是说,被调试的程序可以检测到自己是否被调试器附加了,如果探知自己正在被调试,肯定是有人试图反汇编啦之类的方法破解自己.为了了解如何破解反调试技术 ...

  9. openstack API debug OpenstackEveryProject_CLI,curl_based

    1,基于Openstack 每个服务组件client客户端,eg,nova 客户端软件包名称是python-novaclient, 别的都一样,把python-novaclient (nova替换成组 ...

随机推荐

  1. Redis的入门

    什么是NOSQL? NOSQL(Not Only SQL)不仅仅是数据库,是一种全新的理念,泛指非关系型的数据库. 为什么需要NOSQL? 随着互联网的高速崛起,网站的用户群的增加,访问量的上升,传统 ...

  2. ARTS-week8

    Algorithm 给出两个 非空 的链表用来表示两个非负的整数.其中,它们各自的位数是按照 逆序 的方式存储的,并且它们的每个节点只能存储 一位 数字.如果,我们将这两个数相加起来,则会返回一个新的 ...

  3. 葫芦娃团队项目Beta冲刺-总结

    课程名称:软件工程1916|W(福州大学) 作业要求:项目Beta冲刺 团队名称:葫芦娃队 作业目标:总结项目冲刺内容 githup地址:https://https://github.com/Baka ...

  4. 项目Beta冲刺--5/7

    项目Beta冲刺--5/7 作业要求 这个作业属于哪个课程 软件工程1916-W(福州大学) 这个作业要求在哪里 项目Beta冲刺 团队名称 基于云的胜利冲锋队 项目名称 云评:高校学生成绩综合评估及 ...

  5. Spring Boot 中的事务管理

    希望能在发生异常的时候被回退,这时候就可以使用事务让它实现回退,做法非常简单,我们只需要在test函数上添加@Transactional注解即可. 使用@Transactional注解来声明一个函数需 ...

  6. datagrid 溢出文本显示省略号 转载

    http://www.jeasyuicn.com/?sort=3 .datagrid-cell, .datagrid-cell-group, .datagrid-header-rownumber, . ...

  7. python2和python3共存方法

    拿到安装包,安装python3 centos: sudo yum install python36 ubuntu: sudo add-apt-repository ppa:deadsnakes/ppa ...

  8. python基础知识字符串与元祖

    https://blog.csdn.net/hahaha_yan/article/details/78905495 一.字符串的类型 ##表示字符串: 'i like the world' " ...

  9. swift与oc的关系

    swift是对oc的扩展 Swift是没有消息机制的Objective-C https://www.oschina.net/translate/inside-swift: swift保持了oc的类结构 ...

  10. 【城市天气】使用Ajax发送和接受数据

    任务:利用中国天气网的公开接口,实现天气预报的查询功能 实验的功能要求如下: (1)当网页加载时,根据所给的 json 数据解析获得省(直辖市)的信息并显示在下拉列表框中供用户选择: (2)当用户选择 ...