市场代码	说明	交易时间
US	美股	美股正常交易时间(东部时间，ET): 开盘时间：上午 9:30 收盘时间：下午 4:00 盘前交易：开始时间：上午 4:00 结束时间：上午 9:30 盘后交易：开始时间：下午 4:00 结束时间：下午 8:00 以上时间为美国当地时间,如果换算为其它时间时需要注意令时转换夏令时（通常从3月的第二个星期日到11月的第一个星期日）冬令时（通常从11月的第一个星期日到3月的第二个星期日）转换为UTC+8冬令开市是21点30分，夏令开市是22点30分。
HK	港股	UTC+8 上午交易时段：9:30 - 12:00 下午交易时段：13:00 - 16:00
SZ	A股深圳	UTC+8 上午交易时段：9:30 - 11:30 下午交易时段：13:00 - 15:00
SH	A股上海	UTC+8 上午交易时段：9:30 - 11:30 下午交易时段：13:00 - 15:00

4、http协议接口定义

4.0、http协议接入说明

请求时只需要把请key放在请求头中，填充key字段就可以了。

请求Url: 基础url+各个接口的地址
请求方式统一为: POST,不接受非POST请求

4.0.1、请求头

参数	类型	描述
key	string	请求的API key

4.0.2、限制说明

会根据套餐情况限制订阅的产品个数和请求频率，默认是10个产品，每分钟30次请求，可以联系客服根据不同套餐进行调整。

4.1、注册一个新的Key

接口地址：/register
请求方式：POST
接口描述：快速免费申请Key,注意：请求此接口后得到的信息请妥善保管，不要外泄。如果忘记请联系客服进行认证找回。

4.1.1、请求参数

参数名	类型	必填	描述
`email`	string	是	请填写真实有效的邮箱，用于接收验证码（后续找回Key和升级权限等可能需要）。

4.1.2、请求示例

{
    "email":"test@exp.com"
}

4.1.3、响应结果

字段名称	类型	描述
`key`	string	验证需要的key请妥善保管，不要外泄。如果忘记请联系客服进行认证找回。
`email`	string	用户邮箱
`created_at`	string	key创建时间
`expires_at`	string	key过期时间
`permission`	obj	权限数据
`> depth`	obj	深度快照接口权限
`>> product_count`	int	深度快照接口产品数量限制
`>> request_frequency`	int	深度快照接口请求频率限制
`> history`	obj	历史K线接口权限
`>> product_count`	int	历史K线接口产品数量限制
`>> request_frequency`	int	历史K线接口请求频率限制
`> instrumen_info`	obj	交易品种信息接口权限
`>> product_count`	int	交易品种信息接口产品数量限制
`>> request_frequency`	int	交易品种信息接口请求频率限制
`> kline`	obj	K线接口权限
`>> product_count`	int	K线接口产品数量限制
`>> request_frequency`	int	K线接口请求频率限制
`> snapshot`	obj	行情快照接口权限
`>> product_count`	int	行情快照接口产品数量限制
`>> request_frequency`	int	行情快照接口请求频率限制
`> trade`	obj	成交数据接口权限
`>> product_count`	int	成交数据接口产品数量限制
`>> request_frequency`	int	成交数据接口请求频率限制
`> ws`	obj	websocket订阅权限
`>> product_count`	int	websocket订阅产品数量限制
`>> request_frequency`	int	websocket订阅请求频率限制

4.1.4、响应示例

{
    "msg": "OK",
    "data": {
        "key": "b56efc3a0951ae19819505427491a6ee",
        "email": "test4@qos.com",
        "created_at": "2024-11-12T09:43:12.436446868+08:00",
        "expires_at": "2024-11-27T09:43:12.436446868+08:00",
        "permission": {
            "depth": {
                "product_count": 10,
                "request_frequency": 30
            },
            "history": {
                "product_count": 10,
                "request_frequency": 30
            },
            "instrumen_info": {
                "product_count": 10,
                "request_frequency": 30
            },
            "kline": {
                "product_count": 10,
                "request_frequency": 30
            },
            "snapshot": {
                "product_count": 10,
                "request_frequency": 30
            },
            "trade": {
                "product_count": 10,
                "request_frequency": 30
            },
            "ws": {
                "product_count": 10,
                "request_frequency": 30,
                "max_connections": 1
            }
        }
    }
}

4.2、获取交易品种的基础信息

接口地址：/instrument-info
请求方式：POST
接口描述：获取交易品种的基础信息

4.2.1、请求参数

参数名	类型	必填	描述
`codes`	array	是	交易品种列表数组，传入细节请看下面请求示例

4.2.2、请求示例

{
    "codes": [
        "US:AAPL,TSLA",
        "HK:700",
        "SH:600519"
    ]
}

4.2.3、响应结果

字段名称	类型	描述
c	string	股票代码
e	string	交易所
tc	string	交易币种
nc	string	中文名称
ne	string	英文名称
ls	integer	最小交易单位
ts	integer	时间戳
os	integer	股票总数
ep	string	每股盈利
na	string	每股净资产
dy	string	股息率

4.2.4、响应示例

{
  "msg": "OK",
  "data": [
    {
      "c": "US:AAPL",
      "e": "NASD",
      "tc": "USD",
      "nc": "苹果",
      "ne": "AppleInc.",
      "ls": 1,
      "ts": 15115823000,
      "os": 15091141884,
      "ep": "6.2012",
      "na": "3.7676",
      "dy": "0.98"
    },
    {
      "c": "HK:700",
      "e": "SEHK",
      "tc": "HKD",
      "nc": "腾讯控股",
      "ne": "TENCENT",
      "ls": 100,
      "ts": 9267359712,
      "os": 9267359712,
      "ep": "13.719",
      "na": "101.7578",
      "dy": "3.4558"
    },
    {
      "c": "SH:600519",
      "e": "SSE",
      "tc": "CNY",
      "nc": "贵州茅台",
      "ne": "Moutai",
      "ls": 100,
      "ts": 1256197800,
      "os": 1256197800,
      "ep": "59.4923",
      "na": "189.2293",
      "dy": "49.982"
    }
  ]
}

4.3、获取交易品种的实时行情快照

接口地址：/snapshot
请求方式：POST
接口描述：获取交易品种的实时行情快照

4.3.1、请求参数

参数名	类型	必填	描述
`codes`	array	是	交易品种列表数组，传入细节请看下面请求示例

4.3.2、请求示例

{
    "codes": [
        "US:AAPL,TSLA",
        "HK:700",
        "SH:600519"
    ]
}

4.3.3、响应结果

字段名称	类型	描述
c	string	股票代码
lp	string	当前价格
yp	string	昨日收盘价
o	string	开盘价
h	string	最高价
l	string	最低价
ts	integer	时间戳
v	string	成交量
t	string	成交金额
s	integer	是否停牌（0表示未停牌，1表示停牌）

4.3.4、响应示例

{
  "msg": "OK",
  "data": [
    {
      "c": "US:AAPL",
      "e": "NASD",
      "tc": "USD",
      "nc": "苹果",
      "ne": "AppleInc.",
      "ls": 1,
      "ts": 15115823000,
      "os": 15091141884,
      "ep": "6.2012",
      "na": "3.7676",
      "dy": "0.98"
    },
    {
      "c": "HK:700",
      "e": "SEHK",
      "tc": "HKD",
      "nc": "腾讯控股",
      "ne": "TENCENT",
      "ls": 100,
      "ts": 9267359712,
      "os": 9267359712,
      "ep": "13.719",
      "na": "101.7578",
      "dy": "3.4558"
    },
    {
      "c": "SH:600519",
      "e": "SSE",
      "tc": "CNY",
      "nc": "贵州茅台",
      "ne": "Moutai",
      "ls": 100,
      "ts": 1256197800,
      "os": 1256197800,
      "ep": "59.4923",
      "na": "189.2293",
      "dy": "49.982"
    }
  ]
}

4.4、获取交易品种的实时最新盘口深度

接口地址：...

Assets 2

Releases: qos-max/quote-ocean-system

QOS行情报价系统V1.0.2发布

QOS报价海洋系统(Quote Ocean System)-欢迎对接使用

联系作者：

目录

联系作者：

QOS行情报价系统V1.0.1发布

QOS报价海洋系统(Quote Ocean System)-欢迎对接使用

联系作者：

目录

联系作者：

QOS-Quote Ocean System报价海洋V1.0.0发布

QOS报价海洋系统(Quote Ocean System)接口文档

联系作者：

1、快速开始-接入指南

1.1、注册key

1.2、请求Http接口

1.3、订阅webscoket实时数据接口

2、一些枚举定义

2.1、K线类型

2.2、交易方向

3、各类交易品种的编码和交易时间的

4、http协议接口定义

4.0、http协议接入说明

4.0.1、请求头

4.0.2、限制说明

4.1、注册一个新的Key

4.1.1、请求参数

4.1.2、请求示例

4.1.3、响应结果

4.1.4、响应示例

4.2、获取交易品种的基础信息

4.2.1、请求参数

4.2.2、请求示例

4.2.3、响应结果

4.2.4、响应示例

4.3、获取交易品种的实时行情快照

4.3.1、请求参数

4.3.2、请求示例

4.3.3、响应结果

4.3.4、响应示例

4.4、获取交易品种的实时最新盘口深度