查询资金账户开仓/买入查询委托单查询持仓单取消委托平仓/卖出设置止损获利点查询成交记录查询资金流水查询委托历史

API调用的结果或数据和WEB用户界面一致,先到这里注册,获得对应认证登录信息。http://invest.xxx.com/

.获取apikey和apisecret

如何获取

到web页面http://invest.konpn.com/-》使用帮助-》API接入。设置api访问的key和secret

签名sign的生成

参考范例代码

            请求示例    http://xxx/xxx?apikey={必填参数apikey}&timestamp={必填参数timestamp}&sign={必填参数sign}&参数A={A}&参数B={B}&参数C={C}...

            sign如何生成
                var params = new Dictionary<string, string>

                加入除了sign外所有传递参数
                params.Add(Uri.EscapeDataString("apikey"), Uri.EscapeDataString(apikey值));
                params.Add(Uri.EscapeDataString("timestamp"), Uri.EscapeDataString(当前标准时间戳));
                params.Add(Uri.EscapeDataString("参数A"), Uri.EscapeDataString(A));
                params.Add(Uri.EscapeDataString("参数B"), Uri.EscapeDataString(B));
                ...
            
                params按key升序排序,然后以form形式组成字符串
                StringBuilder sb=new StringBuilder();
                foreach (var para in _params.OrderBy(i => i.Key, StringComparer.Ordinal))
                {
                    sb.Append('&');
                    sb.Append(para.Key).Append('=').Append(para.Value);
                }
                
            制作签名..
                byte[] keyBuffer = Encoding.UTF8.GetBytes(apisecret值);
                HMACSHA256 hmacsha256 = new HMACSHA256(keyBuffer);
                
                byte[] inputBuffer = Encoding.UTF8.GetBytes(sb.SubString(1));
                byte[] hashedBuffer = hmacsha256.ComputeHash(inputBuffer);
                签名值sign=Convert.ToBase64String(hashedBuffer);

                签名值sign填入对应url请求中的{sign},便是完整的请求。

↑回顶部

.查询资金账户

调用演示

http://trade.xxx.com:10003/user/com/querytradeacct?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}

调用协议

地址：http://trade.xxx.com:10003/user/com/querytradeacct

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":"",Obj:{结构}}, 返回 Code>=0 代表成功,否则看Msg。

            {"Code":0,"Msg":"","Obj":
            {
            ,"DOPA":0           //持仓收益
            ,"DOPACNY":0.0      //持仓收益(人民币)
            ,"DOA":0            //持仓市值
            ,"DOACNY":0.0       //持仓市值(人民币)
            ,"DAA":8618.00      //净值
            ,"DAACNY":8618.000  //净值(人民币)
            ,"DPR":-0.0382      //收益率
            ,"DPA":-382.00      //收益
            ,"DPACNY":-382.000  //收益(人民币)
            ,"LA":0.00      //锁定金额
            ,"LACNY":0.000  //锁定金额(人民币)
            ,"HA":0.00      //预付金额
            ,"HACNY":0.000  //预付金额(人民币)
            ,"CP":-0.1382   //净收益率
            ,"BZJR":100     //保证金维持率
            ,"KYBZJ":8618.000   //可用预付款
            ,"JY":8618.00       //结余
            ,"ZC":"CNH"     //账户资金币种
            ,"IT":"CNST"    //账户类型
            ,"OC":0         //持仓单数量
            ,"UID":3        //UserID
            ,"R":0          //排名
            ,"EI":10000.00  //转入资金额
            ,"EO":1000.00   //转出资金额
            ,"PF":-0.0382   //总收益(昨日)
            ,"DPF":0.0000   //日收益(昨日)
            ,"WPF":0.0000   //周收益(昨日)
            ,"MPF":0.0000   //月收益(昨日)
            ,"YPF":0.0000   //年收益(昨日)
            }
            }

↑回顶部

.开仓/买入

调用演示

http://trade.xxx.com:10003/user/com/applyopen?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}&symbol={品种代码}&level={杠杆}&type={交易类型}&vol={委托量}&applyprice={委托价}&tp={获利价}&sl={止损价}&swap=0&eddate=2021-01-12 12:00:00&remark=test

调用协议

地址：http://trade.xxx.com:10003/user/com/applyopen

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

参数：symbol,string,必填,品种/股票代码

参数：level,int,必填,杠杆,0则为市场默认。 1, 5, 10, 20, 50, 100, 200, 500

参数：type,string,必填,类型 Buy,Sell,BuyLimit,SellLimit,BuyStop,SellStop

参数：vol,double,必填,量/股

参数：applyprice,double,必填,委托价格,0为市场价

参数：sl,double,必填,获利点,0为无

参数：tp,double,必填,止损点,0为无

参数：swap,int,必填,滑点,0为无

参数：stdate,string,必填,委托生效时间 yyyy-MM-dd HH:mm:ss,72小时内,可填空""为即时生效

参数：eddate,string,必填,委托失效时间 yyyy-MM-dd HH:mm:ss,至少距离开始时间1小时,可填空""为从生效24小时后

参数：remark,string,必填,备注,可填空""

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":""}, 返回 Code>=0 代表成功,否则看Msg。

{"Code":0,"Msg":"","Obj":21} Obj表示委托编号

↑回顶部

.查询委托单

调用演示

http://trade.xxx.com:10003/user/com/queryapply?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}

调用协议

地址：http://trade.xxx.com:10003/user/com/queryapply

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":"",Obj:[{结构}]}, 返回 Code>=0 代表成功,否则看Msg。

            {"Code":0,"Msg":"","Obj":
            [
            {
            "LID":10782     //委托编号
            ,"IT":"GBDC"    //账户
            ,"UID":6        //UserID
            ,"FS":"BTC"     //合约
            ,"SN":"比特币"     //合约名
            ,"AT":"BalanceBuy" //操作类型
            ,"AP":59800         //委托价格
            ,"AV":0.3           //委托量
            ,"DV":0             //已成交量
            ,"ATL":1617367208   //委托时间戳
            ,"ST":0             //状态-2全撤,-1部分撤,0未处理,1部分成,2全成
            ,"SW":0             //滑点
            ,"RS":""            //备注
            ,"RS2":""           //取消备注
            ,"ETL":1617465600   //结束时间戳
            ,"STL":1617367208   //开始时间戳
            ,"SL":0             //止损点
            ,"TP":0             //赢利点
            ,"OID":5065         //平仓时相关的持仓编号
            ,"LA":0             //锁定金额
            ,"LT":0             //锁定费用
            ,"LF":0             //锁定费用
            ,"PRELA":0          //锁定费用
            ,"ZC":"USD"         //账户币种
            ,"CC":"USD"         //合约币种
            ,"LV":200           //杠杆
            }
            ]
            }

↑回顶部

.查询持仓单

调用演示

http://trade.xxx.com:10003/user/com/queryorder?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}

调用协议

地址：http://trade.xxx.com:10003/user/com/queryorder

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":"",Obj:[{结构}]}, 返回 Code>=0 代表成功,否则看Msg。

            {"Code":0,"Msg":"","Obj":
            [
            {
            "OID":5065      //持仓编号
            ,"IT":"GBDC     //账户类型
            ,"UID":6        //UserID
            ,"FS":"BTC"     //合约代码
            ,"SN":"比特币"  //合约名称
            ,"OT":"Buy"     //类型
            ,"AVP":59397.000000//成本均价
            ,"VT0":0        //今买量
            ,"HA":89.10     //预付金
            ,"CC":"USD"     //合约币种
            ,"SL":0.000000  //止损点
            ,"TP":0.000000  //获利点
            ,"SW":0         //滑点
            ,"ZC":"USD"     //账户币种
            ,"LV":200       //杠杆
            ,"LOV":0.30     //锁定量
            ,"VA":0.30      //持仓量
            ,"VV":0.00      //可用量
            ,"CP":59459.7   //当前平仓价格
            ,"CPTL":1617367332//当前价格时间戳
            ,"CPA":18.81      //持仓收益
            ,"CA":17837.910   //持仓市值
            }
            ]
            }

↑回顶部

.取消委托

调用演示

http://trade.xxx.com:10003/user/com/applycancel?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}&applyid=0

调用协议

地址：http://trade.xxx.com:10003/user/com/applycancel

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

参数：applyid,int,必填,委托单号

参数：remark,string,必填,备注,可填空""

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":""}, 返回 Code>=0 代表成功,否则看Msg。

↑回顶部

.平仓/卖出

调用演示

http://trade.xxx.com:10003/user/com/applybalance?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}&orderid=0&price={委托价格}&vol={委托量}&swap=0

调用协议

地址：http://trade.xxx.com:10003/user/com/applybalance

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

参数：orderid,int,必填,委托单号

参数：price,double,必填,委托价格,0为市场价

参数：vol,double,必填,量/股

参数：swap,int,必填,滑点,0为无

参数：stdate,string,必填,委托生效时间 yyyy-MM-dd HH:mm:ss,72小时内,可填空""为即时生效

参数：eddate,string,必填,委托失效时间 yyyy-MM-dd HH:mm:ss,至少距离开始时间1小时,可填空""为从生效24小时后

参数：remark,string,必填,备注,可填空""

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":""}, 返回 Code>=0 代表成功,否则看Msg。

↑回顶部

.设置止损获利点

调用演示

http://trade.xxx.com:10003/user/com/settpsl?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}&orderid=0&tp={获利点}&sl={止损点}&swap=0

调用协议

地址：http://trade.xxx.com:10003/user/com/settpsl

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

参数：orderid,int,必填,持仓单编号

参数：sl,double,必填,获利点,0为无

参数：tp,double,必填,止损点,0为无

参数：swap,int,必填,滑点,0为无

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":""}, 返回 Code>=0 代表成功,否则看Msg。

↑回顶部

.查询交易记录

调用演示

http://trade.xxx.com:10003/user/com/querydeal?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}&pidx=1

调用协议

地址：http://trade.xxx.com:10003/user/com/querydeal

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

参数：pidx,int,必填,页码,每页20

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":"",Obj:[{结构}]}, 返回 Code>=0 代表成功,否则看Msg。

            {"Code":1,"Msg":"","Obj":
            [
            {
            "LID":45072     //记录编号
            ,"IT":"GBDC"    //账户
            ,"UID":6        //UserID
            ,"OID":5065     //订单编号
            ,"FS":"BTC"     //合约编码
            ,"SN":"比特币"     //合约名称
            ,"ATL":1617367143  //委托时间戳
            ,"DTL":1617367147  //成交时间戳
            ,"AT":"Buy"     //成交类型
            ,"V":0.30       //成交量
            ,"AID":10781    //相关委托编码
            ,"RS":""        //备注
            ,"AP":59400.000000  //委托价格
            ,"AVP":59397.000000 //成交均价
            ,"P":59397.000000   //成交价格
            ,"LA":89.10         //锁定金额
            ,"PA":0.00          //收益
            ,"LT":0       //记录类型-2强制,-1止损,0人工,1获利,2管理员,3系统
            ,"T":0.00           //税
            ,"F":195.12         //费用
            ,"PTL":1617367147   //成交价格时间戳
            ,"CC":"USD"         //合约币种
            ,"ZC":"USD"         //账户币种
            ,"LV":200           //杠杆
            }
            ]
            }

↑回顶部

.查询资金流水

调用演示

http://trade.xxx.com:10003/user/com/querycashlog?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}&pidx=1

调用协议

地址：http://trade.xxx.com:10003/user/com/querycashlog

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

参数：pidx,int,必填,页码,每页20

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":"",Obj:[{结构}]}, 返回 Code>=0 代表成功,否则看Msg。

            {"Code":3,"Msg":"","Obj":
            [
            {
            "LID":220275    //记录编号
            ,"UID":6        //UserID
            ,"IT":"GBDC"    //账户
            ,"ZC":"USD"     //账户币种
            ,"RS":"(200倍杠杆)买入 0.30单位比特币(BTC)" //描述
            ,"FS":"BTC"     //合约编码
            ,"AA":-89.10    //操作额
            ,"EA":730.32    //结果额
            ,"TA":0.00      //税
            ,"FA":195.12    //费
            ,"LTL":1617367147 //记录时间戳
            }
            ]
            }

↑回顶部

.查询委托历史

调用演示

http://trade.xxx.com:10003/user/com/queryapplylog?apikey={apikey}&timestamp={timestamp}&sign={sign}&rout={账户类型}&pidx=1

调用协议

地址：http://trade.xxx.com:10003/user/com/queryapplylog

协议：HTTP GET

参数：apikey,string,必填,认证信息(urlencode)

参数：timestamp,long,必填,秒时间戳

参数：rout,string,必填,账户类型(CNST 沪深A股,CNFT 国内期货,GBFT 国际期货,GBFSB 外汇合约,GBCFD CFD合约,GBDC 数字货币,USST 美股,HKST 港股,CNETF 沪深ETF)

参数：pidx,int,必填,页码,每页20

输出：json

结构：参考输出结构和错误代码

范例：{"Code":0,"Msg":"",Obj:[{结构}]}, 返回 Code>=0 代表成功,否则看Msg。

            {"Code":2,"Msg":"","Obj":
            [
            {
            "LID":10782     //记录编号
            ,"IT":"GBDC"    //账户
            ,"UID":6        //UserID
            ,"FS":"BTC"     //合约编码
            ,"SN":"比特币"  //合约名称
            ,"AT":"BalanceBuy" //委托类型
            ,"AP":59800.000000  //委托价格
            ,"AV":0.30      //委托量
            ,"DV":0.00      //成交量
            ,"ATL":1617367209   //委托时间戳
            ,"ST":0             //状态-2全撤,-1部分撤,0未处理,1部分成,2全成
            ,"SW":0             //滑点
            ,"RS":""            //备注
            ,"RS2":""           //取消备注
            ,"ETL":1617465600   //结束时间戳
            ,"STL":1617367208   //开始时间戳
            ,"SL":0             //止损点
            ,"TP":0             //赢利点
            ,"OID":5065         //平仓时相关的持仓编号
            ,"LA":0             //锁定金额
            ,"LT":0             //锁定费用
            ,"LF":0             //锁定费用
            ,"PRELA":0          //锁定费用
            ,"ZC":"USD"         //账户币种
            ,"CC":"USD"         //合约币种
            ,"LV":200           //杠杆
            }
            ]
            }

↑回顶部

.命令输出和错误代码

结构

{"Code":0,"Msg":"",....}

说明

Code >= 0,调用成功

Code <0 表示调用失败,并输出错误信息 Msg 失败提示

Code -100~-199 表示参数错误 -200~-299 表示内部错误 -300~-399 表示内部错误 -900~ 表示内部异常

程序化/量化策略-模拟交易接口-Http协议

.获取apikey和apisecret

.查询资金账户

.开仓/买入

.查询委托单

.查询持仓单

.取消委托

.平仓/卖出

.设置止损获利点

.查询交易记录

.查询资金流水

.查询委托历史

.命令输出和错误代码