模拟交易功能接口文档

接口文档 模块划分

修订记录

测试账号

测试账号说明

接口调用规范

请求公共参数

5个公共请求参数：_b_、_e_、_t_、_appSign_、_appCrypt_

对于私有接口，_b_、_e_为登录成功之后获取的标识，参数传递到后台会被自动解析成投客userId

_t_ 为标识移动端所用版本信息

_appSign_、_appCrypt_为签名和加密字符串

操作方式

1. 首先将方法的参数(不包括_b_、_e_、_t_)拼成name=zhangsan&password=123&status=1的形式，得到字符串 str
2. 将步骤1中得到的结果字符串str，使用md5签名加密 得到_appSign_
3. 将步骤1中得到的结果字符串str，使用DES签名加密 得到_appCrypt_

api接口请求结果中result值

• 1 表示请求成功，且获取到后端服务返回的json结果
• -1 表示session失效，需要重新登录
• -2 表示服务器异常，技术性的失败，开发人员需要根据message字段排查故障
• -4 表示业务异常，message字段为可展示的错误原因

api登录接口（apiLogin）返回的result值

• 1 表示正常登录，且登录成功
• 0 表示登录失败，且msg字段会标识出具体的失败原因

接口环境

接口文档中URL皆以{site}替换

1> 查询可买卖数量

服务名
simulatedTradingController.queryAvailableNum

明文调用示例

{site}/simulatedTradingController.queryAvailableNum?stockCode=000001&exchange=SZ&price=9

描述
查询用户可买卖的股票数量

参数列表

响应结构

     {
        "data":{
            "buyableNum":311600,
            "vendibleNum":1500
        },
        "message":null,
        "result":1
    }

响应字段

2> 查询账户资产

服务名
simulatedTradingController.queryAccountCapital

明文调用示例

{site}/simulatedTradingController.queryAccountCapital

描述
查询用户模拟账户资产

参数列表

响应结构

{
    "result": "1", 
    "message": "", 
    "data": {
         "totalAssets": '200211717',
        "totalMarketValue": '211840',
        "useAvailable": '199999877',
        "totalProfit": '199999877'
    }
}

响应字段

3> 撤单

服务名
simulatedTradingController.revoke

明文调用示例

{site}/simulatedTradingController.revoke?entrustCode=123

描述
撤单

参数列表

响应结构

{
    "result": "1", 
    "message": "", 
    "data": '853'
}

响应字段

4> 个股持仓

服务名
simulatedTradingController.queryHoldPosition

明文调用示例

{site}/simulatedTradingController.queryHoldPosition?stockCode=000001&exchange=SZ

描述
撤单

参数列表

响应结构

//正常返回
{
    "result": "1", 
    "message": "", 
    "data": {
          "code": "002176",
          "name": "江特电机",
          "exchange": "SZ",
          "amount": 1000,
          "sellAvailable": 0,
          "currentPrice": "13.47",
          "changePercent": "0.45",
          "profit": "340.0",
          "costPrice": "13.13",
          "profitPercent": "2.59",
          "marketValue": "13470.0"
        }
}
//持仓为空时返回
{"message":"","result":"1","data":null}

响应字段

5> 持仓

服务名
simulatedTradingController.queryHoldPositions

明文调用示例

{site}/simulatedTradingController.queryHoldPositions?pageNo=1&pageSize=20

描述
分页查询持仓接口，pageNo当前页，默认等于1，pageSize每页返回的数据数目，默认返回20条数据。

参数列表

响应结构

//正常返回
{
    "result": "1", 
    "message": "", 
    "data": {
      "count": 5,
      "list": [
        {
          "code": "600197",
          "name": "伊力特",
          "exchange": "SH",
          "amount": 200,
          "sellAvailable": 0,
          "currentPrice": "14.00",
          "changePercent": "-1.27",
          "profit": "-12.0",
          "costPrice": "14.06",
          "profitPercent": "-0.43",
          "marketValue": "2800.0",
          "securityType":4
        },
        {
          "code": "600006",
          "name": "东风汽车",
          "exchange": "SH",
          "amount": 200,
          "sellAvailable": 0,
          "currentPrice": "7.66",
          "changePercent": "-1.67",
          "profit": "-32.0",
          "costPrice": "7.82",
          "profitPercent": "-2.05",
          "marketValue": "1532.0",
          "securityType":4
        }
      ],
      "pageNo": 1,
      "pageSize": 2,
      "hasNextPage": true,
      "desc": 0
    }
}
//持仓为空时返回
{"message":"","result":"1","data":null}

响应字段

数据字典