# 交易OPEN API接口
[toc]
# 版本记录
日期 | 版本号 | 修改说明 |
---|---|---|
2020-05-06 | 1.1 | 1、 添加获取融资股数接口(trade-margin-quantity)2、 查询资产接口(stock-asset)添加marginpurchasePower,mortgageMarketValue,debitBalance,anticipatedInterest,riskStatusCode,riskStatusName,mv,pv,creditAmount字段3、 最大可买、可卖数量接口(trade-quantity)添加cashEnableAmountcashEnableIntAmount,cashPurchasingPowermaxPurchasingPower,fundAccoutType字段 |
2020-05-08 | 1.2 | 1、 查询资产接口(stock-asset)添加追缴保证金字段。2、 添加margin-detail获取客户融资账户详情接口 |
2020-05-09 | 1.3 | 1、新增根据市场查找账户类型接口 |
2020-05-09 | 1.4 | 1、 删除4.2客户资金流水接口2、 添加4.2获取历史记录接口3、 添加4.3客户出金撤销接口 |
2020-05-12 | 1.5 | 1、 4.11 stock-holding添加盈亏字段返回2、 4.12 stock-asset添加盈亏字段返回3、 4.13 stock-asset添加盈亏字段返回 |
2020-05-20 | 1.6 | 1、1.13获取email验证码2、1.14机构用户邮箱验证码登录 |
2020-06-09 | 1.7 | 1、1.15机构用户邮箱激活 |
2020-06-10 | 1.8 | 1、1.16 机构用户邮箱校验2、1.17 机构用户邮箱校验 |
2020-06-24 | 1.9 | 1、新增1.13~1.21机构户登录接口 |
2020-07-01 | 1.10 | 1、添加3.7额度不足时确认现金认购数量接口 |
2020-07-06 | 1.11 | 1、删除机构户登录接口,以单独文档的形式提供 |
2020-08-04 | 1.12 | 1、2.15补充出参,2.1补充下单市场区分,添加IPO新股状态 |
2020-09-21 | 1.13 | 1、2.16添加持仓盈亏 |
2020-10-21 | 1.14 | 1、无 |
2020-10-27 | 1.14 | 1、增加孖展部分获取股票抵押比率接口 |
2021-02-25 | 1.15 | 1、新增资金账号查询融资利率接口 |
2023-07-19 | 1.16 | 1、密码登录、验证码登录接口支持邮箱账号类型(仅限官网申请渠道) |
# 概述
开放平台可以为个人开发者和机构客户提供接口服务,投资者可以充分的利用盈立智投的交易服务、行情服务、账户服务等实现自己的投资应用。
协议:
HTTPS
- X-Sign
使用MD5withRSA加密算法对Body中的内容进行加密,得到的密文经过safeBase64编码后做为X-Sign的值放入header当中,每一个渠道单独分配公私钥。
- 验签测试公钥为:
需双方商定
- 隐私数据加密测试公钥为:
需双方商定
- URLSAFE_BASE64算法在RFC4648中有定义
最终串会使用RSA私钥进行加密,之后使用RFC4648算法编码放入请求体或表单项中。
- 请求头X-Request-Id:
长度为19位数字,必须确保唯一用于做幂等防重,推荐使用分布式Snowflake雪花算法 (opens new window)生成。
- 请求示例:
http header参数示例
Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiNGZjYTA1MWNmZjQwNDI4NzlkNGJiYzYzYjFiYWE0MTgiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozMTgxNDA2MTEwNTc1NTc1MDR9.gw4_AKh6NGUxWXWjzHb8G2An3ao0nSuI
Content-Type: application/json; charset=utf-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 92823918712371
X-Type: 1
X-Channel:1001
x-Sign:用私钥对body内容加密后的内容
- http body参数示例:
{
"entrustAmount": 100,
"entrustPrice": 330.4,
"entrustProp": "e",
"entrustType": 0,
"exchangeType": 0,
"stockCode": "00700",
"stockName": "腾讯控股",
"conId": 100008234979823
}
返回示例:
{
"code": 0,
"data": {
"entrustId": "56765633083899904",
"status": 0,
"statusName": "等待提交"
},
"msg": ""
}
# 1 登录、密码及用户信息
# 1.1渠道密码登录
手机/邮箱+密码+渠道登录:
接口地址 /user-server/open-api/login
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
请求参数说明:
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
areaCode | 区域号86中国,852香港,853中国澳门,886中国台湾,65新加坡。当使用手机号登录时,区号为必填。 | body | false | string |
password | 密码RSA加密(与X-Sign不同秘钥) | body | true | string |
phoneNumber | 手机号/邮箱RSA加密(与X-Sign不同秘钥) | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例:
{
"areaCode": 86,
"password": "rsa",
"phoneNumber": "rsa"
}
- 出参说明:
参数名称 | 说明 | 类型 |
---|---|---|
areaCode | 区号 | string |
avatar | 头像地址 | string |
expiration | 过期时间 | int64 |
extendStatusBit | 用戶扩展状态 | int32 |
firstLogin | 是否为第一次登录 | boolean |
nickname | 昵称 | string |
openedAccount | 是否开户 | boolean |
phoneNumber | 手机号 | string |
thirdBindBit | 绑定位 手机1<<0 微信 1<<1 微博1<<2 | int32 |
token | 登录鉴权的token | string |
tradePassword | 是否设置过交易密码 | boolean |
unionId | 微信公众平台的unionId,如果有则显示。 | string |
uuid | 盈立用户注册的uuid,全局唯一 | int64 |
- 返回示例:
{
"areaCode": 86,
"avatar": "",
"expiration": 0,
"extendStatusBit": "1<<0 登录密码 1<<1 行情权限 1<<2 衍生品",
"firstLogin": true,
"nickname": "xxx",
"openedAccount": true,
"phoneNumber": "188xxxx9188",
"thirdBindBit": 1,
"token": "",
"tradePassword": true,
"unionId": "",
"uuid": 0
}
- 响应状态
状态码 | 说明 |
---|---|
0 | 成功 |
200 | OK |
300100 | 非法请求 |
300102 | 账户被冻结,无法完成操作,如非本人操作,请联系客服 |
300103 | 用户被删除 |
300309 | 请输入正确的手机号码 |
300701 | 该手机号没有注册 |
300702 | 密码错误次数过多帐号已锁定,请%s分钟后重新登录或找回密码 |
300703 | 密码错误,请重新输入,您还可以尝试%s次 |
300705 | 该帐户未设置登录密码,请使用短信验证码登录 |
300809 | 需要校验手机短信验证码 |
# 1.2获取手机/邮箱验证码
接口地址 /user-server/open-api/send-phone-captcha
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
请求参数说明:
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
areaCode | 区域号86中国,852香港,853中国澳门,886中国台湾,65新加坡。当使用手机号登录时,区号为必填。 | body | false | string |
type | 验证码类型 101注册 102重置密码 103更换手机号 104绑定手机号 105新设备登录校验 106短信登录 | body | true | string |
phoneNumber | 手机号/邮箱RSA加密(与X-Sign不同秘钥) | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例:
{
"areaCode": 86,
"type": 102,
"phoneNumber": "rsa"
}
- 出参说明:
参数名称 | 说明 | 类型 |
---|---|---|
areaCode | 区号 | string |
avatar | 头像地址 | string |
expiration | 过期时间 | int64 |
extendStatusBit | 用戶扩展状态 | int32 |
firstLogin | 是否为第一次登录 | boolean |
invitationCode | 邀请码,如果有,则显示。 | string |
languageCn | 1简体2繁体 | int32 |
languageHk | 1简体2繁体 | int32 |
lineColorHk | 1红涨绿跌2绿涨红跌 | int32 |
nickname | 昵称 | string |
openedAccount | 是否开户 | boolean |
phoneNumber | 手机号 | string |
thirdBindBit | 绑定位 手机1<<0 微信 1<<1 微博1<<2 | int32 |
token | 登录鉴权的token | string |
tradePassword | 是否设置过交易密码 | boolean |
unionId | 微信公众平台的unionId,如果有则显示。 | string |
uuid | 盈立用户注册的uuid,全局唯一 | int64 |
- 返回示例:
{
"areaCode": 86,
"avatar": "",
"expiration": 0,
"extendStatusBit": "1<<0 登录密码 1<<1 行情权限 1<<2 衍生品",
"firstLogin": true,
"invitationCode": 1234,
"languageCn": 0,
"languageHk": 0,
"lineColorHk": 0,
"nickname": "xxx",
"openedAccount": true,
"phoneNumber": "188xxxx9188",
"thirdBindBit": 1,
"token": "",
"tradePassword": true,
"unionId": "",
"uuid": 0
}
- 响应状态
状态码 | 说明 |
---|---|
0 | 成功 |
200 | OK |
300100 | 非法请求 |
300102 | 账户被冻结,无法完成操作,如非本人操作,请联系客服 |
300103 | 用户被删除 |
300309 | 请输入正确的手机号码 |
300701 | 该手机号没有注册 |
300702 | 密码错误次数过多帐号已锁定,请%s分钟后重新登录或找回密码 |
300703 | 密码错误,请重新输入,您还可以尝试%s次 |
300705 | 该帐户未设置登录密码,请使用短信验证码登录 |
300809 | 需要校验手机短信验证码 |
# 1.3渠道验证码登录
手机/邮箱+验证码+渠道登录:
接口地址 /user-server/open-api/loginCaptcha
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
请求参数说明:
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
areaCode | 区域号86中国,852香港,853中国澳门,886中国台湾,65新加坡。当使用手机号登录时,区号为必填。 | body | false | string |
captcha | 验证码 | body | true | string |
phoneNumber | 手机号/邮箱RSA加密(与X-Sign不同秘钥) | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例:
{
"areaCode": 86,
"modifyUserConfigParam": {
"languageCn": 1,
"languageHk": 1,
"lineColorHk": 1
},
"captcha": "1234",
"phoneNumber": "rsa"
}
- 出参说明:
参数名称 | 说明 | 类型 |
---|---|---|
areaCode | 区号 | string |
avatar | 头像地址 | string |
expiration | 过期时间 | int64 |
extendStatusBit | 用戶扩展状态 | int32 |
firstLogin | 是否为第一次登录 | boolean |
invitationCode | 邀请码,如果有,则显示。 | string |
languageCn | 1简体2繁体 | int32 |
languageHk | 1简体2繁体 | int32 |
lineColorHk | 1红涨绿跌2绿涨红跌 | int32 |
nickname | 昵称 | string |
openedAccount | 是否开户 | boolean |
phoneNumber | 手机号 | string |
thirdBindBit | 绑定位 手机1<<0 微信 1<<1 微博1<<2 | int32 |
token | 登录鉴权的token | string |
tradePassword | 是否设置过交易密码 | boolean |
unionId | 微信公众平台的unionId,如果有则显示。 | string |
uuid | 盈立用户注册的uuid,全局唯一 | int64 |
- 返回示例:
{
"areaCode": 86,
"avatar": "",
"expiration": 0,
"extendStatusBit": "1<<0 登录密码 1<<1 行情权限 1<<2 衍生品",
"firstLogin": true,
"invitationCode": 1234,
"languageCn": 0,
"languageHk": 0,
"lineColorHk": 0,
"nickname": "xxx",
"openedAccount": true,
"phoneNumber": "188xxxx9188",
"thirdBindBit": 1,
"token": "",
"tradePassword": true,
"unionId": "",
"uuid": 0
}
- 响应状态
状态码 | 说明 |
---|---|
0 | 成功 |
200 | OK |
300100 | 非法请求 |
300102 | 账户被冻结,无法完成操作,如非本人操作,请联系客服 |
300103 | 用户被删除 |
300309 | 请输入正确的手机号码 |
300701 | 该手机号没有注册 |
300702 | 密码错误次数过多帐号已锁定,请%s分钟后重新登录或找回密码 |
300703 | 密码错误,请重新输入,您还可以尝试%s次 |
300705 | 该帐户未设置登录密码,请使用短信验证码登录 |
300809 | 需要校验手机短信验证码 |
# 1.4设置交易密码
接口地址 /user-server/open-api/set-trade-password
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需带登录态token 用户需要完成开户,且未设置过交易密码,否则算非法请求
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言1简体2繁体 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
password | 交易密码 设置、修改、重置交易密码必填,交易密码必须是6位纯数字 RSA加密(与X-Sign不同秘钥) | body | true | string |
oldPassword | 旧交易密码 修改交易密码必填,交易密码必须是6位纯数字 RSA加密(与X-Sign不同秘钥) | body | false | string |
phoneCaptcha | 手机验证码,根据验证码重置交易密码必填 | body | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"oldPassword": "",
"password": "",
"phoneCaptcha": ""
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300101 | 非法TOKEN | |
301001 | 交易密码需为6位纯数字,请重新输入 | |
301003 | 交易密码错误,请重新输入,您还可以尝试%s次 | |
301004 | 交易服務異常 | |
301005 | 账户被冻结,无法完成操作,如非本人操作,请联系客服 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"data": {},
"msg": ""
}
# 1.5校验交易密码
接口地址 /user-server/open-api/check-trade-password
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 权限:需要Token
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息, 19位长度 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
password | 交易密码必须是6位纯数字 RSA加密(与X-Sign不同秘钥) | String | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求示例
/user-server/open-api/check-trade-password?password=123456 RES加密
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300101 | 非法TOKEN | |
301001 | 交易密码需为6位纯数字,请重新输入 | |
301002 | 错误次数过多交易密码已锁定,请%s小时后重新尝试或找回密码 | |
301004 | 交易服務異常 | |
310104 | 交易密码错误 | |
310106 | 未设置交易密码 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"data": {},
"msg": ""
}
# 1.6重置登录密码
接口地址 /user-server/open-api/reset-login-password
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 不需要token
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
areaCode | 区域号86中国,852香港,853中国澳门,886中国台湾,65新加坡 | body | false | string |
password | 新密码RSA加密(与X-Sign不同秘钥) | body | false | string |
phoneCaptcha | 手机验证码 | body | false | string |
phoneNumber | 手机号RSA加密(与X-Sign不同秘钥) | body | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"areaCode": "86",
"password": "rsa",
"phoneCaptcha": "1234",
"phoneNumber": "188********"
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300304 | 验证次数过多,请稍后重试 | |
300305 | 抱歉,验证码已过期,请重新获取 | |
300701 | 该手机号没有注册 | |
300707 | 您当前已通过客户经理完成预注册,请通过短信验证码登录并激活账号。 | |
300800 | 短信验证码不正确,请重新输入 | |
300801 | 密码长度不能小于8位 | |
300802 | 密码长度不能大于24位 | |
300803 | 密码不能为纯数字/字母/符号 | |
300804 | 请设置正确密码,8~24位数字/字母/符号组合 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"data": {},
"msg": ""
}
# 1.7解锁交易
接口地址 /user-server/open-api/trade-login
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要token
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
password | 新密码RSA加密(与X-Sign不同秘钥) | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300304 | 验证次数过多,请稍后重试 | |
300305 | 抱歉,验证码已过期,请重新获取 | |
300701 | 该手机号没有注册 | |
300707 | 您当前已通过客户经理完成预注册,请通过短信验证码登录并激活账号。 | |
300800 | 短信验证码不正确,请重新输入 | |
300801 | 密码长度不能小于8位 | |
300802 | 密码长度不能大于24位 | |
300803 | 密码不能为纯数字/字母/符号 | |
300804 | 请设置正确密码,8~24位数字/字母/符号组合 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"data": ,
"msg": ""
}
# 1.8获取交易解锁状态
接口地址 /user-server/open-api/get-trade-status
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要token
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
password | 新密码RSA加密(与X-Sign不同秘钥) | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300304 | 验证次数过多,请稍后重试 | |
300305 | 抱歉,验证码已过期,请重新获取 | |
300701 | 该手机号没有注册 | |
300707 | 您当前已通过客户经理完成预注册,请通过短信验证码登录并激活账号。 | |
300800 | 短信验证码不正确,请重新输入 | |
300801 | 密码长度不能小于8位 | |
300802 | 密码长度不能大于24位 | |
300803 | 密码不能为纯数字/字母/符号 | |
300804 | 请设置正确密码,8~24位数字/字母/符号组合 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
status | 订单状态,0未解密,1已解锁 | int32 | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"msg": "成功",
"data": {
"status": 0
}
}
# 1.9修改交易密码
接口地址 /user-server/open-api/update-trade-password
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需带登录态token 用户需要完成开户,且未设置过交易密码,否则算非法请求
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言1简体2繁体 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
password | 交易密码 必填,交易密码必须是6位纯数字 RSA加密(与X-Sign不同秘钥) | body | true | string |
oldPassword | 旧交易密码 修改交易密码必填,交易密码必须是6位纯数字 RSA加密(与X-Sign不同秘钥) | body | false | string |
phoneCaptcha | 手机验证码,根据验证码重置交易密码必填 | body | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"oldPassword": "",
"password": "",
"phoneCaptcha": ""
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300101 | 非法TOKEN | |
301001 | 交易密码需为6位纯数字,请重新输入 | |
301003 | 交易密码错误,请重新输入,您还可以尝试%s次 | |
301004 | 交易服務異常 | |
301005 | 账户被冻结,无法完成操作,如非本人操作,请联系客服 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"data": {},
"msg": ""
}
# 1.10重置交易密码
接口地址 /user-server/open-api/reset-trade-password
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需带登录态token 用户需要完成开户,且未设置过交易密码,否则算非法请求
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言1简体2繁体 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
password | 交易密码 必填,交易密码必须是6位纯数字 RSA加密(与X-Sign不同秘钥) | body | true | string |
oldPassword | 旧交易密码 非必填,交易密码必须是6位纯数字 RSA加密(与X-Sign不同秘钥) | body | false | string |
phoneCaptcha | 手机验证码,根据验证码重置交易密码必填 | body | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"oldPassword": "",
"password": "",
"phoneCaptcha": ""
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300101 | 非法TOKEN | |
301001 | 交易密码需为6位纯数字,请重新输入 | |
301003 | 交易密码错误,请重新输入,您还可以尝试%s次 | |
301004 | 交易服務異常 | |
301005 | 账户被冻结,无法完成操作,如非本人操作,请联系客服 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"data": {},
"msg": ""
}
# 1.11修改登录密码
接口地址 /user-server/open-api/update-login-password
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需带登录态token 用户需要已设置登录密码,否则算非法请求
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言1简体2繁体 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
password | 新登录密码 必填RSA加密(与X-Sign不同秘钥) | body | true | string |
oldPassword | 旧登录密码 必填RSA加密(与X-Sign不同秘钥) | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"oldPassword": "",
"password": "",
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300101 | 非法TOKEN | |
300704 | 原登录密码不正确 | |
300804 | 请设置正确密码,8~24位数字/字母/符号组合 | |
300810 | 新密码长度不能小于8位 | |
300811 | 新密码长度不能大于24位 | |
300812 | 新密码不能为纯数字/字母/符号 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"data": {},
"msg": ""
}
# 1.12根据市场查询账户类型
接口地址 /user-server/open-api/get-user-info-with-market-for-stock/v1
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 根据市场获取用户信息
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言1简体2繁体 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
marketType | 市场类型(参考ExchangeType字典) | body | true | integer |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"marketType": 3
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300101 | 非法TOKEN |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 出参说明:
参数名称 | 说明 | 类型 |
---|---|---|
assetProp | 账户类型,具体字典参考下面的AssetProp的值。 | string |
- 响应示例
{
"code": 0,
"msg": "成功",
"data": {
"assetProp": "M"
}
}
# 1.13 根据资金账号查询融资利率
接口地址 /user-server/open-api/get-rate-info-by-fund-account/v1
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 根据市场获取用户信息
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 见概述Authorization说明 | header | true | string |
X-Lang | 语言1简体2繁体 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | 签名 | header | true | string |
fundAccount | 用户的资金账号 | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"fundAccount": "80019641"
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | UserResponseEntity |
300100 | 非法请求 | |
300101 | 非法TOKEN |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 响应码 | int32 | |
data | 响应体 | object | |
msg | 响应内容 | string |
- 出参说明:
参数名称 | 说明 | 类型 |
---|---|---|
hkdRateValue | 港币利率,直接返回百分比;比如6.6,代表6.6% | number |
usdRateValue | 美元利率,同上 | number |
cnyRateValue | 人民币利率,同上 | number |
- 响应示例
{
"code": 0,
"msg": "成功",
"data": {
"hkdRateValue": 6.6,
"usdRateValue": 4.6,
"cnyRateValue": 6.6
}
}
# 2 交易及查询
# 2.1下单
接口地址 /stock-order-server/open-api/entrust-order
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 下单
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Dt | 设备类型(t1-android,t2-ios,t3-其他,t4-Windows,t5-Mac) | header | true | string |
X-Sign | RSA签名 | header | true | string |
serialNo | 流水号,最长19位,确保唯一推荐雪花算法生成 | body | true | int64 |
entrustAmount | 委托数量 | body | true | number |
entrustPrice | 价格(竞价单价格传0) | body | true | number |
entrustProp | 委托属性('0'-美股限价单/暗盘委托limit order,'d'-竞价单,'e'-增强限价单,'g'-竞价限价单) 港股: ('0'-暗盘委托/限价单,'d'-竞价单,'e'-增强限价单,'g'-竞价限价单,'w'-市价单)美股: ('0'-限价单,'w'-市价单)A股: ('0'-限价单) | body | true | string |
entrustType | 委托类别(0-买,1-卖) | body | true | int32 |
exchangeType | 交易类别(0-香港,5-美股,6-沪港通,7-深港通) | body | true | int32 |
stockCode | 股票代码 | body | true | string |
password | 交易密码(RSA公钥加密) | body | false | string |
stockName | 股票名称 | body | false | string |
forceEntrustFlag | 是否强制委托标识,超过9倍24档下单时forceEntrustFlag=true可强制下单,但有可能是废单 | body | false | boolean |
sessionType | 交易阶段标志(0/不传-正常订单交易(默认),1-盘前,2-盘后交易,3-暗盘交易,12-盘前盘后) | body | false | int32 |
orderType | 订单类型:GTC/GTD/DAY(默认DAY当日有效,暂不支持) | body | false | string |
validDate | 有效期(GTD传递订单,格式:yyyy-MM-dd,最多90天,暂不支持) | body | false | string |
exchange | 交易所 默认SMART(SMART,AMEX,ARCA,BATS,BEX,BYX,CBOE,CHX,DRCTEDGE,EDGEA,EDGX,IBKRTS,IEX,ISE,ISLAND,LTSE,MEMX,NYSE,NYSENAT,PEARL,PHLX,PSX) | body | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"serialNo": "2000000000000000018",
"entrustAmount": "1000",
"entrustPrice": "11.0",
"entrustProp": "e",
"entrustType": "0",
"exchangeType": "0",
"stockCode": "00981",
"stockName": "00981",
"forceEntrustFlag": "false",
"sessionType": "0",
"password":"Fpocc_11vTS6mS9YKYby6-v2VNujUx_fnnMaGncHPerLh9mCP_vDIhbeE1GLNDU4arl1euay-hiTmqmlwZlwtCMbw3Law7mx9NgVuwGVX3pXPuwYjcqxhaGZIsATHDSywxd4uZZhTCsrRua-Ug8dgJaPDc5os7-A9sFYxbxhI6I="
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | ResponseVO«EntrustOrderResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found | |
406472 | 订单中不能包含小于1手数量的碎股,请交易1手的整数倍,或通过"碎股单"交易碎股 | |
410200 | 抱歉,订单中不能包含小于1手数量的碎股,请交易1手的整数倍,如需交易碎股请联系客服。 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | EntrustOrderResponse | EntrustOrderResponse |
entrustId | 订单id,可用于查询订单/修改订单/取消订单 | string | |
status | 订单状态 | int32 | |
statusName | 订单状态名称 | string | |
·msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"entrustId": "1181776863632019456",
"status": 1,
"statusName": "等待提交"
}
}
# 2.2委托改单/撤单
接口地址 /stock-order-server/open-api/modify-order
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 委托改单/撤单
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Sign | RSA签名 | header | true | string |
actionType | 操作类型(0-撤单,1-改单) | body | true | int32 |
entrustAmount | 委托数量,撤单时传0 | body | true | number |
entrustId | 委托Id | body | true | int64 |
entrustPrice | 委托价格,撤单时传0 | body | true | number |
password | 交易密码(RSA公钥加密) | body | false | string |
forceEntrustFlag | 是否强制委托标识,超过9倍24档下单时forceEntrustFlag=true可强制下单,但有可能是废单 | body | false | boolean |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"actionType": 1,
"entrustAmount": 500,
"entrustId": 1181776863632019456,
"entrustPrice": 322.0,
"forceEntrustFlag": true
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | |
200 | OK | Object |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found | |
406472 | 订单中不能包含小于1手数量的碎股,请交易1手的整数倍,或通过"碎股单"交易碎股 | |
410200 | 抱歉,订单中不能包含小于1手数量的碎股,请交易1手的整数倍,如需交易碎股请联系客服。 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | Object | |
entrustId | 申请编号 | string | |
status | 状态 | int32 | |
statusName | 状态名 | string | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"entrustId": "1181776863632019456",
"status": 5,
"statusName": "等待改单"
}
}
# 2.3改单范围
接口地址 /stock-order-server/open-api/modified-range
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 改单展示范围
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
entrustId | 委托Id | body | true | int64 |
newPrice | 最新价-竞价单也需要传最新价 | body | true | number |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求示例
{
"entrustId": 1181776863632019456,
"newPrice": 323
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«QueryEntrustInfoResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | QueryEntrustInfoResponse | QueryEntrustInfoResponse |
businessAmount | 成交数量 | number | |
entrustAmount | 原订单数量 | number | |
modifiedUpperAmount | 可修改范围的修改上限 | number | |
modifiedlowerAmount | 可修改范围的修改下限 | number | |
cashEnableAmount | 现金最大可买 | number | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"data": {
"businessAmount": 0,
"entrustAmount": 0,
"modifiedUpperAmount": 0,
"modifiedlowerAmount": 0
},
"msg": ""
}
# 2.4碎股下单
接口地址 /stock-order-server/open-api/odd-entrust
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 碎股交易
请求示例
{
"entrustAmount": 1,
"entrustPrice": 82.1,
"entrustType": 1,
"exchangeType": 0,
"stockCode": "00002"
}
- 请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Dt | 设备类型(t1-android,t2-ios,t3-其他,t4-Windows,t5-Mac) | header | true | string |
X-Sign | RSA签名 | header | true | string |
entrustAmount | 委托数量 | body | true | number |
entrustPrice | 价格 | body | true | number |
entrustType | 委托类别(1-卖) | body | true | int32 |
exchangeType | 交易类别(0-香港,5-美股) | body | true | int32 |
stockCode | 股票代码 | body | true | string |
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 |
---|---|---|
code | 状态码 | int32 |
data | 返回体 | |
oddId | 碎股请求记录id | string |
status | 订单状态 | int32 |
statusName | 订单状态名称 | string |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"oddId": "1207553433704988672",
"status": 0,
"statusName": "待报单"
}
}
# 2.5碎股撤单
接口地址 /stock-order-server/open-api/odd-modify
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 碎股交易
请求示例
{
"actionType": 0,
"oddId": 1207553433704988672
}
- 请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Sign | RSA签名 | header | true | string |
actionType | 操作类型(0-撤单) | body | true | int32 |
oddId | 碎股委托Id | body | true | int64 |
- 响应状态
状态码 | 说明 |
---|---|
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 |
---|---|---|
code | 状态码 | int32 |
oddId | 碎股请求记录id | string |
status | 订单状态 | int32 |
statusName | 订单状态名称 | string |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"oddId": "1207553433704988672",
"status": 9,
"statusName": "已撤单"
}
}
# 2.6最大可买、可卖数量
接口地址 /stock-order-server/open-api/trade-quantity
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 获取最大可用数量
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
entrustPrice | 委托价格(不能为0,竞价单可不填) | body | false | number |
entrustProp | 委托属性('0'-美股限价单,'d'-竞价单,'e' -增强限价单,'g'-竞价限价单,'u'-碎股单) | body | true | string |
exchangeType | 交易类别(0-香港,5-美股,6-沪港通,7-深港通) | body | true | int32 |
stockCode | 证券代码 | body | true | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"entrustPrice": 234,
"entrustProp": "e",
"exchangeType": 0,
"stockCode": "700"
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«SaleAndBuyQuantityResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | SaleAndBuyQuantityResponse | SaleAndBuyQuantityResponse |
buyEnableAmount | 最大可买数量(融资可买) | number | |
oddEnableAmount | 最大可卖碎股数量 | number | |
saleEnableAmount | 最大可卖数量(现金) | number | |
saleEnableIntAmount | 最大可卖整股数量 | number | |
handAmount | 每手股数 | number | |
cashEnableAmount | 现金可买数量-包含碎股:查可买返回 | number | |
cashEnableIntAmount | 现金可买整手数量:查可买返回 | number | |
cashPurchasingPower | 现金购买力,查可买返回 | number | |
maxPurchasingPower | 融资购买力,margin账户&&查可买返回 | number | |
fundAccoutType | 资金账号类型(0-现金账号,M-融资账号) | string | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"saleEnableAmount": 500.00,
"saleEnableIntAmount": 500.0000,
"oddEnableAmount": 0.0000,
"buyEnableAmount": 800.00,
"handAmount": 100.0000
}
}
# 2.7今日订单-分页查询
接口地址 /stock-order-server/open-api/today-entrust
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要资金账号
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
exchangeType | 交易类别(0-香港,5-美股, 67-A股,100-查询所有交易类别) | body | true | int32 |
pageNum | 当前页 1开始,默认值1 | body | false | int32 |
pageSize | 每页结果数,默认值10 | body | false | int32 |
stockCode | 证券代码 | body | false | string |
stockName | 证券名称 | body | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"exchangeType": 0,
"pageNum": 1,
"pageSize": 10,
"stockCode": "",
"stockName": ""
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«PageInfoVO«TodayEntrustByAppResponse»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | PageInfoVO«TodayEntrustByAppResponse» | PageInfoVO«TodayEntrustByAppResponse» |
list | 结果集合 | array | TodayEntrustByAppResponse |
businessAmount | 成交数量 | number | |
businessAveragePrice | 成交均价 | number | |
serialNo | 流水号 | int64 | |
createTime | 委托时间 | string | |
entrustAmount | 委托数量 | number | |
entrustId | 委托id | string | |
entrustNo | 委托编号 | string | |
entrustPrice | 委托价格 | number | |
entrustProp | 委托属性('0'-美股限价单,'d'-竞价单,'e' -增强限价单,'g'-竞价限价单,'h'-港股限价单,'j'-特殊限价单) | string | |
entrustType | 买卖方向,委托类型(0-买,1-卖) | int32 | |
exchangeType | 交易类别,0港股,5美股 | int32 | |
flag | 订单类型-普通单0-条件单1-碎股单2-月供股单 | string | |
moneyType | 币种类别 | int32 | |
sessionType | 交易阶段标志(0/不传-正常订单交易(默认),1-盘前,2-盘后交易,3-暗盘交易) | int32 | |
status | 委托状态 | int32 | |
statusName | 委托状态名 | string | |
stockCode | 股票代码 | string | |
stockName | 股票简体名称 | string | |
pageNum | 当前页 | int32 | |
pageSize | 每页条数 | int32 | |
total | 总数 | int64 | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 0,
"total": 1,
"list": [{
"entrustId": "1181776863632019456",
"entrustNo": "191",
"status": 5,
"statusName": "等待改单",
"exchangeType": 0,
"entrustType": 0,
"entrustProp": "e",
"entrustAmount": 700,
"businessAmount": 0,
"entrustPrice": 210,
"businessAveragePrice": 0,
"stockCode": "00700",
"stockName": "腾讯控股",
"moneyType": 2,
"createTime": "11:42:15",
"flag": "0",
"serialNo": 1233123554314,
"sessionType": 0
}]
}
}
# 2.8全部订单-分页查询
接口地址 /stock-order-server/open-api/his-entrust
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要资金账号
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
dateFlag | 1:一周订单,2:一个月订单,3: 三个月订单,4:近一年订单,5:今年订单,6:自选时间,7.查询全部 | body | true | string |
exchangeType | 交易类别(0-香港,5-美股, 67-A股,100-查询所有交易类别) | body | true | int32 |
entrustBeginDate | 开始时间,如果不传时间默认从最新前一天倒序,规则yyyy-MM-dd | body | false | string |
entrustEndDate | 结束时间,如果不传时间默认从最新前一天倒序,规则yyyy-MM-dd | body | false | string |
pageNum | 当前页 1开始,默认值1 | body | false | int32 |
pageSize | 每页结果数,默认值10 | body | false | int32 |
stockCode | 证券代码 | body | false | string |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"dateFlag": "1",
"entrustBeginDate": "",
"entrustEndDate": "",
"exchangeType": 0,
"pageNum": 1,
"pageSize": 10,
"stockCode": ""
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«PageInfoVO«HisEntrustByAppResponse»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | PageInfoVO«HisEntrustByAppResponse» | PageInfoVO«HisEntrustByAppResponse» |
list | 结果集合 | array | HisEntrustByAppResponse |
businessAmount | 成交数量 | number | |
businessAveragePrice | 成交均价 | number | |
serialNo | 流水号 | int64 | |
createDate | 委托日期 | string | |
createTime | 委托时间 | string | |
dayEnd | 是否隔天,0未隔天,1已经隔天 | int32 | |
entrustAmount | 委托数量 | number | |
entrustId | 委托ID | string | |
entrustNo | 委托编号 | string | |
entrustPrice | 委托价格 | number | |
entrustProp | 委托属性('0'-美股限价单,'d'-竞价单,'e' -增强限价单,'g'-竞价限价单,'h'-港股限价单,'j'-特殊限价单) | string | |
entrustType | 买卖方向,委托类型(0-买,1-卖) | int32 | |
exchangeType | 交易类别,0港股,5美股 | int32 | |
flag | 订单类型-普通单1-条件单2-碎股单3-月供股单4 | string | |
moneyType | 币种类别 | int32 | |
sessionType | 交易阶段标志(0/不传-正常订单交易(默认),1-盘前,2-盘后交易,3-暗盘交易) | int32 | |
status | 委托状态 | int32 | |
statusName | 委托状态名 | string | |
stockCode | 股票代码 | string | |
stockName | 股票简体名称 | string | |
pageNum | 当前页 | int32 | |
pageSize | 每页条数 | int32 | |
total | 总数 | int64 | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 20,
"total": 2,
"list": [{
"entrustId": "1181776863632019456",
"entrustNo": "191",
"status": 5,
"statusName": "等待改单",
"exchangeType": 0,
"entrustType": 0,
"entrustProp": "e",
"entrustAmount": 700,
"businessAmount": 0,
"entrustPrice": 210,
"businessAveragePrice": 0,
"stockCode": "00700",
"stockName": "腾讯控股",
"moneyType": 2,
"createTime": "11:42:15",
"createDate": "20191009",
"flag": "0",
"serialNo": 1233123554314,
"sessionType": 0
}
],
"nowDate": "20191009"
}
}
# 2.9查询订单明细
接口地址 /stock-order-server/open-api/order-detail
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 查询订单明细
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
appEntrustRecordDetailRequest | appEntrustRecordDetailRequest | body | true | AppEntrustRecordDetailRequest |
serialNo | 流水号(委托ID、流水号一个至少传一个) | body | true | int64 |
entrustId | 委托id(委托ID、流水号一个至少传一个) | body | true | int64 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求示例
{
"serialNo": 0,
"entrustId": 0
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«AppEntrustRecordDetailResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | AppEntrustRecordDetailResponse | AppEntrustRecordDetailResponse |
appEntrustRecordDetailInfoList | list信息 | array | AppEntrustRecordDetailInfo |
businessAmount | 成交数量 | number | |
businessAveragePrice | 成交均价 | number | |
businessBalance | 成交金额 | number | |
commissionFee | 港美,佣金 | string | |
createTime | 时间 | string | |
depositStockDay | 股份到账时间 | string | |
entrustId | 委托记录号 | int64 | |
entrustAmount | 委托数量 | number | |
entrustBalance | 委托金额 | number | |
entrustFee | 总费用 | string | |
entrustPrice | 委托价格 | number | |
entrustProp | 委托属性('0'-美股限价单,'d'-竞价单,'e' -增强限价单,'g'-竞价限价单,'h'-港股限价单,'j'-特殊限价单) | string | |
entrustPropName | 委托属性('0'-美股限价单,'d'-竞价单,'e' -增强限价单,'g'-竞价限价单,'h'-港股限价单,'j'-特殊限价单) | string | |
moneyType | 币种类别 | int32 | |
orderStatus | 状态 | int32 | |
orderStatusName | 状态名 | string | |
payFee | 港美,交收费 | string | |
platformUseFee | 港美,平台使用费 | string | |
stampDutyFee | 港,印花税 | string | |
tradingSystemUsage | 港,交易系统使用费 | string | |
transactionFee | 港:交易费,美:证监会规费 | string | |
transactionLevyFee | 港,交易征费,美:交易活动费 | string | |
frcTransactionLevyFee | 港,财汇局交易征费 (2022.1.1起征) | string | |
document | 文案信息 | string | |
entrustType | 买入卖出 | int32 | |
exchangeType | 市场类型 | int32 | |
sessionType | 交易阶段标志(0/不传-正常订单交易(默认),1-盘前,2-盘后交易,3-暗盘交易) | int32 | |
status | 委托状态 | int32 | |
statusName | 委托状态名 | string | |
stockCode | 股票代码 | string | |
stockName | 股票名称 | string | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"statusName": "全部成交",
"status": 0,
"stockCode": "00700",
"stockName": "腾讯控股",
"document": "由于和交易所清算交收,部分数据可能在交易完成的第2天(工作日)展示",
"appEntrustRecordDetailInfoList": [{
"entrustProp": "e",
"entrustPropName": "增强限价单",
"entrustAmount": 700,
"businessAmount": 700,
"entrustPrice": 210,
"entrustBalance": 147000,
"businessAveragePrice": 322,
"businessBalance": 225400,
"moneyType": 2,
"createTime": "2019-10-09 11:42:15",
"depositStockDay": null,
"commissionFee": null,
"platformUseFee": null,
"stampDutyFee": null,
"payFee": null,
"transactionFee": null,
"transactionLevyFee": null,
"tradingSystemUsage": null,
"entrustFee": null,
"orderStatus": 11,
"orderStatusName": "委托下单"
},
{
"entrustProp": "e",
"entrustPropName": "增强限价单",
"entrustAmount": 700,
"businessAmount": 700,
"entrustPrice": 322,
"entrustBalance": 225400,
"businessAveragePrice": 322,
"businessBalance": 225400,
"moneyType": 2,
"createTime": "2019-10-09 14:58:03",
"depositStockDay": null,
"commissionFee": null,
"platformUseFee": null,
"stampDutyFee": null,
"payFee": null,
"transactionFee": null,
"transactionLevyFee": null,
"tradingSystemUsage": null,
"entrustFee": null,
"orderStatus": 21,
"orderStatusName": "改单(最新订单)"
},
{
"entrustProp": "e",
"entrustPropName": "增强限价单",
"entrustAmount": 700,
"businessAmount": 700,
"entrustPrice": 322,
"entrustBalance": 225400,
"businessAveragePrice": 322,
"businessBalance": 225400,
"moneyType": 2,
"createTime": "2019-10-09 15:00:30",
"depositStockDay": null,
"commissionFee": null,
"platformUseFee": null,
"stampDutyFee": null,
"payFee": null,
"transactionFee": null,
"transactionLevyFee": null,
"tradingSystemUsage": null,
"entrustFee": null,
"orderStatus": 0,
"orderStatusName": "全部成交(订单结束)"
}
],
"entrustType": 0,
"exchangeType": 0,
"finalStateFlag": "1",
"sessionType": 0,
"entrustId": 1181776863632019500
}
}
# 2.10查询成交流水-分页查询
接口地址 /stock-order-server/open-api/stock-record
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要资金账号
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
exchangeType | 交易类别(0-香港,5-美股, 67-A股,100-查询所有交易类别) | body | true | int32 |
stockCode | 股票代码 | body | false | string |
entrustId | 委托ID | body | false | int64 |
beginTime | 成交开始时间,规则yyyy-MM-dd | body | false | string |
endTime | 成交结束时间,规则yyyy-MM-dd | body | false | string |
pageNum | 当前页 1开始,默认值1 | body | false | int32 |
pageSize | 每页结果数,默认值10 | body | false | int32 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求示例
{
"beginTime": "2019-10-01",
"endTime": "2019-10-10",
"entrustId": 0,
"exchangeType": 0,
"pageNum": 1,
"pageSize": 10,
"stockCode": "700"
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«PageInfoVO«StockRecordResponse»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | PageInfoVO«StockRecordResponse» | PageInfoVO«StockRecordResponse» |
list | 结果集合 | array | StockRecordResponse |
businessAmount | 成交数量 | number | |
businessBalance | 成交金额 | number | |
businessPrice | 成交价格 | number | |
businessStatus | 成交状态(1成交成功,2成交取消) | int32 | |
businessTime | 成交时间 | date-time | |
createTime | 记录创建时间 | date-time | |
entrustId | 委托记录号 | int64 | |
entrustType | 委托类型(''0''-买,1-卖,''2''-查询,''3'-撤单,''4'-补单,''5''-改单,6转入,7转出,8成交取消类型) | int32 | |
exchangeType | 交易类别('0'-香港,'1'-上海A,'2'-上海B,'3'-深圳A,'4'-深证B,'5'-美股,'6'-沪股通,'7'-深港通) | int32 | |
id | int64 | ||
moneyType | 币种类型(0-人民币,1-美元,2-港币) | int32 | |
recordId | 成交流水编号 | int64 | |
remark | 备注 | string | |
stockCode | 股票代码 | string | |
stockName | 股票名称 | string | |
updateTime | 记录最后更新时间 | date-time | |
userId | 用户id | int64 | |
pageNum | 当前页 | int32 | |
pageSize | 每页条数 | int32 | |
total | 总数 | int64 | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 10,
"total": 133,
"list": [{
"id": 18405,
"recordId": 1139100093871222800,
"entrustId": 1139096696801153000,
"userId": 336547695646785540,
"moneyType": 2,
"exchangeType": 0,
"stockCode": "700",
"stockName": "腾讯控股",
"businessStatus": 1,
"businessPrice": 334.2,
"businessAmount": 10,
"businessTime": "2019-06-14T09:12:49.000+0000",
"createTime": "2019-06-13T09:20:00.000+0000",
"updateTime": "2019-06-13T09:20:00.000+0000",
"remark": null,
"entrustType": 0,
"businessBalance": 3342
}]
}
}
# 2.11查询持仓
接口地址 /stock-order-server/open-api/stock-holding
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要资金账号
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 | |
---|---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string | |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string | |
X-Channel | 渠道 | header | true | string | |
X-Time | 时间戳 | header | true | string | |
X-Sign | RSA签名 | header | true | string | |
exchangeType | 交易类别(0-香港,5-美股, 67-A股,100-查询所有交易类别) | body | true | int32 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 查询- 请求body示例
{
"exchangeType": 0
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«List«StockHolding»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | array | StockHolding |
costPriceAccurate | 成本价--精确 | string | |
currentAmount | 持仓数量 | string | |
enableAmount | 可卖数量 | string | |
frozenAmount | 冻结数量 | string | |
exchangeType | 交易类型 | int32 | |
oddAmount | 碎股数量 | string | |
stockCode | 股票代码 | string | |
stockName | 股票名称 | string | |
lastPrice | 最新价 | string | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": [{
"exchangeType": 0,
"stockCode": "19981",
"stockName": "国药麦银零四沽A",
"currentAmount": "157.000000",
"oddAmount": "157.000000",
"lastPrice": "0.320000",
"costPriceAccurate": "0.303000000"
}]
}
# 2.12查询资产
接口地址 /stock-order-server/open-api/stock-asset
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要资金账号
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
exchangeType | 交易类别(0-香港,5-美股,67-A股) | body | true | int32 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"exchangeType": 0
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«StockAssetDTO» |
201 | Created | |
401 | Unauthorized | + |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | StockAssetDTO | StockAssetDTO |
asset | 总资产 | string | |
enableBalance | 可用金额 | string | |
frozenBalance | 冻结金额 | string | |
onWayBalance | 在途资金 | string | |
purchasePower | 购买力 | string | |
mortgageMarketValue | 抵押市值 | string | |
totalDailyBalance | 今日盈亏金额 | string | |
totalDailyBalancePercent | 今日盈亏占比 | string | |
totalHoldingBalance | 持仓盈亏金额 | string | |
totalHoldingBalancePercent | 持仓盈亏占比 | string | |
debitBalance | 负债金额 | string | |
anticipatedInterest | 预计利息 | string | |
riskStatusCode | 风控状态CODE风险状态 1、安全 2、预警 3、危险 4、强平 | string | |
riskStatusName | 风控状态名称mv状态 1、安全 2、预警 3、危险 4、强平 | string | |
mv | 风险比例 | string | |
pv | pv | string | |
creditAmount | 信用额度 | string | |
callMarginCall | 追缴保证金 | string | |
stockHoldingList | 持仓列表 | array | StockHolding |
costPriceAccurate | 成本价--精确 | string | |
currentAmount | 持仓数量 | string | |
exchangeType | 交易类型 | int32 | |
oddAmount | 碎股数量 | string | |
stockCode | 股票代码 | string | |
stockName | 股票名称 | string | |
withdrawBalance | 可取金额 | string | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"asset": "96117771.040000",
"marketValue": "3035584.090000",
"enableBalance": "92906473.37",
"withdrawBalance": "92906473.37",
"frozenBalance": "175713.580000",
"onWayBalance": "0.000000",
"stockHoldingList": [{
"exchangeType": 0,
"stockCode": "19981",
"stockName": "国药麦银零四沽A",
"currentAmount": "157.000000",
"oddAmount": "157.000000",
"lastPrice": "0.320000",
"marketValue": "50.240000",
"hisMarketValue": "0.000000",
"costPrice": "0.303",
"costPriceAccurate": "0.303000000",
"dailyBalance": "50.240000",
"dailyBalancePercent": "1.000000",
"holdingBalance": "2.669000",
"holdingBalancePercent": "0.056106",
"quoteType": "1"
}]
}
}
# 2.13客户股票资产查询批量
接口地址 /stock-order-server/open-api/stock-asset-list
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要资金账号
请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"exchangeType": 100
}
- 请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Sign | RSA签名 | header | true | string |
X-Type | APP类别(1-大陆版,2-港版) | header | true | string |
exchangeType | 交易类别,0港股,5美股,67 A股 | body | true | int32 |
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«List«StockAssetDTO»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 |
---|---|---|
code | 状态码 | int32 |
data | 返回体 | array |
asset | 总资产 | string |
enableBalance | 可用金额 | string |
frozenBalance | 冻结金额 | string |
marketValue | 股票市值 | string |
onWayBalance | 在途资金 | string |
stockHoldingList | 持仓列表 | array |
costPrice | 成本价 | string |
costPriceAccurate | 成本价--精确 | string |
currentAmount | 持仓数量 | string |
dailyBalance | 当日盈亏金额 | string |
dailyBalancePercent | 当日盈亏占比 | string |
enableAmount | 可卖数量 | number |
exchangeType | 交易类型 | int32 |
frozenAmount | 冻结数量 | number |
hisMarketValue | 昨日市值 | string |
holdingBalance | 持仓盈亏金额 | string |
holdingBalancePercent | 持仓盈亏占比 | string |
lastPrice | 最新价 | string |
marketValue | 市值 | string |
oddAmount | 碎股数量 | string |
quoteType | 行情权限 0:延时行情1:bmp行情2:level1行情3:level2行情 | string |
stockCode | 股票代码 | string |
stockName | 股票名称 | string |
stockOnWayBalanceDTOList | 在途资金列表 | array |
applyType | 业务类型 IpoApplyTypeEnum | int32 |
applyTypeName | 业务类型 IpoApplyTypeEnum | string |
exchangeType | 市场 | int32 |
moneyType | 币种 | int32 |
onWayBalance | 在途现金 | number |
stockCode | 股票代码 | string |
stockName | 股票名称 | string |
totalDailyBalance | 今日盈亏金额 | string |
totalDailyBalancePercent | 今日盈亏占比 | string |
totalHoldingBalance | 持仓盈亏金额 | string |
totalHoldingBalancePercent | 持仓盈亏占比 | string |
withdrawBalance | 可取金额 | string |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"data": [
{
"asset": "",
"enableBalance": "",
"frozenBalance": "",
"marketValue": "",
"onWayBalance": "",
"stockHoldingList": [
{
"costPrice": "",
"costPriceAccurate": "",
"currentAmount": "",
"dailyBalance": "",
"dailyBalancePercent": "",
"enableAmount": 0,
"exchangeType": 0,
"frozenAmount": 0,
"hisMarketValue": "",
"holdingBalance": "",
"holdingBalancePercent": "",
"lastPrice": "",
"marketValue": "",
"oddAmount": "",
"quoteType": "",
"stockCode": "",
"stockName": ""
}
],
"stockOnWayBalanceDTOList": [
{
"applyType": 0,
"applyTypeName": "",
"exchangeType": 0,
"moneyType": 0,
"onWayBalance": 0,
"stockCode": "",
"stockName": ""
}
],
"totalDailyBalance": "",
"totalDailyBalancePercent": "",
"totalHoldingBalance": "",
"totalHoldingBalancePercent": "",
"withdrawBalance": ""
}
],
"msg": ""
}
# 2.14查询聚合资产信息
接口地址 /aggregation-server/open-api/user-asset-aggregation/v1
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要token
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Request-Id | 头部信息的requestId信息,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Sign | RSA签名 | header | true | string |
exchangeType | 交易类别,0-港股,5-美股,67-A股 | body | true | int32 |
- 请求header示例
Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiOTMyYmFjY2U3MGU3NDgwM2JmNjYxODk0OTM3ZDlkN2QiLCJzb3VyY2UiOiJ3ZWIiLCJ1dWlkIjozNDMwMjExNDU2ODI4NjIwODB9.XiF0eWAmeL-pthTg--5SLObnscJcDYHaJTJZTHAucwQ
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Channel:100082
X-Request-Id: 928239187123721231232
X-Sign:body 使用RSA私钥加密
- 响应状态
状态码 | 说明 | schema |
---|---|---|
0 | 成功 | ResponseVO |
200 | OK | ResponseVO«OpenHoldAsset» |
108008 | user服务不可用 | |
108011 | 用户信息查询接口异常 | |
108027 | stock-order服务不可用 | |
108028 | 调用客户股票资产查询接口异常 | |
108029 | finance-server服务不可用 | |
108030 | 获取当前客户基金持仓列表接口异常 | |
108031 | 获取当前客户债券持仓列表接口异常 |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
Code | 响应码 0-请求成功 | int32 | |
Data | 响应体 | object | OpenHoldAsset |
asset | 总资产 | string | |
bondMarketValue | 债券市值 | string | |
enableBalance | 可用金额 | string | |
frozenBalance | 冻结金额 | string | |
fundMarketValue | 基金市值 | string | |
onWayBalance | 在途资金 | string | |
stockMarketValue | 股票市值 | string | |
withdrawBalance | 可取金额 | string | |
totalHoldingBalance | 持仓盈亏金额 | string | |
msg | 响应内容 | string |
- 响应示例
{
"code": 0,
"msg": "请求成功",
"data": {
"asset": "997457.66",
"stockMarketValue": "88165.000000",
"bondMarketValue": "0.00",
"fundMarketValue": "0.00",
"enableBalance": "908484.60",
"withdrawBalance": "908484.60",
"frozenBalance": "808.060000",
"onWayBalance": "0.00",
"totalHoldingBalance": "-2510.00"
}
}
# 2.15获取融资股数
接口地址 /stock-order-server/open-api/trade-margin-quantity
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 获取融资股数
请求示例
{
"entrustAmount": 1,
"entrustId": 1,
"entrustPrice": 1,
"entrustProp": "",
"entrustType": 1,
"exchangeType": 1,
"stockCode": ""
}
- 请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
entrustAmount | 委托数量 | body | true | number |
entrustProp | 委托属性('0'-美股限价单,'d'-竞价单,'e' -增强限价单,'g'-竞价限价单,'u'-碎股单) | body | true | string |
exchangeType | 交易类别(0-香港,5-美股,6-沪港通,7-深港通) | body | true | int32 |
stockCode | 证券代码 | body | true | string |
entrustId | 委托Id-如果entrystType是改单的话,必填 | body | false | int64 |
entrustPrice | 委托价格(不能为0,竞价单可不填) | body | false | number |
entrustType | 查询委托类别(0-买,5-改单) | body | false | int32 |
- 响应状态
状态码 | 说明 |
---|---|
0 | 成功 |
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
- 响应参数:
参数名称 | 参数说明 | 类型 |
---|---|---|
code | 状态码 | integer(int32) |
data | 返回体 | |
cashEnableAmount | 此订单使用的现金可买数量 | number |
cashEnableBalance | 此订单使用的可买现金 | number |
cashMaxEnableAmount | 最大使用的现金可买数量 | number |
marginAmount | 融资股数 | number |
marginBalance | 融资金额 | number |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"saleEnableAmount": 0.00,
"saleEnableIntAmount": 0.0000,
"oddEnableAmount": 0.0000,
"buyEnableAmount": 6000.00,
"handAmount": 100.0000,
"cashEnableAmount": 2931,
"cashEnableIntAmount": 2900.0000,
"cashPurchasingPower": 983164.00,
"maxPurchasingPower": 2026893.26,
"fundAccoutType": "M"
}
}
# 2.16客户融资账户详情
接口地址 /stock-order-server/open-api/margin-detail
请求方式 POST
consumes ["application/json"]
produces ["application/json"]
接口描述 需要资金账号
请求示例
{
"exchangeType": 0,
}
- 请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息 | header | true | string |
X-Sign | RSA签名 | header | true | string |
X-Type | APP类别(1-大陆版,2-港版) | header | true | string |
exchangeType | 交易类别,0港股,5美股 | body | true | int32 |
- 响应状态
状态码 | 说明 |
---|---|
0 | 成功 |
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
- 响应参数
参数名称 | 参数说明 | 类型 |
---|---|---|
code | 状态码 | integer(int32) |
data | 返回体 | MarginDetailResponse |
anticipatedInterest | 预计利息 | number |
asset | 净资产 | number |
callMarginCall | 追缴保证金 | number |
creditAmount | 信用额度 | number |
creditRatio | 信用比率 | number |
debitBalance | 负债金额 | number |
enableBalance | 可用金额 | number |
frozenBalance | 冻结金额 | number |
marginRatioDay | 融资利率日 | string |
marginRatioYear | 融资利率年 | string |
marketValue | 股票市值 | number |
fundBondMarketValue | 基金市值 | number |
mortgageMarketValue | 抵押市值 | number |
mv | mv% | number |
onWayBalance | IPO在途 | number |
purchasePower | 购买力 | number |
riskStatusCode | 风控水平CODE | integer(int32) |
riskStatusName | 风控水平名称 | string |
withdrawBalance | 可取现金 | number |
totalHoldingBalance | 持仓盈亏金额 | number |
msg |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"asset": "1021464.00",
"enableBalance": "983164.00",
"purchasePower": "2026893.26",
"withdrawBalance": "983164.00",
"frozenBalance": "0.00",
"onWayBalance": "0.00",
"marketValue": "28300.00",
"mv": "0.0000",
"riskStatusCode": 1,
"riskStatusName": "安全",
"debitBalance": "0.00",
"callMarginCall": "0.00",
"anticipatedInterest": "913.65",
"mortgageMarketValue": "13584.00",
"creditAmount": "1043729.26",
"creditRatio": "0.80",
"marginRatioYear": "6.60%",
"marginRatioDay": null,
" totalHoldingBalance": 100
}
}
# 3 IPO认购
# 3.1获取IPO列表-分页查询
接口地址 /stock-order-server/open-api/ipo-list
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 获取IPO列表(不需要登录)
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
status | Tab页类别(0-认购中,1-待上市) | body | true | int32 |
pageNum | 当前页 1开始, 默认值1 | body | false | int32 |
pageSize | 每页结果数, 默认值10 | body | false | int32 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"pageNum": 1,
"pageSize": 10,
"status": 1
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ResponseVO«PageInfoVO«AppGetIpoListResponse»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | PageInfoVO«OpenApiGetIpoListResponse» | PageInfoVO«OpenApiGetIpoListResponse» |
list | 结果集合 | array | OpenApiGetIpoListResponse |
bookingRatio | 认购倍数 | number | |
endTime | 现金认购结束时间yyyy-MM-dd HH:mm:ss | string | |
englishName | 新股英文名 | string | |
exchangeType | 市场类型(0-港股) | int32 | |
financingEndTime | 融资认购结束时间 | string | |
financingMultiple | 融资倍数 | int32 | |
ipoId | IPO id | string | |
labelStatus | 标签状态(0-已认购,1-已中签,2-未中签) | int32 | |
latestEndtime | 最晚认购截止时间(国际认购、融资认购和现金认购截止时间最晚的时间) | string | |
leastAmount | 起购金额 | number | |
listingPrice | 最终上市价格 | number | |
listingTime | 上市交易时间 | string | |
moneyType | 币种类型(0-人民币,1-美元,2-港币) | int32 | |
priceMax | 最高招股价 | number | |
priceMin | 最低招股价 | number | |
publishTime | 公布中签日期 | string | |
remainingTime | 认购剩余时间(秒) | int64 | |
serverTime | 服务器时间 | string | |
status | 新股状态(0-待认购,1-认购中,2-待扣款,3-已扣款待确认,4-已确认待公布,5-已公布待上市,6-已上市,7-取消上市,8-暂缓上市,9-延迟上市) | int32 | |
statusName | 状态中文名 | string | |
stockCode | 新股代码 | string | |
stockName | 新股名称 | string | |
subscribeWay | 认购方式,多种认购用,隔开,比如0,1 支持现金和融资(1-公开现金认购,2-公开融资认购,3-国际配售)-这个字段可以判断是否支持融资认购 | string | |
successRate | 中签率 | number | |
pageNum | 当前页 | int32 | |
pageSize | 每页条数 | int32 | |
total | 总数 | int64 | |
msg | 状态信息 |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 20,
"total": 2,
"list": [{
"ipoId": "1143834475048767488",
"stockCode": "02099",
"exchangeType": 0,
"status": 1,
"statusName": "认购中",
"stockName": "中国黄金国际",
"englishName": "CHINAGOLDINTL",
"leastAmount": null,
"priceMin": 7,
"priceMax": 11,
"listingPrice": 10,
"endTime": "2019-06-27",
"financingEndTime": null,
"latestEndtime": "2019-06-27",
"remainingTime": -1,
"labelStatus": null,
"successRate": null,
"bookingRatio": null,
"publishTime": "2019-07-01",
"listingTime": "2019-07-02",
"moneyType": 2,
"serverTime": "2019-10-09 21:08:21",
"subscribeWay": "1",
"financingMultiple": 3
},
{
"ipoId": "1133576191818039296",
"stockCode": "00994",
"exchangeType": 0,
"status": 1,
"statusName": "认购中",
"stockName": "中天宏信",
"englishName": "CT VISION",
"leastAmount": null,
"priceMin": 7,
"priceMax": 10,
"listingPrice": 9,
"endTime": "2019-07-29",
"financingEndTime": null,
"latestEndtime": "2019-07-29",
"remainingTime": -1,
"labelStatus": null,
"successRate": null,
"bookingRatio": 0,
"publishTime": "2019-07-30",
"listingTime": "2019-07-31",
"moneyType": 2,
"serverTime": "2019-10-09 21:08:21",
"subscribeWay": "1",
"financingMultiple": 1
}
]
}
}
# 3.2获取新股详细信息
接口地址 /stock-order-server/open-api/ipo-info
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 获取新股详细信息
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
exchangeType | 市场类型(0-HK,5-US),如果ipoId不传,该字段必传 | body | false | int32 |
ipoId | 新股id [与(stockCode&exchangeType不能同时为空)],当ipoId有值,优先取ipoId查询,stockCode&exchangeType条件不生效 | body | false | int64 |
stockCode | 股票代码,如果ipoId不传,该字段必传 | body | false | string |
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ResponseVO«appIpoInfoResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"ipoId": 1133576191528632320
}
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | appIpoInfoResponse | appIpoInfoResponse |
applied | 用户是否已认购 | boolean | |
beginTime | 现金认购开始时间 | string | |
bookingFee | 现金认购手续费 | number | |
bookingRatio | 认购倍数 | number | |
compFinancingSurplus | 公司融资额度净余 | number | |
depositRate | 融资比例 | number | |
ecmEndTime | 国际认购截止时间 | date-time | |
ecmStatus | ecm新股状态(0-待认购,1-认购中,2-待扣款,3-待扣款[未全部扣款成功],4-待提交,5-待分配,6-待返款,7-待返款[未全部返款成功],8-待返券,9-待返券[未全部返券成功],10-待CCASS确认,11-待上市,12-已上市,13-暂停认购) | int32 | |
endTime | 现金认购结束时间 | string | |
englishName | 新股英文名 | string | |
exchangeType | 交易类别(0-HK,5-US) | int32 | |
exchangeTypeName | 交易类别名称 | string | |
financingEndTime | 融资认购截止时间 | date-time | |
financingFee | 融资手续费 | number | |
financingMultiple | 融资倍数 | int32 | |
financingTips | 融资认购温馨提示 | string | |
greyFlag | 是否支持暗盘(0-不支持,1-支持) | int32 | |
greyTimeBegin | 暗盘交易时间段开始,格式 HH:mm:ss | string | |
greyTimeEnd | 暗盘交易时间段结束,格式 HH:mm:ss | string | |
greyTradeDate | 暗盘交易日,格式 yyyy-MM-dd | string | |
handAmount | 每手股数 | number | |
interestBeginDate | 融资认购/计息开始时间 | date-time | |
interestDay | 计息天数 | int32 | |
interestEndDate | 融资计息结束时间 | date-time | |
interestRate | 默认融资利率 | number | |
ipoFinancingRatios | 融资阶梯利率(json数组:[{"financing_amount_begin":初始认购金额,"financing_amount_end":结束认购金额,"interest_rate":利率,"exchange_type":市场类型,"stock_code":"新股代码"}]) | array | IpoFinancingRatio |
exchange_type | 市场类型 | int32 | |
financing_amount_begin | 初始认购金额 | number | |
financing_amount_end | 结束认购金额 | number | |
interest_rate | 利率 | number | |
stock_code | 新股代码 | string | |
ipoId | IPO id | string | |
latestEndtime | 最晚认购截止时间(国际认购、融资认购和现金认购截止时间最晚的时间) | string | |
leastAmount | 起购金额(一手认购金额) | number | |
listingPrice | 最终上市价格 | number | |
listingTime | 上市交易时间 | string | |
marketValueMax | 市值最大值 | number | |
marketValueMin | 市值最小值 | number | |
moneyType | 币种类型(0-人民币,1-美元,2-港币) | int32 | |
officialBegin | 官方招股开始时间 | string | |
officialEnd | 官方招股结束时间 | string | |
priceMax | 最高招股价 | number | |
priceMin | 最低招股价 | number | |
prospectusLink | 招股书链接 | string | |
publishQuantity | 发行股本 | number | |
publishTime | 公布中签日期 | string | |
qtyAndCharges | 档位信息(json数组:[{"allotted_amount":中签金额,"applied_amount":申购金额,"exchange_type":市场类型,"shared_applied":申购数量,"stock_code":"新股代码"," leastCash ":档位对应的最少使用现金}]) | array | IpoQtyAndCharges |
allotted_amount | 中签金额 | number | |
applied_amount | 申购金额 | number | |
exchange_type | 市场类型 | int32 | |
leastCash | 档位对应的最少使用现金 | int32 | |
shared_applied | 申购数量 | number | |
stock_code | 新股代码 | string | |
remainingTime | 认购剩余时间(秒) | int64 | |
serverTime | 服务器时间 | string | |
sponsor | 保荐人 | string | |
status | 新股状态(0-待认购,1-认购中,2-待扣款,3-已扣款待确认,4-已确认待公布,5-已公布待上市,6-已上市,7-取消上市,8-暂缓上市,9-延迟上市) | int32 | |
statusName | 状态中文名 | string | |
stockCode | 新股代码 | string | |
stockIntroduction | 股票介绍 | string | |
stockName | 新股名称 | string | |
subscribeWay | 认购方式,多种认购用,隔开,比如1,2 支持现金和融资(1-公开现金认购,2-公开融资认购,3-国际配售)-这个字段可以判断是否支持融资认购 | string | |
successRate | 中签率 | number | |
tips | 现金认购温馨提示 | string | |
totalQuantity | 总股本 | number | |
updateTime | 更新时间 | string | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"ipoId": "1143834475048767488",
"stockCode": "02099",
"stockName": "中国黄金国际",
"status": 1,
"exchangeType": 0,
"moneyType": 2,
"handAmount": null,
"bookingFee": 10,
"beginTime": "2019-06-25 09:00:00",
"endTime": "2019-06-27 12:00:00",
"publishTime": "2019-07-01 00:00:00",
"listingTime": "2019-07-02 00:00:00",
"listingPrice": null,
"priceMin": null,
"priceMax": 11,
"financingEndTime": null,
"interestBeginDate": null,
"interestEndDate": null,
"officialBegin": "2019-06-25 09:00:00",
"officialEnd": "2019-06-28 12:00:00",
"leastAmount": null,
"successRate": null,
"bookingRatio": null,
"sponsor": "",
"publishQuantity": null,
"totalQuantity": null,
"marketValueMin": null,
"marketValueMax": null,
"prospectusLink": "Http://",
"qtyAndCharges": [{
"stock_code": "2099",
"exchange_type": 0,
"shared_applied": 100,
"applied_amount": 1111.09,
"allotted_amount": 0
}],
"ipoFinancingRatios": [{
"stock_code": "2099",
"exchange_type": 0,
"financing_amount_begin": 1000,
"financing_amount_end": 10000,
"interest_rate": 0.5
},
{
"stock_code": "2099",
"exchange_type": 0,
"financing_amount_begin": 10001,
"financing_amount_end": 20000,
"interest_rate": 0.7
}
],
"financingMultiple": 3,
"depositRate": 0.7,
"financingFee": null,
"interestDay": 0,
"interestRate": null,
"compFinancingSurplus": null,
"subscribeWay": "1"
}
}
# 3.3ipo新股认购
接口地址 /stock-order-server/open-api/apply-ipo
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 ipo新股认购
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Dt | 设备类型(t1-android,t2-ios,t3-其他,t4-Windows,t5-Mac) | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
applyQuantity | 认购数量 | body | true | number |
applyType | 认购类型(1-现金,2-融资) | body | true | int32 |
ipoId | ipo交易系统唯一编号 | body | true | int64 |
serialNo | 流水号,最长19位,确保唯一推荐雪花算法生成 | body | true | int64 |
cash | 认购现金(融资认购时必填) | body | false | number |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1Qi LCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Dt: 1
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密’;
- 请求body示例
{
"applyQuantity": 100,
"applyType": 1,
"cash": 0,
"ipoId": 1133576191818039296,
"serialNo": 1182189250463484234
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ResponseVO«IpoApplyResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | IpoApplyResponse | IpoApplyResponse |
applyId | 申购id | string | |
status | 申购状态(0-已提交,1-已认购,2-等待改单, 3-等待撤销,4-已撤销,5-已扣款,6-待公布中签,7-全部中签,8-部分中签,9-未中签,10-认购失败) | int32 | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"applyId": "1182192040986583040",
"status": 1
}
}
# 3.4ipo改单/撤单
接口地址 /stock-order-server/open-api/modify-ipo
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 ipo改单/撤单
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Request-Id | 头部信息的requestId信息,长度30位,确保唯一,防止重复提交实现接口幂等 | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
actionType | 操作类型 0-改单,1-撤单 | body | true | int32 |
applyId | 认购记录Id | body | true | int64 |
applyQuantity | 认购数量 | body | true | number |
cash | 认购现金(改融资认购单,必填) | body | false | number |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Request-Id: 928239187123721231232
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"actionType": 1,
"applyId": 1182192040986583040,
"applyQuantity": 0,
"cash": 0
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ResponseVO«IpoApplyResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | IpoApplyResponse | IpoApplyResponse |
applyId | 申购id | string | |
status | 申购状态(0-已提交,1-已认购,2-等待改单, 3-等待撤销,4-已撤销,5-已扣款,6-待公布中签,7-全部中签,8-部分中签,9-未中签,10-认购失败) | int32 | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"applyId": "1182192040986583040",
"status": 4
}
}
# 3.5获取客户ipo申购列表-分页查询
接口地址 /stock-order-server/open-api/ipo-record-list
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 获取客户ipo申购列表
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
applyTimeMin | 认购开始时间,格式:yyyy-MM-dd HH:mm:ss | body | false | string |
applyTimeMax | 认购结束时间,格式:yyyy-MM-dd HH:mm:ss | body | false | string |
pageNum | 当前页 1开始,默认值1 | body | false | int32 |
pageSize | 每页结果数,默认值10 | body | false | int32 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求示例
{
"pageNum": 1,
"pageSize": 10,
"applyTimeMin": "2019-10-12 00:00:00",
"applyTimeMax": "2020-01-30 00:00:00"
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ResponseVO«PageInfoVO«IpoRecordListResponse»» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | PageInfoVO«IpoRecordListResponse» | PageInfoVO«IpoRecordListResponse» |
list | 结果集合 | array | IpoRecordListResponse |
allottedQuantity | 中签股数 | number | |
applyAmount | 认购总金额(包含手续费,不包含利息) | number | |
applyId | 申请编号 | string | |
applyQuantity | 认购股数 | number | |
applyType | 认购类型(1-现金,2-融资) | int32 | |
applyTypeName | 认购类型(1-现金认购,2-融资认购) | string | |
priceMax | 最高招股价 | number | |
priceMin | 最低招股价 | number | |
listingPrice | 最终上市价格 | number | |
cash | 认购现金 | number | |
exchangeType | 市场类型(0-HK,5-US) | int32 | |
financingAmount | 融资利息 | number | |
financingBalance | 融资金额 | number | |
interestRate | 融资利率 | number | |
labelCode | 状态标签码(0-待系统确认,1-已认购,4-已撤销,6-待公布中签,7-已中签,9-未中签,10-认购失败) | int32 | |
moneyType | 币种类型(0-人民币,1-美元,2-港币) | int32 | |
publishTime | 公布中签日期 | string | |
listingTime | 上市交易时间(YYYY-MM-DD) | ||
serverTime | 服务器时间 | string | |
status | 认购状态(0-已提交,1-已认购,2-等待改单, 3-等待撤销,4-已撤销,5-已扣款,6-待公布中签,7-全部中签,8-部分中签,9-未中签,10-认购失败) | int32 | |
statusName | 认购状态名称 | string | |
stockCode | 股票代码 | string | |
stockName | 股票名称 | string | |
pageNum | 当前页 | int32 | |
pageSize | 每页条数 | int32 | |
total | 总数 | int64 | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 0,
"total": 34,
"list": [{
"applyId": "1147036407112679424",
"applyType": 2,
"applyTypeName": "融资认购",
"stockName": "香港中華煤氣",
"stockCode": "00003",
"exchangeType": 0,
"status": 10,
"statusName": "认购失败",
"applyQuantity": 200,
"applyAmount": 4140.31,
"cash": null,
"financingBalance": null,
"interestRate": null,
"priceMin": 10,
"priceMax": 20,
"listingPrice": 13,
"financingAmount": 1.75,
"allottedQuantity": 0,
"publishTime": "2019-07-05 00:00:00",
"serverTime": null,
"moneyType": 2,
"labelCode": 10
},
{
"applyId": "1147018860570537984",
"applyType": 2,
"applyTypeName": "融资认购",
"stockName": "香港中華煤氣",
"stockCode": "00003",
"exchangeType": 0,
"status": 4,
"statusName": "已撤销",
"applyQuantity": 200,
"applyAmount": 4140.31,
"cash": null,
"financingBalance": null,
"interestRate": null,
"priceMin": 10,
"priceMax": 20,
"listingPrice": 13,
"financingAmount": 1.75,
"allottedQuantity": null,
"publishTime": "2019-07-05 00:00:00",
"serverTime": null,
"moneyType": 2,
"labelCode": 4
}
]
}
}
# 3.6获取客户ipo申购明细
接口地址 /stock-order-server/open-api/ipo-record
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 获取客户ipo申购明细
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
X-Channel | 渠道 | header | true | string |
applyId | 申购编号(传其中一个即可) | body | false | int64 |
serialNo | 流水号(传其中一个即可) | body | false | int64 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求示例
{
"applyId": 1147036407112679424,
"serialNo": 1233123554314
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ResponseVO«IpoRecordResponse» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | IpoRecordResponse | IpoRecordResponse |
allottedQuantity | 中签股数 | number | |
applyAmount | 认购总金额(包含手续费,不包含利息) | number | |
applyId | 申请编号 | string | |
applyQuantity | 认购股数 | number | |
applyType | 认购类型(1-现金,2-融资) | int32 | |
applyTypeName | 认购类型(1-现金认购,2-融资认购) | string | |
cash | 认购现金 | number | |
channel | 渠道类型(1-APP提交,2-中台提交,99-其它) | int32 | |
createTime | 认购提交时间 | string | |
deductStatus | 扣款状态(0-已冻结,1-已扣款,2-已解冻) | int32 | |
deductStatusName | 扣款状态名 | string | |
endTime | 当前认购方式截止时间 | string | |
exchangeType | 市场类型(0-HK,5-US) | int32 | |
failReason | 认购失败原因 | string | |
financingAmount | 融资利息 | number | |
financingBalance | 融资金额 | number | |
handlingFee | 手续费 | number | |
interestDay | 计息天数 | int32 | |
interestRate | 融资利率 | number | |
ipoId | ipo编号 | string | |
ipoStatus | 新股状态(0-待认购,1-认购中,2-待扣款,3-已扣款待确认,4-已确认待公布,5-已公布待上市,6-已上市,7-取消上市,8-暂缓上市,9-延迟上市) | int32 | |
labelCode | 状态标签码(0-待系统确认,1-已认购,4-已撤销,6-待公布中签,7-已中签,9-未中签,10-认购失败) | int32 | |
moneyType | 币种类型(0-人民币,1-美元,2-港币) | int32 | |
publishTime | 公布中签日期 yyyy-MM-dd HH:mm:ss | string | |
refundAmount | 退款金额 | number | |
refundFlag | 退款状态(0-无退款,1-待退款,2-已退款) | int32 | |
serverTime | 服务器时间 | string | |
status | 认购状态(0-已提交,1-已认购,2-等待改单, 3-等待撤销,4-已撤销,5-已扣款,6-待公布中签,7-全部中签,8-部分中签,9-未中签,10-认购失败,20额度申请中) | int32 | |
statusName | 认购状态名称 | string | |
stockCode | 股票代码 | string | |
stockName | 股票名称 | string | |
listingTime | 上市时间yyyy-MM-dd | string | |
accountCanCancel | 该账户在APP是否允许撤销 true-允许,false-不允许 | boolean | |
cancelDeductInterest | 融资撤销是否扣除利息(0-撤单无需收取利息,1-撤单需要收取利息,2-撤单利息收取中,3-撤单已收取利息) | int32 | |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"applyId": "1178190341147189248",
"applyType": 1,
"applyTypeName": "现金认购",
"stockName": "新城市建设发展",
"stockCode": "00456",
"exchangeType": 0,
"status": 4,
"statusName": "已撤销",
"applyQuantity": 1900.00,
"applyAmount": 34544.6300,
"cash": null,
"financingBalance": null,
"interestRate": null,
"financingAmount": 0.0000,
"allottedQuantity": null,
"publishTime": "2019-10-03 00:00:00",
"serverTime": "2019-11-01 20:33:55",
"moneyType": 2,
"labelCode": 4,
"createTime": "2019-09-29 14:10:42",
"deductStatus": 2,
"deductStatusName": "已解冻",
"refundFlag": 0,
"refundAmount": null,
"handlingFee": 0.0000,
"failReason": null,
"endTime": "2019-09-30 11:18:00",
"ipoId": "1178148950262435840",
"interestDay": 0,
"channel": 1,
"listingTime": "2019-10-04",
"ipoStatus": 6
}
}
# 3.7额度不足时确认现金认购数量
接口地址 /stock-order-server/open-api/ipo-comfirm-qyt/v1
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 额度不足时确认现金认购数量
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
X-Channel | 渠道 | header | true | string |
applyId | 申购编号 | query | true | integer |
noQuotaCashFlag | 是否需要现金认购(0-否,1-是) | query | true | integer |
confirmBy | 确认来源,1-ipo认购,2-ipo修改,3-ipo详情修改 | query | true | integer |
noQuotaCashQuantity | 申购股数,noQuotaCashFlag=1时必填 | query | false | number |
- 请求示例
{
"applyId": "1249718975670743040",
"noQuotaCashFlag":0
}
- 响应状态
状态码 | 说明 |
---|---|
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
- 响应参数
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | integer(int32) | integer(int32) |
msg |
- 响应示例
{
"code": 0,
"msg": "操作成功",
}
# 4 资金记录
# 4.1查询汇率
接口地址 /stock-capital-server/open-api/currency-exchange-info
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述
请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
X-Channel | 渠道 | header | true | string |
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | CapitalResponseVO«FetchExchangeRateResp» |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 |
---|---|---|
code | 状态码 | int32 |
data | 返回体 | array |
baseMoneyType | 基准币种,0:人民币 1:美元 2:港币 | int32 |
sourceCurrency | 源币种,0:人民币 1:美元 2:港币 | int32 |
targetCurrency | 目标币,0:人民币 1:美元 2:港币 | int32 |
yxBuyRate | 盈立买入汇率 | number |
yxSellRate | 盈立卖出汇率 | number |
bocSellRate | 中银卖出汇率 | number |
bocBuyRate | 中银买入汇率 | number |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": [
{
"sourceCurrency": 1,
"targetCurrency": 2,
"yxSellRate": 7.842,
"yxBuyRate": 7.8133,
"bocSellRate": 7.842,
"bocBuyRate": 7.8133,
"baseMoneyType": 1
},
{
"sourceCurrency": 0,
"targetCurrency": 2,
"yxSellRate": 90.335,
"yxBuyRate": 91.235,
"bocSellRate": 90.33,
"bocBuyRate": 91.24,
"baseMoneyType": 0
},
{
"sourceCurrency": 1,
"targetCurrency": 0,
"yxSellRate": 7.0817,
"yxBuyRate": 7.0148,
"bocSellRate": 7.0817,
"bocBuyRate": 7.0148,
"baseMoneyType": 1
}
]
}
# 4.2获取历史记录
接口地址 /stock-capital-server/open-api/business-flow
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述
请求示例
{
"dateType": 9,
"pageNum": 1,
"pageSize": 10,
"startTime": "2020-05-09 00:00:00",
"endTime": "2020-12-24 23:59:59",
"type": -1
}
- 请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
dateType | -1,全部0,近一个月1,近三个月2,近一年3,今年9 ,自定义 | body | false | int32 |
startTime | 开始时间,data-9时传 | body | false | date-time |
endTime | 结束时间,data-9时传 | body | false | date-time |
pageNum | 当前页 1开始 | body | true | int32 |
pageSize | 每页结果数 | body | true | int32 |
type | 0-入金,1-出金,2-货币兑换,不传查询所有 | body | false | int32 |
- 响应状态
状态码 | 说明 |
---|---|
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 |
---|---|---|
code | 状态码 | int32 |
list | 结果集合 | array |
applyTime | 发生时间 | string |
businessId | 业务ID | string |
businessStatus | 业务实际状态值 入金:入金状态 0无效 ,10客户入金申请,20待初审匹配,23初审匹配失败,25终审驳回给财务,30待客服确认,40待终审,51驳回给客户,52审核不通过,无退款(终态), 60待入金,62入金处理中,超过十分钟定时任务补查结果,63入金失败,需要人工干预,64入金成功(终态),70待退款,73退款失败,需要人工干预,74退款成功(终态)。状态>=40的不能撤销 | int32 |
occurBalance | 入金的通知金额、出金的提取金额、换汇的兑换金额 | string |
postBalance | 入金的实际到账金额、换汇的兑换结果 | string |
reason | 驳回原因 | string |
statusDesc | 状态描述1换汇成功,2换汇失败,3处理中,10待处理,11处理中,12已汇出,13出金失败,14已撤销,15已驳回,20处理中,21已到账,22入金失败,30已驳回,40待退款,41已退款,42 "退款失败 | string |
statusValue | 状态值 | int32 |
title | 标题,如转入港币、港币兑美元 | string |
type | 类型 | string |
pageNum | 当前页 | int32 |
pageSize | 每页条数 | int32 |
systemDate | 系统当前时间 yyyy-MM-dd | string |
total | 总数 | int32 |
error | 错误详情 | string |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"data": {
"list": [
{
"applyTime": "2020-05-09 16:15:38",
"businessId": "776607442319044608",
"businessStatus": null,
"occurBalance": "1000.00港币",
"postBalance": "",
"reason": "",
"statusDesc": "待处理",
"statusValue": 10,
"title": "提取 港币",
"type": "1"
},
{
"applyTime": "2020-04-16 15:59:15",
"businessId": "768268401176485888",
"businessStatus": 23,
"occurBalance": "20000.00港币",
"postBalance": "",
"reason": "",
"statusDesc": "处理中",
"statusValue": 20,
"title": "转入 港币",
"type": "0"
}
],
"pageNum": 1,
"pageSize": 10,
"systemDate": "2020-05-09",
"total": 2
},
"msg": "成功"
}
# 4.2客户出金撤销
接口地址 /stock-capital-server/open-api/app-cashOut-revoke
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述
请求示例
{
"id": 768268401176485888
}
- 请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道ID,由盈立分配 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
id | id | body | true | int64 |
- 响应状态
状态码 | 说明 |
---|---|
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 |
---|---|---|
code | 状态码 | int32 |
data | 返回体 | |
error | 错误详情 | string |
msg | 状态信息 | string |
- 响应示例
{
"code": 0,
"data": null,
"msg": "成功"
}
# 5 数据字典
# 5.1订单状态(Status)
编码 | 名称 |
---|---|
-1 | 失败 |
0 | 全部成交 |
1 | 等待提交 |
2 | 待成交 |
3 | 部分成交 |
4 | 等待撤单 |
5 | 等待改单 |
6 | 已撤单 |
7 | 部成撤单 |
8 | 废单 |
11 | 等待提交 |
61 | 收市撤单 |
# 5.2市场类型(ExchangeType)
编码 | 名称 |
---|---|
0 | 港股 |
1 | 上海A |
2 | 上海B |
3 | 深圳A |
4 | 深圳B |
5 | 美股 |
6 | 沪港通 |
7 | 深港通 |
67 | A股(用于查询) |
100 | 所有市场(用于查询) |
# 5.3IPO新股状态(Status)
编码 | 名称 |
---|---|
0 | 待认购 |
1 | 认购中 |
2 | 待扣款 |
3 | 已扣款待确认 |
4 | 已确认待公布 |
5 | 已公布待上市 |
6 | 已上市 |
7 | 取消上市 |
8 | 暂缓上市 |
9 | 延迟上市 |
11 | 已删除 |
# 5.4IPO认购状态(Status)
编码 | 名称 |
---|---|
0 | 已提交 |
1 | 已认购 |
2 | 等待改单 |
3 | 等待撤销 |
4 | 已撤销 |
5 | 已扣款 |
6 | 待公布中签 |
7 | 全部中签 |
8 | 部分中签 |
9 | 未中签 |
10 | 认购失败 |
11 | 已中签 |
12 | 待系统确认 |
20 | 申请额度中 |
# 5.5币种(moneyType)
编码 | 名称 |
---|---|
0 | 人民币 |
1 | 美元 |
2 | 港币 |
# 5.6设备类别(X-Dt)
编码 | 名称 |
---|---|
t1 | 安卓 |
t2 | Ios |
t3 | 其它 |
t4 | Windows |
t5 | Mac |
# 5.7账户类型(AssetProp)
编码 | 名称 |
---|---|
0 | 现金账户 |
M | 融资账户 |
# 6 孖展
# 6.1获取股票抵押比率列表
接口地址 /stock-order-server/open-api/mortgage-list
请求方式 POST
consumes ["application/json"]
produces ["/"]
接口描述 获取股票抵押比率列表(不需要登录)
请求参数
参数名称 | 说明 | 请求类型 | 必填 | 类型 |
---|---|---|---|---|
Authorization | 头部信息的token信息 | header | true | string |
X-Lang | 语言类别(1-简体,2-繁体,3-English) | header | true | string |
X-Channel | 渠道 | header | true | string |
X-Time | 时间戳 | header | true | string |
X-Sign | RSA签名 | header | true | string |
exchangeType | 市场:0-港股,5-美股,67-A股,100-全部 | body | false | int32 |
stockCode | 证券代码 | body | false | string |
status | 状态:1-生效中 0-已下架,默认1 | body | false | int32 |
pageSizeZero | 是否不分页,默认false | body | false | boolean |
pageNum | 当前页 1开始, 默认值1 | body | false | int32 |
pageSize | 每页结果数, 默认值10,最大20 | body | false | int32 |
- 请求header示例
Authorization:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoiMzIyMzM1ZTc1NTZiNDQzMzkyZWNmZWJmYTYzYjZmMzEiLCJzb3VyY2UiOiJhcHAiLCJ1dWlkIjozNDA1MDIxMzExOTM0ODczNjB9.cvuoahb0h_s1rx57iJBwQn7FNcNfFJ6llCTUlqDTFlD
Content-Type: application/json;charset=UTF-8
X-Lang: 1
X-Type: 1
X-Channel:100082
X-Sign:body 使用RSA私钥加密
- 请求body示例
{
"exchangeType": 0,
"pageNum": 1,
"pageSize": 10,
"stockCode": "",
"pageSizeZero":true,
"status":1
}
- 响应状态
状态码 | 说明 | schema |
---|---|---|
200 | OK | ResponseVO<PageInfoVO<MortgageOpenApiResp>> |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |
- 响应参数
参数名称 | 说明 | 类型 | schema |
---|---|---|---|
code | 状态码 | int32 | |
data | 返回体 | ResponseVO<PageInfoVO<MortgageOpenApiResp>> | ResponseVO<PageInfoVO<MortgageOpenApiResp>> |
list | 结果集合 | array | MortgageOpenApiResp |
beginTime | 生效日 | string(date-time) | |
effectiveTime | 有效截止时间yyyy-MM-dd HH:mm:ss | string(date-time) | |
exchangeType | 市场(0-港股 5-美股 6-沪港通 7-深港通) | int32 | |
exchangeTypeName | 市场名称 | string | |
mortgageRatio | 融资抵押比率 | string | |
status | 记录状态 1-生效中 0-已下架 | int32 | |
statusName | 记录状态名称 | string | |
stockCode | 证券代码 | string | |
stockName | 证券名称 | string | |
pageNum | 当前页 | int32 | |
pageSize | 每页条数 | int32 | |
total | 总数 | int64 | |
msg | 状态信息 |
- 响应示例
{
"code": 0,
"msg": "操作成功",
"data": {
"pageNum": 1,
"pageSize": 10,
"total": 2,
"list": [
{
"exchangeType": 6,
"exchangeTypeName": "沪港通",
"stockName": "贵州茅台",
"stockCode": "600519",
"mortgageRatio": "60.00%",
"beginTime": "2020-10-27",
"effectiveTime": "2099-12-31",
"status": 1,
"statusName": "生效中"
},
{
"exchangeType": 6,
"exchangeTypeName": "沪港通",
"stockName": "上海临港",
"stockCode": "600848",
"mortgageRatio": "10.00%",
"beginTime": "2020-10-27",
"effectiveTime": "2099-12-31",
"status": 1,
"statusName": "生效中"
}
]
}
}