uSMART

# 交易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、密码登录、验证码登录接口支持邮箱账号类型（仅限官网申请渠道）
2025-06-10 1.17 1、新增7.1 MA-下单接口。2、新增7.2 MA-撤单接口。3、新增7.3 MA-订单列表接口。4、新增7.4 MA-订单详情接口。5、新增7.5 MA-获取购买力接口。

# 概述

  • 开放平台可以为个人开发者和机构客户提供接口服务，投资者可以充分的利用盈立智投的交易服务、行情服务、账户服务等实现自己的投资应用。

  • 协议：

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": "生效中"

   }

  ]

 }

}

# 7 MA账户交易及查询

# 7.1下单

  • 接口地址 /ams-center/open-api/ma-order-submit/v1

  • 请求方式 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
strategyId 策略id body true number
stockId 股票代码 body true string
tradeType 交易类型 1.买 2.卖 body true int32
opType 委托类型 0.买 1.卖 body true int32
orderType 订单类型 订单类型 1.限价单 2.增强限价单 3.市价单 4.竞价单 5.竞价现价单 6.条件单（限价） body true int32
sellQuota 委托数量 body true number
sellPrice 委托价格 （每股价格 *10000) body true number
openClosePreFlag 是否允许盘前盘后交易 1.不允许 2.允许 body true int32
  • 请求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示例
{
  "strategyId": 10626,
  "stockId": "hk02202",
  "tradeType": 1,
  "orderType": 2,
  "opType": 0,
  "sellQuota": 100,
  "sellPrice": 1000,
  "openClosePreFlag": 1,
  "serialNo":"4234345345345"
}
  • 响应状态
状态码 说明 schema
0 成功
200 OK ResponseVO«OpenApiMaOrderCancelReqVO»
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
  • 响应参数
参数名称 说明 类型 schema
code 状态码 int32
data 返回体 OpenApiMaOrderCancelReqVO OpenApiMaOrderCancelReqVO
orderId 订单id,可用于查询订单/取消订单 string
msg 状态信息 string
  • 响应示例
{
  "code": 0,
  "data": {
    "orderId": "1449856553723613186"
  },
  "msg": "Success"
}

# 7.2撤单

  • 接口地址 /ams-center/open-api/ma-order-cancel/v1

  • 请求方式 POST

  • consumes ["application/json"]

  • produces ["application/json"]

  • 接口描述 撤单

  • 请求参数

参数名称 说明 请求类型 必填 类型
Authorization 头部信息的token信息 header true string
X-Lang 语言类别(1-简体，2-繁体，3-English) header true string
X-Request-Id 头部信息的requestId信息,长度30位，确保唯一，防止重复提交实现接口幂等 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
maOrderId ma订单id 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示例
{
  "maOrderId": "1447739372567232512"
}
  • 响应状态
状态码 说明 schema
0 成功
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
  • 响应参数
参数名称 说明 类型 schema
code 状态码 int32
data 返回体
msg 状态信息 string
  • 响应示例
{
  "code": 0,
  "data": null,
  "msg": "Success"
}

# 7.3订单列表-分页查询

  • 接口地址 /ams-center/open-api/ma-order-list/v1

  • 请求方式 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
pageNum 当前页 1开始，默认值1 body false int32
pageSize 每页结果数，默认值20 body false int32
strategyId 策略id body true number
today 是否今日订单，1 是，0 历史 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示例
{
  "strategyId": 10626,
  "pageNum": 1,
  "pageSize": 20,
  "today": 0
}
  • 响应状态
状态码 说明 schema
0 成功
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
  • 响应参数
参数名称
说明
 类型 schema
code 状态码 int32
data 返回体 PageInfoVO«MaOrderListResponse» PageInfoVO«MaOrderListResponse»
list 结果集合 array MaOrderListResponse
serialNo 流水号 int64
createTime 委托时间 string
orderStatus 订单状态(1-等待提交，5-待报单，10-报单中，11-待成交，12-等待撤单，13-等待改单，20-部分成交，27-成交处理中，28-部成撤单，29-全部成交，30-已撤单，31-下单失败，32-废单，33-收市撤单 40-分配中 41-分配成功 42-分配失败 50补单中 51补单成功 52补单失败) int32
cancelable 是否可取消 1 是，0 否 integer
dealAmount 成交数量 number
dealMoney 成交金额 number
dealPrice 成交价格 number
dealTime 成交时间 string
entrustAmount 委托数量 number
entrustPrice 委托价格 float
entrustProp 委托属性 LMT-限价单,ELMT-增强限价单,MKT-市价单,AM-竟价市价单,AL-竟价限价单 string
entrustTime 委托时间 date-time
jyTradeId 上手下单后返回的序号 string
maOrderId MA订单ID number
opType 委托方向 (0 买 1 卖) integer
tradeType 交易类型 1.买 2.卖 integer
stockId 股票代码 string
stockMarket 股票市场 （1 HK 2 US 4 A股 8 SG） integer
stockName 股票名称 string
pageNum 当前页 int32
pageSize 每页条数 int32
total 总数 int64
msg 状态信息 string
  • 响应示例
{
  "code": 0,
  "data": {
    "list": [
      {
        "cancelable": 0,
        "dealAmount": 0.000000,
        "dealMoney": null,
        "dealPrice": null,
        "dealTime": "",
        "entrustAmount": 100.000000,
        "entrustMoney": 0,
        "entrustPrice": 0.100000,
        "entrustProp": "ELMT",
        "entrustTime": "2025-06-10 11:47:14",
        "jyTradeId": "1932283389052784640",
        "maOrderId": "1449856553723613186",
        "opType": 0,
        "orderStatus": 33,
        "remarks": "",
        "serialNo": "4234345345345",
        "stockId": "02202",
        "stockMarket": 1,
        "stockName": "万科企业",
        "tradeType": 1
      }
    ],
    "total": 6
  },
  "msg": "Success"
}

# 7.4订单详情

  • 接口地址 /ams-center/open-api/ma-order-detail/v1

  • 请求方式 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
maOrderId ma订单id 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示例
{
  "maOrderId": 1449856553723613186
}
  • 响应状态
状态码 说明 schema
0 成功
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
  • 响应参数
参数名称
说明
 类型 schema
code 状态码 int32
data 返回体 OpenapiMaOrderDetailVO OpenapiMaOrderDetailVO
serialNo 流水号 int64
updateTime 更新时间 string
orderStatus 订单状态(1-等待提交，5-待报单，10-报单中，11-待成交，12-等待撤单，13-等待改单，20-部分成交，27-成交处理中，28-部成撤单，29-全部成交，30-已撤单，31-下单失败，32-废单，33-收市撤单 40-分配中 41-分配成功 42-分配失败 50补单中 51补单成功 52补单失败) int32
dealAmount 成交数量 number
dealMoney 成交金额 number
dealPrice 成交价格 number
dealTime 成交时间 string
entrustAmount 委托数量 number
entrustPrice 委托价格 float
orderType 委托属性 LMT-限价单,ELMT-增强限价单,MKT-市价单,AM-竟价市价单,AL-竟价限价单 string
entrustTime 委托时间 string
jyEntrustId 上手下单后返回的序号 string
maOrderId MA订单ID number
opType 委托方向 (0 买 1 卖) integer
tradeType 交易类型 1.买 2.卖 integer
stockId 股票代码 string
stockMarket 股票市场 （1 HK 2 US 4 A股 8 SG） integer
stockName 股票名称 string
remarks 备注 string
msg 状态信息 string
  • 响应示例
{
  "code": 0,
  "data": {
    "dealAmount": 0.000000,
    "dealMoney": 0.000000,
    "dealPrice": 0.000000,
    "dealTime": "",
    "entrustAmount": 100.000000,
    "entrustPrice": 0.100000,
    "entrustTime": "2025-06-10 11:47:14",
    "jyEntrustId": "1932283389052784640",
    "maOrderId": "1449856553723613186",
    "opType": 0,
    "orderStatus": 33,
    "orderType": "ELMT",
    "remarks": "",
    "serialNo": "4234345345345",
    "stockId": "02202",
    "stockMarket": 1,
    "stockName": "万科企业",
    "tradeType": 1,
    "updateTime": "2025-06-10 16:12:01"
  },
  "msg": "Success"
}

# 7.5获取策略购买力

  • 接口地址 /ams-center/open-api/get-ma-trade-account-info/v1

  • 请求方式 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
strategyId 策略id body true number
stockId 股票代码 body true string
opType 委托方向 0-买 1-卖 body true integer
price 每股价格 *10000 body true number
amount 股票数量 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私钥加密
  • 请求body示例
{
  "strategyId": 10626,
  "stockId": "hk01810",
  "opType": 0,
  "price": 533000,
  "amount": 200
}
  • 响应状态
状态码 说明 schema
0 成功
200 OK
201 Created
401 Unauthorized
403 Forbidden
404 Not Found
  • 响应参数
参数名称
说明
 类型 schema
code 状态码 int32
data 返回体 GetMaTradeAccountInfoRespVO GetMaTradeAccountInfoRespVO
cash 可用现金余额 string
availableBuyPosition 可买入股票数量占总资产的比例（以万分之一为单位） number
availableBuyAmount 可以买入的最大股票数量（以股为单位） string
availableSellAmount 实际可卖数量 number
availableSellPosition 可卖出股票数量占总资产的比例（以万分之一为单位） number
entrustPosition 委托买卖股票数量占总资产的比例（以万分之一为单位） number
entrustAmount 委托数量 number
endPosition 交易完成后预期的持仓比例（以万分之一为单位） number
startPosition 交易前已有的持仓比例（以万分之一为单位） number
realAvailableBuyPosition 实际可购买的股票比例（以万分之一为单位） number
msg 状态信息 string
  • 响应示例
{
  "code": 0,
  "data": {
    "availableBuyAmount": 2,
    "availableBuyPosition": 51,
    "availableSellAmount": null,
    "availableSellPosition": null,
    "cash": "1525048",
    "endPosition": 3974,
    "entrustAmount": 2,
    "entrustPosition": 51,
    "realAvailableBuyPosition": 3974,
    "startPosition": 3922
  },
  "msg": "Success"
}

← 下载Demo →