QOS 行情 API - 可调试API接口文档 - 提供实时行情API、K线数据API - 外汇API、美股API、港股API、加密货币数据API - 金融高频数据接口 - 免费试用
quote-ocean-system系统简称"QOS行情API"，包括了港股实时API,美股实时API,A股实时API，加密货币实时报价API，数字币实时行情API,采用REST API与websocket接口形式，非常容易接入。
订阅 QOS API，您即可 实时获取最新的股票、外汇、期货、加密货币数据，助力交易决策更快一步。我们的 实时行情数据 采用 WebSocket 高速推送，超低延迟，确保市场信息的精准与高效。QOS API 专为 交易所、开发者、量化团队、金融科技公司 及 专业机构 量身打造，提供 全面的金融市场 Tick 数据解决方案，覆盖 外汇、港股、美股、商品期货、加密货币 等多个领域。
QOS行情报价系统目前提供：全港，全美，沪深等股票和加密货币（数字币）的实时报价，实时K线，历史K线数据等，欢迎免费试用及联系客服,现提供免费试用对接。
- 官网：https://qos.hk
- 更新时间：2025-3-28
⚡立即尝试HTTP
⚡立即尝试Websocket
联系客服请点击右下角
1、快速开始-接入指南
1.1、注册key
访问官网快速注册key:
使用邮箱注册后会得到key相关信息一定要注意保存好，下面的步骤中将要使用。
1.2、查看一些枚举定义
1.2.1、K线类型
1.2.2、交易方向
1.2.3、美股交易时段类型
1.3、查看各类交易品种的编码和交易时间
1.4、请求Http接口
把key加入到URL参数中或者请求头中使用key字段填充，然后根据http的各个接口定义的参数就可以获取数据了。
1.4.1、http协议接入说明
1.4.2、获取交易品种的基础信息
1.4.3、获取交易品种的实时行情快照
1.4.4、获取交易品种的实时最新盘口深度
1.4.5、获取交易品种的实时最新逐笔成交明细
1.4.6、获取交易品种的K线
1.4.7、获取交易品种的K线-历史
1.5、通过Webscoket订阅或者请求实时数据接口
把key加入到URL参数中或者请求头中使用key字段填充，然后建立websocket连接，发送相应的订阅命令，并保持心跳就可以得到实时报价了
1.5.0、websocket协议接入说明
1.5.1、心跳
1.5.2、订阅交易品种的实时快照
1.5.3、订阅交易品种的实时逐口成交明细
1.5.4、订阅交易品种的实时盘口
1.5.5、订阅交易品种的K线
1.5.6、请求交易品种的实时快照
1.5.7、请求交易品种的实时逐口成交明细
1.5.8、请求交易品种的实时盘口
1.5.9、请求交易品种的K线
1.5.10、请求交易品种的K线历史
1.5.11、请求交易品种的基础信息
2、一些枚举定义
2.1、K线类型
| 枚举常量 | 值 |
|---|---|
| min1 | 1 |
| min5 | 5 |
| min15 | 15 |
| min30 | 30 |
| hour1 | 60 |
| hour2 | 120 |
| hour4 | 240 |
| day | 1001 |
| week | 1007 |
| month | 1030 |
| year | 2001 |
2.2、交易方向
| 枚举常量 | 值 |
|---|---|
| unknown | 0 |
| buy | 1 |
| sell | 2 |
2.3、美股交易时段类型
| 枚举常量 | 值 |
|---|---|
| unknown | 0 |
| 夜盘-Night Session | 1 |
| 盘前-Pre-market Session | 2 |
| 盘中-Intraday Session | 3 |
| 盘后-After-hours Session | 4 |
3、各类交易品种的编码和交易时间
| 市场代码 | 说明 | 交易时间 |
|---|---|---|
US |
美股 | 美股正常交易时间(美东部时间，ET): 开盘时间：上午 9:30 收盘时间：下午 4:00 盘前交易： 开始时间：上午 4:00 结束时间：上午 9:30 盘后交易： 开始时间：下午 4:00 结束时间：下午 8:00 夜盘交易： 开始时间：下午 8:00 结束时间：第二日上午 3:50 以上时间为美国当地时间,如果换算为其它时间时需要注意令时转换 夏令时（通常从3月的第二个星期日到11月的第一个星期日） 冬令时（通常从11月的第一个星期日到3月的第二个星期日） 转换为UTC+8冬令开市是22点30分，夏令开市是21点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 |
CF |
加密货币永续合约 | 24小时 |
4、http协议接口定义
4.0、http协议接入说明
- http基础URL：
https://qos.hk - 请求Url: 基础url+各个接口的地址
- 错误码说明：msg字段返回"OK"视为成功，非"OK"则是具体的错误描述
- 格式：所有请求和响应均为 JSON 格式。
- 请求方式：所有http请求统一为POST方法。
- 认证方式：URL参数或者请求头添加key字段
请求时只需要把key放在请求头中或者URL参数中，填充key字段就可以了。其它请求参数以json格式放在Body中。
4.0.1、请求头或者URL参数
| 参数 | 类型 | 描述 |
|---|---|---|
key |
string | 注册时返回的API key值 |
4.0.2、限制说明
会根据套餐情况限制订阅的产品个数和请求频率，默认是10个产品，每分钟10次请求，可以联系客服根据不同套餐进行调整。
4.1、注册一个新的Key
请移步至官网主页面进行在线注册：https://qos.hk
4.2、获取交易品种的基础信息
- 接口地址：
/instrument-info - 请求方式：
POST - 接口描述：获取交易品种的基础信息
4.2.1、请求参数(Body)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
codes |
array | 是 | 交易品种列表数组，传入细节请看下面请求示例 |
4.2.2、请求示例(Body)
{
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,600518",
"SZ:000001,002594",
"CF:BTCUSDT,ETHUSDT"
]
}
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": "HK:700",
"e": "SEHK",
"tc": "HKD",
"nc": "腾讯控股",
"ne": "TENCENT",
"ls": 100,
"ts": 9178822571,
"os": 9178822571,
"ep": "13.8513523179",
"na": "110.2507143217",
"dy": "3.4891482482"
},
{
"c": "SH:600519",
"e": "SSE",
"tc": "CNY",
"nc": "贵州茅台",
"ne": "Moutai",
"ls": 100,
"ts": 1256197800,
"os": 1256197800,
"ep": "59.49",
"na": "189.2293196185",
"dy": "54.758"
},
{
"c": "US:AAPL",
"e": "NASD",
"tc": "USD",
"nc": "苹果",
"ne": "Apple Inc.",
"ls": 1,
"ts": 15022073000,
"os": 14998202926,
"ep": "6.2398844687",
"na": "4.4439938483",
"dy": "1"
},
{
"c": "US:TSLA",
"e": "NASD",
"tc": "USD",
"nc": "特斯拉",
"ne": "Tesla, Inc.",
"ls": 1,
"ts": 3216517037,
"os": 2799672511,
"ep": "2.2166834243",
"na": "22.6683083476",
"dy": "0"
},
{
"c": "HK:9988",
"e": "SEHK",
"tc": "HKD",
"nc": "阿里巴巴-W",
"ne": "BABA-W",
"ls": 100,
"ts": 19008233516,
"os": 19008233516,
"ep": "4.6275184269",
"na": "56.8746237928",
"dy": "1.649298669"
},
{
"c": "SZ:002594",
"e": "SZSE",
"tc": "CNY",
"nc": "比亚迪",
"ne": "BYD",
"ls": 100,
"ts": 3039065855,
"os": 1811265855,
"ep": "10.32",
"na": "51.1546641032",
"dy": "2.9654648599"
},
{
"c": "SH:600518",
"e": "SSE",
"tc": "CNY",
"nc": "康美药业",
"ne": "KMYY",
"ls": 100,
"ts": 13863866690,
"os": 13612928105,
"ep": "0.01",
"na": "0.5079295503",
"dy": "0"
},
{
"c": "CF:ETHUSDT",
"e": "Crypto Perpetual Contract",
"tc": "USDT"
},
{
"c": "CF:BTCUSDT",
"e": "Crypto Perpetual Contract",
"tc": "USDT"
},
{
"c": "SZ:000001",
"e": "SZSE",
"tc": "CNY",
"nc": "平安银行",
"ne": "PAB",
"ls": 100,
"ts": 19405918198,
"os": 19405762053,
"ep": "2.247036",
"na": "21.6699357232",
"dy": "0.965"
}
]
}
4.3、获取交易品种的实时行情快照
- 接口地址：
/snapshot - 请求方式：
POST - 接口描述：获取交易品种的实时行情快照
4.3.1、请求参数(Body)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
codes |
array | 是 | 交易品种列表数组，传入细节请看下面请求示例 |
4.3.2、请求示例(Body)
{
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,600518",
"SZ:000001,002594",
"CF:BTCUSDT,ETHUSDT"
]
}
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表示停牌） |
pq |
object | 美股盘前快照数据，定义见下面 |
aq |
object | 美股盘后快照数据，定义见下面 |
nq |
object | 美股夜盘快照数据，定义见下面 |
tt |
integer | 美股交易时段类型，定义参看2.3章节美股交易时段类型 |
| 字段名称 | 类型 | 描述 |
|---|---|---|
lp |
string | 当前价格 |
yp |
string | 上次收盘价 |
h |
string | 最高价 |
l |
string | 最低价 |
ts |
integer | 时间戳-单位秒 |
v |
string | 成交量 |
t |
string | 成交金额 |
4.3.4、响应示例
{
"msg": "OK",
"data": [
{
"c": "SH:600519",
"lp": "1628.01",
"yp": "1537.77",
"o": "1547.66",
"h": "1628.01",
"l": "1541",
"ts": 1741935600,
"v": "92913",
"t": "14882842708",
"s": 0
},
{
"c": "US:AAPL",
"lp": "211.103",
"yp": "216.98",
"o": "210.71",
"h": "210.88",
"l": "209.6",
"ts": 1741958321,
"v": "701504",
"t": "147479220.1710000038",
"s": 0,
"pq": {
"lp": "215.98",
"ts": 1741872600,
"v": "370456",
"t": "80089373.5069999993",
"h": "216.98",
"l": "215.06",
"yp": "216.98"
},
"aq": {
"lp": "210.35",
"ts": 1741910230,
"v": "2975239",
"t": "624035747.6239999533",
"h": "210.88",
"l": "209.6",
"yp": "209.68"
}
},
{
"c": "US:TSLA",
"lp": "246.104",
"yp": "248.09",
"o": "243.36",
"h": "242.27",
"l": "239.24",
"ts": 1741958323,
"v": "1491898",
"t": "364182449.1850000024",
"s": 0,
"pq": {
"lp": "248.16",
"ts": 1741872600,
"v": "2386811",
"t": "588452692.8420000076",
"h": "250.35",
"l": "242.25",
"yp": "248.09"
},
"aq": {
"lp": "241.325",
"ts": 1741910236,
"v": "1983968",
"t": "477821172.7369999886",
"h": "242.27",
"l": "239.24",
"yp": "240.68"
}
},
{
"c": "HK:9988",
"lp": "135.8",
"yp": "131.5",
"o": "134.5",
"h": "137.6",
"l": "132.8",
"ts": 1741939708,
"v": "108673140",
"t": "14720179876.3500003815",
"s": 0
},
{
"c": "SZ:002594",
"lp": "375.94",
"yp": "354.5",
"o": "357",
"h": "377.18",
"l": "355.62",
"ts": 1741935600,
"v": "224697",
"t": "8292987453.8599996567",
"s": 0
},
{
"c": "SZ:000001",
"lp": "11.97",
"yp": "11.84",
"o": "11.82",
"h": "12",
"l": "11.82",
"ts": 1741935600,
"v": "1722418",
"t": "2057970454.4000000954",
"s": 0
},
{
"c": "HK:700",
"lp": "521.5",
"yp": "507.5",
"o": "513",
"h": "531",
"l": "507.5",
"ts": 1741939708,
"v": "30711707",
"t": "16031719897.3950004578",
"s": 0
},
{
"c": "CF:ETHUSDT",
"lp": "1898.24",
"o": "1903.01",
"h": "1908.20",
"l": "1820.20",
"ts": 1741958323,
"v": "3888386.123",
"t": "7279502879.43",
"s": 0
},
{
"c": "CF:BTCUSDT",
"lp": "83326.10",
"o": "82622.60",
"h": "83538.00",
"l": "79903.40",
"ts": 1741958323,
"v": "231872.088",
"t": "18927958320.32",
"s": 0
},
{
"c": "SH:600518",
"lp": "2.18",
"yp": "2.15",
"o": "2.14",
"h": "2.18",
"l": "2.14",
"ts": 1741935600,
"v": "1829039",
"t": "395823012",
"s": 0
}
]
}
4.4、获取交易品种的实时最新盘口深度
- 接口地址：
/depth - 请求方式：
POST - 接口描述：获取交易品种的实时最新盘口深度
4.4.1、请求参数(Body)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
codes |
array | 是 | 交易品种列表数组，传入细节请看下面请求示例 |
4.4.2、请求示例(Body)
{
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,600518",
"SZ:000001,002594",
"CF:BTCUSDT,ETHUSDT"
]
}
4.4.3、响应结果
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
b |
array | 买单数组 |
> p |
string | 买单价格 |
> v |
string | 买单数量 |
a |
array | 卖单数组 |
> p |
string | 卖单价格 |
> v |
string | 卖单数量 |
ts |
integer | 时间戳-单位秒 |
4.4.4、响应示例
{
"msg": "OK",
"data": [
{
"c": "SZ:002594",
"b": [
{
"p": "375.94",
"v": "258"
},
{
"p": "375.93",
"v": "5"
},
{
"p": "375.91",
"v": "4"
},
{
"p": "375.9",
"v": "5"
},
{
"p": "375.89",
"v": "1"
}
],
"a": [
{
"p": "376",
"v": "65"
},
{
"p": "376.04",
"v": "1"
},
{
"p": "376.06",
"v": "2"
},
{
"p": "376.08",
"v": "1"
},
{
"p": "376.1",
"v": "9"
}
],
"ts": 1741958378
},
{
"c": "US:TSLA",
"b": [
{
"p": "245.9",
"v": "20"
}
],
"a": [
{
"p": "246",
"v": "1040"
}
],
"ts": 1741958378
},
{
"c": "SZ:000001",
"b": [
{
"p": "11.97",
"v": "4460"
},
{
"p": "11.96",
"v": "19581"
},
{
"p": "11.95",
"v": "6701"
},
{
"p": "11.94",
"v": "5378"
},
{
"p": "11.93",
"v": "6165"
}
],
"a": [
{
"p": "11.98",
"v": "18070"
},
{
"p": "11.99",
"v": "23478"
},
{
"p": "12",
"v": "82766"
},
{
"p": "12.01",
"v": "23966"
},
{
"p": "12.02",
"v": "13333"
}
],
"ts": 1741958378
},
{
"c": "SH:600518",
"b": [
{
"p": "2.17",
"v": "81062"
},
{
"p": "2.16",
"v": "119137"
},
{
"p": "2.15",
"v": "113072"
},
{
"p": "2.14",
"v": "66228"
},
{
"p": "2.13",
"v": "42995"
}
],
"a": [
{
"p": "2.18",
"v": "194574"
},
{
"p": "2.19",
"v": "135127"
},
{
"p": "2.2",
"v": "158599"
},
{
"p": "2.21",
"v": "67378"
},
{
"p": "2.22",
"v": "58428"
}
],
"ts": 1741958378
},
{
"c": "US:AAPL",
"b": [
{
"p": "211.12",
"v": "1"
}
],
"a": [
{
"p": "211.16",
"v": "400"
}
],
"ts": 1741958378
},
{
"c": "HK:700",
"b": [
{
"p": "521.5",
"v": "197500"
},
{
"p": "521",
"v": "199200"
},
{
"p": "520.5",
"v": "260300"
},
{
"p": "520",
"v": "663700"
},
{
"p": "519.5",
"v": "43000"
},
{
"p": "519",
"v": "144100"
},
{
"p": "518.5",
"v": "94900"
},
{
"p": "518",
"v": "145100"
},
{
"p": "517.5",
"v": "16000"
},
{
"p": "517",
"v": "49700"
}
],
"a": [
{
"p": "522",
"v": "100"
},
{
"p": "522.5",
"v": "100"
},
{
"p": "523",
"v": "10800"
},
{
"p": "523.5",
"v": "100"
},
{
"p": "524",
"v": "700"
},
{
"p": "524.5",
"v": "128600"
},
{
"p": "525",
"v": "128400"
},
{
"p": "525.5",
"v": "77100"
},
{
"p": "526",
"v": "87100"
},
{
"p": "526.5",
"v": "86500"
}
],
"ts": 1741958378
},
{
"c": "SH:600519",
"b": [
{
"p": "1628.01",
"v": "16"
},
{
"p": "1628",
"v": "28"
},
{
"p": "1627.99",
"v": "1"
},
{
"p": "1627.87",
"v": "1"
},
{
"p": "1627.61",
"v": "1"
}
],
"a": [
{
"p": "1628.02",
"v": "4"
},
{
"p": "1628.03",
"v": "0"
},
{
"p": "1628.05",
"v": "2"
},
{
"p": "1628.08",
"v": "4"
},
{
"p": "1628.09",
"v": "1"
}
],
"ts": 1741958378
},
{
"c": "HK:9988",
"b": [
{
"p": "135.8",
"v": "45500"
},
{
"p": "135.7",
"v": "606300"
},
{
"p": "135.6",
"v": "199600"
},
{
"p": "135.5",
"v": "233400"
},
{
"p": "135.4",
"v": "216200"
},
{
"p": "135.3",
"v": "160800"
},
{
"p": "135.2",
"v": "569900"
},
{
"p": "135.1",
"v": "167500"
},
{
"p": "135",
"v": "1663500"
},
{
"p": "134.9",
"v": "160400"
}
],
"a": [
{
"p": "135.9",
"v": "310000"
},
{
"p": "136",
"v": "355500"
},
{
"p": "136.1",
"v": "48500"
},
{
"p": "136.2",
"v": "377700"
},
{
"p": "136.3",
"v": "51600"
},
{
"p": "136.4",
"v": "235500"
},
{
"p": "136.5",
"v": "148500"
},
{
"p": "136.6",
"v": "220100"
},
{
"p": "136.7",
"v": "257200"
},
{
"p": "136.8",
"v": "298100"
}
],
"ts": 1741958378
},
{
"c": "CF:BTCUSDT",
"b": [
{
"p": "83349.90",
"v": "11.377"
},
{
"p": "83349.80",
"v": "0.204"
},
{
"p": "83349.70",
"v": "0.002"
},
{
"p": "83349.60",
"v": "0.048"
},
{
"p": "83349.00",
"v": "0.048"
},
{
"p": "83348.80",
"v": "0.050"
},
{
"p": "83348.60",
"v": "0.002"
},
{
"p": "83348.00",
"v": "0.058"
},
{
"p": "83347.80",
"v": "0.002"
},
{
"p": "83347.60",
"v": "0.228"
},
{
"p": "83347.10",
"v": "0.004"
},
{
"p": "83346.90",
"v": "0.002"
},
{
"p": "83346.80",
"v": "0.048"
},
{
"p": "83346.70",
"v": "0.002"
},
{
"p": "83346.60",
"v": "0.409"
},
{
"p": "83346.40",
"v": "0.048"
},
{
"p": "83346.10",
"v": "0.004"
},
{
"p": "83346.00",
"v": "0.654"
},
{
"p": "83345.90",
"v": "0.146"
},
{
"p": "83345.80",
"v": "0.140"
}
],
"a": [
{
"p": "83350.00",
"v": "1.832"
},
{
"p": "83350.10",
"v": "0.002"
},
{
"p": "83350.20",
"v": "0.015"
},
{
"p": "83350.40",
"v": "0.002"
},
{
"p": "83350.60",
"v": "0.063"
},
{
"p": "83350.80",
"v": "0.002"
},
{
"p": "83351.00",
"v": "0.002"
},
{
"p": "83351.20",
"v": "0.002"
},
{
"p": "83351.80",
"v": "0.002"
},
{
"p": "83352.00",
"v": "0.002"
},
{
"p": "83352.50",
"v": "0.002"
},
{
"p": "83352.60",
"v": "0.002"
},
{
"p": "83352.70",
"v": "0.002"
},
{
"p": "83353.00",
"v": "0.002"
},
{
"p": "83353.10",
"v": "0.002"
},
{
"p": "83353.20",
"v": "0.363"
},
{
"p": "83353.30",
"v": "0.527"
},
{
"p": "83353.40",
"v": "0.002"
},
{
"p": "83353.50",
"v": "0.002"
},
{
"p": "83353.70",
"v": "0.005"
}
],
"ts": 1741958378
},
{
"c": "CF:ETHUSDT",
"b": [
{
"p": "1899.65",
"v": "251.119"
},
{
"p": "1899.64",
"v": "0.034"
},
{
"p": "1899.63",
"v": "5.214"
},
{
"p": "1899.62",
"v": "13.234"
},
{
"p": "1899.61",
"v": "13.173"
},
{
"p": "1899.60",
"v": "6.532"
},
{
"p": "1899.59",
"v": "5.791"
},
{
"p": "1899.58",
"v": "10.863"
},
{
"p": "1899.57",
"v": "5.809"
},
{
"p": "1899.56",
"v": "0.844"
},
{
"p": "1899.55",
"v": "3.688"
},
{
"p": "1899.54",
"v": "0.036"
},
{
"p": "1899.52",
"v": "2.655"
},
{
"p": "1899.51",
"v": "2.118"
},
{
"p": "1899.50",
"v": "27.446"
},
{
"p": "1899.49",
"v": "0.090"
},
{
"p": "1899.48",
"v": "3.388"
},
{
"p": "1899.47",
"v": "0.579"
},
{
"p": "1899.46",
"v": "22.098"
},
{
"p": "1899.45",
"v": "8.447"
}
],
"a": [
{
"p": "1899.66",
"v": "0.386"
},
{
"p": "1899.68",
"v": "0.168"
},
{
"p": "1899.70",
"v": "0.011"
},
{
"p": "1899.72",
"v": "0.058"
},
{
"p": "1899.73",
"v": "0.080"
},
{
"p": "1899.74",
"v": "0.037"
},
{
"p": "1899.75",
"v": "2.526"
},
{
"p": "1899.76",
"v": "0.053"
},
{
"p": "1899.77",
"v": "1.000"
},
{
"p": "1899.78",
"v": "0.022"
},
{
"p": "1899.79",
"v": "1.011"
},
{
"p": "1899.80",
"v": "19.269"
},
{
"p": "1899.81",
"v": "45.746"
},
{
"p": "1899.82",
"v": "0.551"
},
{
"p": "1899.83",
"v": "0.027"
},
{
"p": "1899.84",
"v": "0.153"
},
{
"p": "1899.85",
"v": "0.848"
},
{
"p": "1899.86",
"v": "2.139"
},
{
"p": "1899.87",
"v": "0.074"
},
{
"p": "1899.88",
"v": "3.014"
}
],
"ts": 1741958378
}
]
}
4.5、获取交易品种的实时最新逐笔成交明细
- 接口地址：
/trade - 请求方式：
POST - 接口描述：获取交易品种的实时最新逐笔成交明细
4.5.1、请求参数(Body)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
codes |
array | 是 | 交易品种列表数组，传入细节请看下面请求示例 |
count |
integer | 是 | 请求的最近多少条，此数值不能超过50 |
4.5.2、请求示例(Body)
{
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,600518",
"SZ:000001,002594",
"CF:BTCUSDT,ETHUSDT"
],
"count": 1
}
4.5.3、响应结果
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
p |
string | 当前价格 |
v |
string | 当前成交量 |
ts |
integer | 时间戳-单位秒 |
d |
integer | 交易方向，具体定义参看2.2章节 |
4.5.4、响应示例
{
"msg": "OK",
"data": [
{
"c": "CF:ETHUSDT",
"p": "1900.73",
"v": "0.025",
"ts": 1741958480,
"d": 1
},
{
"c": "CF:BTCUSDT",
"p": "83429.70",
"v": "0.025",
"ts": 1741958479,
"d": 2
},
{
"c": "HK:700",
"p": "521.5",
"v": "2027400",
"ts": 1741939708,
"d": 0
},
{
"c": "US:TSLA",
"p": "246.039",
"v": "10",
"ts": 1741958480,
"d": 0
},
{
"c": "SZ:002594",
"p": "375.94",
"v": "3778",
"ts": 1741935600,
"d": 1
},
{
"c": "US:AAPL",
"p": "211.223",
"v": "1",
"ts": 1741958478,
"d": 0
},
{
"c": "SH:600519",
"p": "1628.01",
"v": "1581",
"ts": 1741935600,
"d": 1
},
{
"c": "SH:600518",
"p": "2.18",
"v": "31067",
"ts": 1741935600,
"d": 1
},
{
"c": "HK:9988",
"p": "135.8",
"v": "5944400",
"ts": 1741939708,
"d": 0
},
{
"c": "SZ:000001",
"p": "11.97",
"v": "24450",
"ts": 1741935600,
"d": 1
}
]
}
4.6、获取交易品种的K线
- 接口地址：
/kline - 请求方式：
POST - 接口描述：获取交易品种的K线，从最近开始向前推多少根的K线。
4.6.1、请求参数(Body)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
kline_reqs |
array | 是 | K线请求数组 |
> c |
string | 是 | 股票代码，多个股票代码用逗号分隔 |
> co |
integer | 是 | Count 请求多少根,默认可以请求所有类型最近1000根K线，需要更多历史K线数据请联系客服另外提供。 |
> a |
integer | 是 | 复权类型 0:不复权 1:前复权 |
> kt |
integer | 是 | K线类型，取值参看2.1章节K线类型定义 |
4.6.2、请求示例(Body)
{
"kline_reqs": [
{
"c": "US:AAPL,TSLA",
"co": 1,
"a": 0,
"kt": 1001
},
{
"c": "HK:700,9988",
"co": 1,
"a": 0,
"kt": 1001
},{
"c": "SH:600519,600518",
"co": 1,
"a": 0,
"kt": 1001
},{
"c": "CF:BTCUSDT,ETHUSDT",
"co": 1,
"a": 0,
"kt": 1001
}
]
}
4.6.3、响应结果
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
k |
array | K线数据数组 |
> o |
string | 开盘价 |
> cl |
string | 收盘价 |
> h |
string | 最高价 |
> l |
string | 最低价 |
> v |
string | 成交量 |
> ts |
integer | 时间戳-单位秒 |
> kt |
integer | K线类型，取值参看2.1章节K线类型定义 |
4.6.4、响应示例
{
"msg": "OK",
"data": [
{
"c": "SH:600519",
"k": [
{
"c": "SH:600519",
"o": "1547.66",
"cl": "1628.01",
"h": "1628.01",
"l": "1541",
"v": "91332",
"ts": 1741881600,
"kt": 1001
}
]
},
{
"c": "US:TSLA",
"k": [
{
"c": "US:TSLA",
"o": "247.31",
"cl": "249.805",
"h": "249.86",
"l": "246.111",
"v": "8356767",
"ts": 1741924800,
"kt": 1001
}
]
},
{
"c": "US:AAPL",
"k": [
{
"c": "US:AAPL",
"o": "211.25",
"cl": "212.8",
"h": "213.43",
"l": "211.25",
"v": "4827801",
"ts": 1741924800,
"kt": 1001
}
]
},
{
"c": "HK:9988",
"k": [
{
"c": "HK:9988",
"o": "134.5",
"cl": "135.8",
"h": "137.6",
"l": "132.8",
"v": "108673140",
"ts": 1741881600,
"kt": 1001
}
]
},
{
"c": "CF:ETHUSDT",
"k": [
{
"c": "CF:ETHUSDT",
"o": "1863.75",
"cl": "1908.41",
"h": "1912.14",
"l": "1860.41",
"v": "1384521.330",
"ts": 1741910400,
"kt": 1001
}
]
},
{
"c": "CF:BTCUSDT",
"k": [
{
"c": "CF:BTCUSDT",
"o": "81085.50",
"cl": "83723.30",
"h": "83771.80",
"l": "80772.00",
"v": "92544.973",
"ts": 1741910400,
"kt": 1001
}
]
},
{
"c": "HK:700",
"k": [
{
"c": "HK:700",
"o": "513",
"cl": "521.5",
"h": "531",
"l": "507.5",
"v": "30711707",
"ts": 1741881600,
"kt": 1001
}
]
},
{
"c": "SH:600518",
"k": [
{
"c": "SH:600518",
"o": "2.14",
"cl": "2.18",
"h": "2.18",
"l": "2.14",
"v": "1829039",
"ts": 1741881600,
"kt": 1001
}
]
}
]
}
4.7、获取交易品种的K线历史
- 接口地址：
/history - 请求方式：
POST - 接口描述：获取交易品种的历史K线，从传入的结束时间向前推多少根的K线。
4.7.1、请求参数(Body)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
kline_reqs |
array | 是 | K线请求数组 |
> c |
string | 是 | 股票代码，多个股票代码用逗号分隔 |
> co |
integer | 是 | Count 请求多少根,默认可以请求所有类型最近1000根K线，需要更多历史K线数据请联系客服另外提供。 |
> a |
integer | 是 | 复权类型 0:不复权 1:前复权 |
> kt |
integer | 是 | K线类型，取值参看2.1章节K线类型定义 |
> e |
integer | 是 | 请求K线的结束时间戳，单位秒,忽略此字段，需要更多历史K线数据请联系客服另外提供。 |
4.7.2、请求示例(Body)
{
"kline_reqs": [
{
"c": "CF:BTCUSDT",
"e": 1741959608,
"co": 1,
"a": 0,
"kt": 1001
},
{
"c": "US:AAPL",
"e": 1741959608,
"co": 1,
"a": 0,
"kt": 1001
}
]
}
4.7.3、响应结果
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
k |
array | K线数据数组 |
> o |
string | 开盘价 |
> cl |
string | 收盘价 |
> h |
string | 最高价 |
> l |
string | 最低价 |
> v |
string | 成交量 |
> ts |
integer | 时间戳-单位秒 |
> kt |
integer | K线类型，取值参看2.1章节K线类型定义 |
4.7.4、响应示例
{
"msg": "OK",
"data": [
{
"c": "US:AAPL",
"k": [
{
"c": "US:AAPL",
"o": "211.29",
"cl": "213",
"h": "213.43",
"l": "211.25",
"v": "5848917",
"ts": 1741924800,
"kt": 1001
}
]
},
{
"c": "CF:BTCUSDT",
"k": [
{
"c": "CF:BTCUSDT",
"o": "81085.50",
"cl": "83399.10",
"h": "83771.80",
"l": "80772.00",
"v": "93898.117",
"ts": 1741910400,
"kt": 1001
}
]
}
]
}
5、websocket协议接口定义
5.0、websocket协议接入说明
- websocket地址：
wss://qos.hk/ws - 错误码说明：msg字段返回"OK"视为成功，非"OK"则是具体的错误描述
- 格式：所有请求和响应均为 JSON 格式。
- 认证方式：URL参数或者请求头添加key字段
建立连接时只需要把key放在URL参数中或者请求头中，填充key字段就可以了，建立连接后就可以开始发送心跳、订阅实时快照、订阅实时报价、订阅实时成交价格、订阅K线。
5.0.1、请求头或者URL参数
| 参数 | 类型 | 描述 |
|---|---|---|
key |
string | 注册返回的API key值 |
5.0.2、限制说明
会根据套餐情况限制订阅的产品个数和建立连接的个数，默认是10个产品，1一个连接，可以联系客服根据不同套餐进行调整。特别注意：向服务器发送请求的频率要求每条请求最少间隔1秒。
5.1、心跳
要求每10-30秒发一次即可
5.1.1、发送心跳
{"type":"H"}
5.1.2、心跳响应
{
"type": "H",
"msg": "OK",
"time": 1742046368
}
5.2、订阅交易品种的实时快照
5.2.1、发送订阅命令
| 字段名称 | 值 |
|---|---|
type |
订阅类型填S,取消订阅填SC |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.2.2、订阅命令示例
{
"type": "S",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.2.3、订阅命令返回
{
"type": "S",
"msg": "OK",
"time": 1731650860,
"reqid":1
}
5.2.4、取消订阅命令示例
{
"type": "SC",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.2.5、取消订阅命令返回
{
"type": "SC",
"msg": "OK",
"time": 1731650871,
"reqid":1
}
5.2.6、数据推送
| 字段名称 | 类型 | 描述 |
|---|---|---|
tp |
string | 数据类型S表示行情快照数据 |
c |
string | 股票代码 |
lp |
string | 当前价格 |
yp |
string | 昨日收盘价 |
o |
string | 开盘价 |
h |
string | 最高价 |
l |
string | 最低价 |
ts |
integer | 时间戳-单位秒 |
v |
string | 成交量 |
t |
string | 成交金额 |
s |
integer | 是否停牌（0表示未停牌，1表示停牌） |
tt |
integer | 美股交易时段类型，定义参看2.3章节美股交易时段类型 |
5.2.7、数据推送示例
{
"tp": "S",
"c": "SH:600938",
"lp": "25.92",
"yp": "26.15",
"o": "26.19",
"h": "26.19",
"l": "25.62",
"ts": 1731650869,
"v": "694420",
"t": "1793887058",
"s": 0
}
5.3、订阅交易品种的实时逐口成交明细
5.3.1、发送订阅命令
| 字段名称 | 值 |
|---|---|
type |
订阅类型填T,取消订阅填TC |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.3.2、订阅命令示例
{
"type": "T",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.3.3、订阅命令返回
{
"type": "T",
"msg": "OK",
"time": 1731650860,
"reqid":1
}
5.3.4、取消订阅命令示例
{
"type": "TC",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.3.5、取消订阅命令返回
{
"type": "TC",
"msg": "OK",
"time": 1731650871,
"reqid":1
}
5.3.6、数据推送
| 字段名称 | 类型 | 描述 |
|---|---|---|
tp |
string | 数据类型T表示成交数据 |
c |
string | 股票代码 |
p |
string | 当前价格 |
v |
string | 当前成交量 |
ts |
integer | 时间戳-单位秒 |
d |
integer | 交易方向，具体定义参看2.2章节 |
5.3.7、数据推送示例
{
"tp": "T",
"c": "US:TSLA",
"p": "246.39",
"v": "100",
"ts": 1741960243,
"d": 1
}
5.4、订阅交易品种的实时盘口
5.4.1、发送订阅命令
| 字段名称 | 值 |
|---|---|
type |
订阅类型填D,取消订阅填DC |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.4.2、订阅命令示例
{
"type": "D",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.4.3、订阅命令返回
{
"type": "D",
"msg": "OK",
"time": 1731650860,
"reqid":1
}
5.4.4、取消订阅命令示例
{
"type": "DC",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.4.5、取消订阅命令返回
{
"type": "DC",
"msg": "OK",
"time": 1731650871,
"reqid":1
}
5.4.6、数据推送
| 字段名称 | 类型 | 描述 |
|---|---|---|
tp |
string | 数据类型D表示盘口深度 |
c |
string | 股票代码 |
b |
array | 买单数组 |
> p |
string | 买单价格 |
> v |
string | 买单数量 |
a |
array | 卖单数组 |
> p |
string | 卖单价格 |
> v |
string | 卖单数量 |
ts |
integer | 时间戳-单位秒 |
5.4.7、数据推送示例
{
"tp": "D",
"c": "US:AAPL",
"b": [
{
"p": "212.62",
"v": "110"
}
],
"a": [
{
"p": "212.66",
"v": "338"
}
],
"ts": 1741960347
}
5.5、订阅交易品种的实时K线
5.5.1、发送订阅命令
| 字段名称 | 值 |
|---|---|
type |
订阅类型填D,取消订阅填DC |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
kt |
integer K线类型，取值参看2.1章节K线类型定义 |
5.5.2、订阅命令示例
{
"type": "K",
"codes": [
"CF:BTCUSDT,ETHUSDT"
],
"kt":1001,
"reqid":1
}
5.5.3、订阅命令返回
{
"type": "K",
"msg": "OK",
"time": 1731650860,
"reqid":1
}
5.5.4、取消订阅命令示例
{
"type": "KC",
"codes": [
"CF:BTCUSDT,ETHUSDT"
],
"kt":1001,
"reqid":1
}
5.5.5、取消订阅命令返回
{
"type": "KC",
"msg": "OK",
"time": 1741960736,
"reqid":1
}
5.5.6、数据推送
| 字段名称 | 类型 | 描述 |
|---|---|---|
tp |
string | 数据类型K表示K线 |
c |
string | 股票代码 |
o |
string | 开盘价 |
cl |
string | 收盘价 |
h |
string | 最高价 |
l |
string | 最低价 |
v |
string | 成交量 |
ts |
integer | 时间戳-单位秒 |
kt |
integer | K线类型，取值参看2.1章节K线类型定义 |
5.5.7、数据推送示例
{
"tp": "K",
"c": "CF:BTCUSDT",
"o": "81085.50",
"cl": "83504.10",
"h": "83856.00",
"l": "80772.00",
"v": "103162.630",
"ts": 1741910400,
"kt": 1001
}
5.6、请求交易品种的实时快照
5.6.1、发送请求命令
| 字段名称 | 值 |
|---|---|
type |
请求类型：RS,响应的type也是RS |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.6.2、请求命令示例
{
"type": "RS",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.6.3、响应数据
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
lp |
string | 当前价格 |
yp |
string | 昨日收盘价 |
o |
string | 开盘价 |
h |
string | 最高价 |
l |
string | 最低价 |
ts |
integer | 时间戳-单位秒 |
v |
string | 成交量 |
t |
string | 成交金额 |
s |
integer | 是否停牌（0表示未停牌，1表示停牌） |
pq |
object | 美股盘前快照数据，定义见下面 |
aq |
object | 美股盘后快照数据，定义见下面 |
nq |
object | 美股夜盘快照数据，定义见下面 |
tt |
integer | 美股交易时段类型，定义参看2.3章节美股交易时段类型 |
| 字段名称 | 类型 | 描述 |
|---|---|---|
lp |
string | 当前价格 |
yp |
string | 上次收盘价 |
h |
string | 最高价 |
l |
string | 最低价 |
ts |
integer | 时间戳-单位秒 |
v |
string | 成交量 |
t |
string | 成交金额 |
5.6.4、响应数据示例
{
"type": "RS",
"msg": "OK",
"reqid": 1,
"data": [
{
"c": "HK:700",
"lp": "521.5",
"yp": "507.5",
"o": "513",
"h": "531",
"l": "507.5",
"ts": 1741939710,
"v": "30711707",
"t": "16031719897",
"s": 0
},
{
"c": "SZ:000001",
"lp": "11.97",
"yp": "11.84",
"o": "11.82",
"h": "12",
"l": "11.82",
"ts": 1741935600,
"v": "1722418",
"t": "2057970454.4000000954",
"s": 0
},
{
"c": "SZ:002594",
"lp": "375.94",
"yp": "354.5",
"o": "357",
"h": "377.18",
"l": "355.62",
"ts": 1741935600,
"v": "224697",
"t": "8292987453.8599996567",
"s": 0
},
{
"c": "HK:9988",
"lp": "135.8",
"yp": "131.5",
"o": "134.5",
"h": "137.6",
"l": "132.8",
"ts": 1741939710,
"v": "108673140",
"t": "14720179876",
"s": 0
},
{
"c": "US:AAPL",
"lp": "213.3",
"yp": "209.68",
"o": "213.49",
"h": "213.94",
"l": "209.58",
"ts": 1741994900,
"v": "60086076",
"t": "12765424420.7719993591",
"s": 0,
"pq": {
"lp": "211.34",
"ts": 1741959001,
"v": "785589",
"t": "165231199.5090000033",
"h": "211.83",
"l": "210.201",
"yp": "209.68"
},
"aq": {
"lp": "210.2",
"ts": 1741910397,
"v": "2959409",
"t": "620717515.6900000572",
"h": "210.88",
"l": "209.6",
"yp": "209.68"
}
},
{
"c": "SH:600519",
"lp": "1628.01",
"yp": "1537.77",
"o": "1547.66",
"h": "1628.01",
"l": "1541",
"ts": 1741935600,
"v": "92913",
"t": "14882842708",
"s": 0
},
{
"c": "US:TSLA",
"lp": "249.79",
"yp": "240.68",
"o": "249.85",
"h": "251.58",
"l": "240.74",
"ts": 1741994901,
"v": "100132131",
"t": "24755030678.8250007629",
"s": 0,
"pq": {
"lp": "247.14",
"ts": 1741959000,
"v": "1612706",
"t": "394031355.1779999733",
"h": "247.45",
"l": "242.56",
"yp": "240.68"
},
"aq": {
"lp": "241.1",
"ts": 1741910399,
"v": "1996190",
"t": "480767552.1090000272",
"h": "242.27",
"l": "239.24",
"yp": "240.68"
}
},
{
"c": "SH:688981",
"lp": "94.81",
"yp": "92.98",
"o": "92.98",
"h": "95.61",
"l": "92.5",
"ts": 1741935600,
"v": "401376",
"t": "3790992802",
"s": 0
},
{
"c": "CF:ETHUSDT",
"lp": "1918.00",
"o": "1863.19",
"h": "1945.62",
"l": "1860.41",
"ts": 1741994903,
"v": "3476304.838",
"t": "6634489059.81",
"s": 0
},
{
"c": "CF:BTCUSDT",
"lp": "84185.50",
"o": "81113.80",
"h": "85270.20",
"l": "80772.00",
"ts": 1741994901,
"v": "233257.549",
"t": "19451169797.35",
"s": 0
}
]
}
5.7、请求交易品种的实时逐口成交明细
5.7.1、发送请求命令
| 字段名称 | 值 |
|---|---|
type |
请求类型：RT,响应的type也是RT |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
count |
integer,请求的最近多少条，此数值不能超过50 |
5.7.2、请求命令示例
{
"type": "RT",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1,
"count":1
}
5.7.3、响应数据
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
p |
string | 当前价格 |
v |
string | 当前成交量 |
ts |
integer | 时间戳-单位秒 |
d |
integer | 交易方向，具体定义参看2.2章节 |
5.7.4、响应数据示例
{
"type": "RT",
"msg": "OK",
"reqid": 1,
"data": [
{
"c": "CF:ETHUSDT",
"p": "1913.68",
"v": "0.050",
"ts": 1741997836,
"d": 1
},
{
"c": "CF:BTCUSDT",
"p": "84135.00",
"v": "0.005",
"ts": 1741997836,
"d": 1
},
{
"c": "US:TSLA",
"p": "249.83",
"v": "4",
"ts": 1741996798,
"d": 0
},
{
"c": "US:AAPL",
"p": "213.35",
"v": "1",
"ts": 1741996798,
"d": 1
}
]
}
5.8、请求交易品种的实时盘口
5.8.1、发送请求命令
| 字段名称 | 值 |
|---|---|
type |
请求类型：RD,响应的type也是RD |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.8.2、订阅命令示例
{
"type": "RD",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.8.3、响应数据
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
b |
array | 买单数组 |
> p |
string | 买单价格 |
> v |
string | 买单数量 |
a |
array | 卖单数组 |
> p |
string | 卖单价格 |
> v |
string | 卖单数量 |
ts |
integer | 时间戳-单位秒 |
5.8.7、响应数据示例
{
"type": "RD",
"msg": "OK",
"reqid": 1,
"data": [
{
"c": "US:TSLA",
"b": [
{
"p": "245.9",
"v": "20"
}
],
"a": [
{
"p": "246",
"v": "1040"
}
],
"ts": 1741958378
},
{
"c": "US:AAPL",
"b": [
{
"p": "211.12",
"v": "1"
}
],
"a": [
{
"p": "211.16",
"v": "400"
}
],
"ts": 1741958378
},
{
"c": "SH:688981",
"b": [
{
"p": "94.81",
"v": "1256"
},
{
"p": "94.8",
"v": "550"
},
{
"p": "94.79",
"v": "165"
},
{
"p": "94.78",
"v": "170"
},
{
"p": "94.77",
"v": "15"
}
],
"a": [
{
"p": "94.82",
"v": "199"
},
{
"p": "94.83",
"v": "70"
},
{
"p": "94.84",
"v": "66"
},
{
"p": "94.85",
"v": "330"
},
{
"p": "94.86",
"v": "159"
}
],
"ts": 1742047367
},
{
"c": "SZ:000001",
"b": [
{
"p": "11.97",
"v": "4460"
},
{
"p": "11.96",
"v": "19581"
},
{
"p": "11.95",
"v": "6701"
},
{
"p": "11.94",
"v": "5378"
},
{
"p": "11.93",
"v": "6165"
}
],
"a": [
{
"p": "11.98",
"v": "18070"
},
{
"p": "11.99",
"v": "23478"
},
{
"p": "12",
"v": "82766"
},
{
"p": "12.01",
"v": "23966"
},
{
"p": "12.02",
"v": "13333"
}
],
"ts": 1742047367
},
{
"c": "SH:600519",
"b": [
{
"p": "1628.01",
"v": "16"
},
{
"p": "1628",
"v": "28"
},
{
"p": "1627.99",
"v": "1"
},
{
"p": "1627.87",
"v": "1"
},
{
"p": "1627.61",
"v": "1"
}
],
"a": [
{
"p": "1628.02",
"v": "4"
},
{
"p": "1628.03",
"v": "0"
},
{
"p": "1628.05",
"v": "2"
},
{
"p": "1628.08",
"v": "4"
},
{
"p": "1628.09",
"v": "1"
}
],
"ts": 1742047367
},
{
"c": "SZ:002594",
"b": [
{
"p": "375.94",
"v": "258"
},
{
"p": "375.93",
"v": "5"
},
{
"p": "375.91",
"v": "4"
},
{
"p": "375.9",
"v": "5"
},
{
"p": "375.89",
"v": "1"
}
],
"a": [
{
"p": "376",
"v": "65"
},
{
"p": "376.04",
"v": "1"
},
{
"p": "376.06",
"v": "2"
},
{
"p": "376.08",
"v": "1"
},
{
"p": "376.1",
"v": "9"
}
],
"ts": 1742047367
},
{
"c": "HK:9988",
"b": [
{
"p": "135.8",
"v": "45500"
},
{
"p": "135.7",
"v": "606300"
},
{
"p": "135.6",
"v": "199600"
},
{
"p": "135.5",
"v": "233400"
},
{
"p": "135.4",
"v": "216200"
},
{
"p": "135.3",
"v": "160800"
},
{
"p": "135.2",
"v": "569900"
},
{
"p": "135.1",
"v": "167500"
},
{
"p": "135",
"v": "1663500"
},
{
"p": "134.9",
"v": "160400"
}
],
"a": [
{
"p": "135.9",
"v": "310000"
},
{
"p": "136",
"v": "355500"
},
{
"p": "136.1",
"v": "48500"
},
{
"p": "136.2",
"v": "377700"
},
{
"p": "136.3",
"v": "51600"
},
{
"p": "136.4",
"v": "235500"
},
{
"p": "136.5",
"v": "148500"
},
{
"p": "136.6",
"v": "220100"
},
{
"p": "136.7",
"v": "257200"
},
{
"p": "136.8",
"v": "298100"
}
],
"ts": 1742047367
},
{
"c": "HK:700",
"b": [
{
"p": "521.5",
"v": "197500"
},
{
"p": "521",
"v": "199200"
},
{
"p": "520.5",
"v": "260300"
},
{
"p": "520",
"v": "663700"
},
{
"p": "519.5",
"v": "43000"
},
{
"p": "519",
"v": "144100"
},
{
"p": "518.5",
"v": "94900"
},
{
"p": "518",
"v": "145100"
},
{
"p": "517.5",
"v": "16000"
},
{
"p": "517",
"v": "49700"
}
],
"a": [
{
"p": "522",
"v": "100"
},
{
"p": "522.5",
"v": "100"
},
{
"p": "523",
"v": "10800"
},
{
"p": "523.5",
"v": "100"
},
{
"p": "524",
"v": "700"
},
{
"p": "524.5",
"v": "128600"
},
{
"p": "525",
"v": "128400"
},
{
"p": "525.5",
"v": "77100"
},
{
"p": "526",
"v": "87100"
},
{
"p": "526.5",
"v": "86500"
}
],
"ts": 1742047367
},
{
"c": "CF:ETHUSDT",
"b": [
{
"p": "1928.17",
"v": "43.593"
},
{
"p": "1928.16",
"v": "0.029"
},
{
"p": "1928.15",
"v": "2.046"
},
{
"p": "1928.13",
"v": "0.022"
},
{
"p": "1928.11",
"v": "0.023"
},
{
"p": "1928.10",
"v": "6.507"
},
{
"p": "1928.09",
"v": "1.556"
},
{
"p": "1928.08",
"v": "0.013"
},
{
"p": "1928.07",
"v": "2.133"
},
{
"p": "1928.05",
"v": "0.508"
},
{
"p": "1928.04",
"v": "5.451"
},
{
"p": "1928.03",
"v": "8.369"
},
{
"p": "1928.02",
"v": "0.027"
},
{
"p": "1928.01",
"v": "2.698"
},
{
"p": "1928.00",
"v": "31.130"
},
{
"p": "1927.99",
"v": "20.815"
},
{
"p": "1927.98",
"v": "0.046"
},
{
"p": "1927.97",
"v": "3.022"
},
{
"p": "1927.96",
"v": "10.045"
},
{
"p": "1927.95",
"v": "2.910"
}
],
"a": [
{
"p": "1928.18",
"v": "192.359"
},
{
"p": "1928.19",
"v": "0.023"
},
{
"p": "1928.20",
"v": "6.086"
},
{
"p": "1928.21",
"v": "0.011"
},
{
"p": "1928.22",
"v": "0.012"
},
{
"p": "1928.23",
"v": "12.587"
},
{
"p": "1928.24",
"v": "0.449"
},
{
"p": "1928.25",
"v": "5.066"
},
{
"p": "1928.26",
"v": "0.023"
},
{
"p": "1928.27",
"v": "13.890"
},
{
"p": "1928.28",
"v": "8.296"
},
{
"p": "1928.29",
"v": "3.421"
},
{
"p": "1928.30",
"v": "11.516"
},
{
"p": "1928.31",
"v": "2.095"
},
{
"p": "1928.32",
"v": "0.062"
},
{
"p": "1928.33",
"v": "32.940"
},
{
"p": "1928.35",
"v": "2.307"
},
{
"p": "1928.36",
"v": "0.065"
},
{
"p": "1928.37",
"v": "41.346"
},
{
"p": "1928.38",
"v": "0.020"
}
],
"ts": 1742047367
},
{
"c": "CF:BTCUSDT",
"b": [
{
"p": "84304.90",
"v": "4.269"
},
{
"p": "84304.80",
"v": "0.004"
},
{
"p": "84304.40",
"v": "0.022"
},
{
"p": "84304.20",
"v": "0.041"
},
{
"p": "84303.70",
"v": "0.002"
},
{
"p": "84303.30",
"v": "0.050"
},
{
"p": "84303.00",
"v": "0.047"
},
{
"p": "84302.70",
"v": "0.008"
},
{
"p": "84302.50",
"v": "0.178"
},
{
"p": "84302.00",
"v": "0.002"
},
{
"p": "84301.40",
"v": "0.002"
},
{
"p": "84301.20",
"v": "0.004"
},
{
"p": "84301.10",
"v": "0.002"
},
{
"p": "84301.00",
"v": "0.047"
},
{
"p": "84300.90",
"v": "0.002"
},
{
"p": "84300.80",
"v": "0.716"
},
{
"p": "84300.60",
"v": "0.137"
},
{
"p": "84300.50",
"v": "0.005"
},
{
"p": "84300.40",
"v": "0.047"
},
{
"p": "84300.30",
"v": "0.002"
}
],
"a": [
{
"p": "84305.00",
"v": "5.340"
},
{
"p": "84305.10",
"v": "0.017"
},
{
"p": "84305.40",
"v": "0.002"
},
{
"p": "84305.50",
"v": "0.775"
},
{
"p": "84306.00",
"v": "0.061"
},
{
"p": "84306.10",
"v": "0.002"
},
{
"p": "84306.20",
"v": "0.002"
},
{
"p": "84306.30",
"v": "0.496"
},
{
"p": "84306.40",
"v": "0.062"
},
{
"p": "84306.60",
"v": "0.002"
},
{
"p": "84306.70",
"v": "0.002"
},
{
"p": "84306.80",
"v": "0.002"
},
{
"p": "84307.00",
"v": "0.002"
},
{
"p": "84307.30",
"v": "0.074"
},
{
"p": "84307.50",
"v": "0.027"
},
{
"p": "84307.60",
"v": "0.002"
},
{
"p": "84307.70",
"v": "0.004"
},
{
"p": "84307.80",
"v": "0.004"
},
{
"p": "84308.00",
"v": "0.111"
},
{
"p": "84308.10",
"v": "0.178"
}
],
"ts": 1742047367
}
]
}
5.9、请求交易品种的实时K线
5.9.1、发送请求命令
| 字段名称 | 值 |
|---|---|
type |
请求类型：RK,响应的type也是RK |
kline_reqs |
K线请求数组 |
> c |
string 股票代码，多个股票代码用逗号分隔 |
> co |
integer Count 请求多少根,默认可以请求所有类型最近1000根K线，需要更多历史K线数据请联系客服另外提供。 |
> a |
integer 复权类型 0:不复权 1:前复权 |
> kt |
integer K线类型，取值参看2.1章节K线类型定义 |
reqid |
integer 可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.9.2、请求命令示例
{
"type": "RK",
"kline_reqs": [
{
"c": "CF:BTCUSDT,ETHUSDT",
"co": 2,
"a": 0,
"kt": 1001
}
],
"reqid":1
}
5.9.3、响应数据
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
o |
string | 开盘价 |
cl |
string | 收盘价 |
h |
string | 最高价 |
l |
string | 最低价 |
v |
string | 成交量 |
ts |
integer | 时间戳-单位秒 |
kt |
integer | K线类型，取值参看2.1章节K线类型定义 |
5.9.4、响应数据示例
{
"type": "RK",
"msg": "OK",
"reqid": 1,
"data": [
{
"c": "CF:ETHUSDT",
"k": [
{
"c": "CF:ETHUSDT",
"o": "1863.75",
"cl": "1910.79",
"h": "1945.62",
"l": "1860.41",
"v": "3494472.929",
"ts": 1741910400,
"kt": 1001
},
{
"c": "CF:ETHUSDT",
"o": "1910.78",
"cl": "1928.35",
"h": "1934.77",
"l": "1902.47",
"v": "1005667.699",
"ts": 1741996800,
"kt": 1001
}
]
},
{
"c": "CF:BTCUSDT",
"k": [
{
"c": "CF:BTCUSDT",
"o": "81085.50",
"cl": "83939.80",
"h": "85270.20",
"l": "80772.00",
"v": "233544.708",
"ts": 1741910400,
"kt": 1001
},
{
"c": "CF:BTCUSDT",
"o": "83939.90",
"cl": "84295.80",
"h": "84625.00",
"l": "83564.50",
"v": "54549.786",
"ts": 1741996800,
"kt": 1001
}
]
}
]
}
5.10、请求交易品种的K线历史
5.10.1、发送请求命令
| 字段名称 | 值 |
|---|---|
type |
请求类型：RH,响应的type也是RH |
kline_reqs |
array K线请求数组 |
> c |
string 股票代码，多个股票代码用逗号分隔 |
> co |
integer Count 请求多少根,默认可以请求所有类型最近1000根K线，需要更多历史K线数据请联系客服另外提供。 |
> a |
integer 复权类型 0:不复权 1:前复权 |
> kt |
integer K线类型，取值参看2.1章节K线类型定义 |
> e |
integer 请求K线的结束时间戳，单位秒,忽略此字段，需要更多历史K线数据请联系客服另外提供。 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.10.2、请求命令示例
{
"type": "RH",
"kline_reqs": [
{
"c": "CF:BTCUSDT,ETHUSDT",
"e": 1742047133,
"co": 2,
"a": 0,
"kt": 1001
}
],
"reqid":1
}
5.10.3、响应数据
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
o |
string | 开盘价 |
cl |
string | 收盘价 |
h |
string | 最高价 |
l |
string | 最低价 |
v |
string | 成交量 |
ts |
integer | 时间戳-单位秒 |
kt |
integer | K线类型，取值参看2.1章节K线类型定义 |
5.10.4、响应数据示例
{
"type": "RH",
"msg": "OK",
"reqid": 1,
"data": [
{
"c": "CF:ETHUSDT",
"k": [
{
"c": "CF:ETHUSDT",
"o": "1863.75",
"cl": "1910.79",
"h": "1945.62",
"l": "1860.41",
"v": "3494472.929",
"ts": 1741910400,
"kt": 1001
},
{
"c": "CF:ETHUSDT",
"o": "1910.78",
"cl": "1928.73",
"h": "1934.77",
"l": "1902.47",
"v": "1004454.519",
"ts": 1741996800,
"kt": 1001
}
]
},
{
"c": "CF:BTCUSDT",
"k": [
{
"c": "CF:BTCUSDT",
"o": "81085.50",
"cl": "83939.80",
"h": "85270.20",
"l": "80772.00",
"v": "233544.708",
"ts": 1741910400,
"kt": 1001
},
{
"c": "CF:BTCUSDT",
"o": "83939.90",
"cl": "84363.90",
"h": "84625.00",
"l": "83564.50",
"v": "54354.026",
"ts": 1741996800,
"kt": 1001
}
]
}
]
}
5.11、请求交易品种的基础信息
5.11.1、发送请求命令
| 字段名称 | 值 |
|---|---|
type |
请求类型：RI,响应的type也是RI |
codes |
code列表，具体传入方式请看下面示例 |
reqid |
integer类型。可选。请求id，由客户端传入，服务器会原值返回，用于客户端自己索引一条唯一的请求和返回。客户端结合自身需要考虑是否传入合适的值。 |
5.11.2、请求命令示例
{
"type": "RI",
"codes": [
"US:AAPL,TSLA",
"HK:700,9988",
"SH:600519,688981",
"SZ:002594,000001",
"CF:BTCUSDT,ETHUSDT"
],
"reqid":1
}
5.11.3、响应数据
| 字段名称 | 类型 | 描述 |
|---|---|---|
c |
string | 股票代码 |
e |
string | 交易所 |
tc |
string | 交易币种 |
nc |
string | 中文名称 |
ne |
string | 英文名称 |
ls |
integer | 最小交易单位 |
ts |
integer | 总股本 |
os |
integer | 流通股本 |
ep |
string | 每股盈利 |
na |
string | 每股净资产 |
dy |
string | 股息率 |
5.11.4、响应数据示例
{
"type": "RI",
"msg": "OK",
"reqid": 1,
"data": [
{
"c": "US:AAPL",
"e": "NASD",
"tc": "USD",
"nc": "苹果",
"ne": "Apple Inc.",
"ls": 1,
"ts": 15022073000,
"os": 14998202926,
"ep": "6.2398844687",
"na": "4.4439938483",
"dy": "1"
},
{
"c": "SZ:000001",
"e": "SZSE",
"tc": "CNY",
"nc": "平安银行",
"ne": "PAB",
"ls": 100,
"ts": 19405918198,
"os": 19405762053,
"ep": "2.2935271367",
"na": "21.8950732279",
"dy": "0.965"
},
{
"c": "SH:600519",
"e": "SSE",
"tc": "CNY",
"nc": "贵州茅台",
"ne": "Moutai",
"ls": 100,
"ts": 1256197800,
"os": 1256197800,
"ep": "59.49",
"na": "189.2293196185",
"dy": "54.758"
},
{
"c": "SH:688981",
"e": "SSE",
"tc": "CNY",
"nc": "中芯国际",
"ne": "SMIC",
"ls": 100,
"ts": 7981135214,
"os": 1988359129,
"ep": "0.7849289306",
"na": "18.1090038102",
"dy": "0"
},
{
"c": "HK:700",
"e": "SEHK",
"tc": "HKD",
"nc": "腾讯控股",
"ne": "TENCENT",
"ls": 100,
"ts": 9178822571,
"os": 9178822571,
"ep": "13.8513523179",
"na": "110.2507143217",
"dy": "3.4891482482"
},
{
"c": "SZ:002594",
"e": "SZSE",
"tc": "CNY",
"nc": "比亚迪",
"ne": "BYD",
"ls": 100,
"ts": 3039065855,
"os": 1811265855,
"ep": "10.32",
"na": "51.1546641032",
"dy": "2.9654648599"
},
{
"c": "US:TSLA",
"e": "NASD",
"tc": "USD",
"nc": "特斯拉",
"ne": "Tesla, Inc.",
"ls": 1,
"ts": 3216517037,
"os": 2799672511,
"ep": "2.2166834243",
"na": "22.6683083476",
"dy": "0"
},
{
"c": "CF:BTCUSDT",
"e": "Crypto Perpetual Contract",
"tc": "USDT"
},
{
"c": "CF:ETHUSDT",
"e": "Crypto Perpetual Contract",
"tc": "USDT"
},
{
"c": "HK:9988",
"e": "SEHK",
"tc": "HKD",
"nc": "阿里巴巴-W",
"ne": "BABA-W",
"ls": 100,
"ts": 19008233516,
"os": 19008233516,
"ep": "4.6275184269",
"na": "56.8746237928",
"dy": "1.649298669"
}
]
}