港股实时行情数据API接口-2025年最好用的
由bqc1bary创建，最终由bqc1bary 被浏览 5 用户
接口地址
# Restful API
https://api.qos.hk/trade
https://api.qos.hk/instrument-info
https://api.qos.hk/snapshot
https://api.qos.hk/depth
https://api.qos.hk/kline
https://api.qos.hk/history
# ws API
wss://api.qos.hk/ws
- 更新周期：实时
- 请求方式：POST
- 数据节点：香港
- 套餐选择：自由组合市场和股票
更多详情请查看：https://github.com/qos-max/quote-ocean-system
获取交易品种的基础信息
- 接口地址：
/instrument-info
- 请求方式：
POST
- 接口描述：获取交易品种的基础信息
请求参数
| 参数名 |
类型 |
必填 |
描述 |
codes |
array |
是 |
交易品种列表数组，传入细节请看下面请求示例 |
请求示例
{
"codes": [
"US:AAPL,TSLA",
"HK:700",
"SH:600519"
]
}
响应结果
| 字段名称 |
类型 |
描述 |
| c |
string |
股票代码 |
| e |
string |
交易所 |
| tc |
string |
交易币种 |
| nc |
string |
中文名称 |
| ne |
string |
英文名称 |
| ls |
integer |
最小交易单位 |
| ts |
integer |
时间戳 |
| os |
integer |
股票总数 |
| ep |
string |
每股盈利 |
| na |
string |
每股净资产 |
| dy |
string |
股息率 |
# 响应示例
{
"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"
}
]
}
获取交易品种的实时行情快照
- 接口地址：
/snapshot
- 请求方式：
POST
- 接口描述：获取交易品种的实时行情快照
请求参数
| 参数名 |
类型 |
必填 |
描述 |
codes |
array |
是 |
交易品种列表数组，传入细节请看下面请求示例 |
请求示例
{
"codes": [
"US:AAPL,TSLA",
"HK:700",
"SH:600519"
]
}
响应结果
| 字段名称 |
类型 |
描述 |
| c |
string |
股票代码 |
| lp |
string |
当前价格 |
| yp |
string |
昨日收盘价 |
| o |
string |
开盘价 |
| h |
string |
最高价 |
| l |
string |
最低价 |
| ts |
integer |
时间戳 |
| v |
string |
成交量 |
| t |
string |
成交金额 |
| s |
integer |
是否停牌（0表示未停牌，1表示停牌） |
响应示例
{
"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"
}
]
}
获取交易品种的实时最新盘口深度
- 接口地址：
/depth
- 请求方式：
POST
- 接口描述：获取交易品种的实时最新盘口深度
请求参数
| 参数名 |
类型 |
必填 |
描述 |
codes |
array |
是 |
交易品种列表数组，传入细节请看下面请求示例 |
请求示例
{
"codes": [
"US:AAPL,TSLA",
"HK:700",
"SH:600519"
]
}
响应结果
| 字段名称 |
类型 |
描述 |
| c |
string |
股票代码 |
| b |
array |
买单数组 |
| > p |
string |
买单价格 |
| > v |
string |
买单数量 |
| a |
array |
卖单数组 |
| > p |
string |
卖单价格 |
| > v |
string |
卖单数量 |
| ts |
integer |
时间戳 |
响应示例
{
"msg": "OK",
"data": [
{
"c": "US:AAPL",
"b": [
{ "p": "224.42", "v": "100" }
],
"a": [
{ "p": "224.74", "v": "20" }
],
"ts": 1731293478
},
{
"c": "US:TSLA",
"b": [
{ "p": "295.8", "v": "5" }
],
"a": [
{ "p": "295.9", "v": "130" }
],
"ts": 1731293478
},
{
"c": "SH:600519",
"b": [
{ "p": "1593.01", "v": "1" },
{ "p": "1593", "v": "5" }
],
"a": [
{ "p": "1593.02", "v": "1" },
{ "p": "1594", "v": "6" }
],
"ts": 1731293478
}
]
}
获取交易品种的实时最新逐笔成交明细
- 接口地址：
/trade
- 请求方式：
POST
- 接口描述：获取交易品种的实时最新逐笔成交明细
请求参数
| 参数名 |
类型 |
必填 |
描述 |
codes |
array |
是 |
交易品种列表数组，传入细节请看下面请求示例 |
count |
integer |
是 |
请求的最近多少条，此数值不能超过50 |
请求示例
{
"codes": [
"US:AAPL",
"HK:700",
"SH:600519,688981,601127,600938,601727,600837,688185",
"SZ:002594"
],
"count": 2
}
响应结果
| 字段名称 |
类型 |
描述 |
| c |
string |
股票代码 |
| p |
string |
当前价格 |
| v |
string |
当前成交量 |
| ts |
integer |
时间戳 |
| d |
integer |
交易方向，具体定义参看5.2章节 |
响应示例
{
"msg": "OK",
"data": [
{
"c": "SH:688185",
"p": 66.99,
"v": 2,
"ts": 1731635481,
"d": 2
},
{
"c": "SH:600519",
"p": 1555.8,
"v": 74,
"ts": 1731635489,
"d": 2
},
{
"c": "SH:601127",
"p": 135.81,
"v": 327,
"ts": 1731635489,
"d": 0
},
{
"c": "SH:688981",
"p": 96.25,
"v": 364,
"ts": 1731635491,
"d": 2
},
{
"c": "SH:600938",
"p": 25.85,
"v": 75,
"ts": 1731635488,
"d": 1
},
{
"c": "SH:601727",
"p": 9.01,
"v": 8414,
"ts": 1731635491,
"d": 1
},
{
"c": "SH:600837",
"p": 11.92,
"v": 510,
"ts": 1731635490,
"d": 2
},
{
"c": "SZ:002594",
"p": 285.88,
"v": 59,
"ts": 1731635493,
"d": 0
}
]
}
获取交易品种的K线
请求参数
| 参数名 |
类型 |
必填 |
描述 |
| c |
string |
股票代码，多个股票代码用逗号分隔 |
|
| co |
integer |
Count 请求多少根 |
|
| a |
integer |
复权类型 0:不复权 1:前复权 |
|
| kt |
integer |
K线类型，取值参看5.1章节K线类型定义 |
|
请求示例
{
"kline_reqs": [
{
"c": "US:AAPL,TSLA",
"co": 2,
"a": 0,
"kt": 1
},
{
"c": "HK:700",
"co": 2,
"a": 0,
"kt": 1
},{
"c": "SH:600519",
"co": 2,
"a": 0,
"kt": 2001
}
]
}
响应结果
| 字段名称 |
类型 |
描述 |
| c |
string |
股票代码 |
| k |
array |
K线数据数组 |
| > o |
string |
开盘价 |
| > cl |
string |
收盘价 |
| > h |
string |
最高价 |
| > l |
string |
最低价 |
| > v |
string |
成交量 |
| > ts |
integer |
时间戳 |
| > kt |
integer |
K线类型，取值参看5.1章节K线类型定义 |
响应示例
{
"msg": "OK",
"data": [
{
"c": "SH:600519",
"k": [
{
"c": "SH:600519",
"o": "1731.2",
"cl": "1726",
"h": "1935",
"l": "1616.25",
"v": "5627550",
"ts": 1672502400,
"kt": 2001
},
{
"c": "SH:600519",
"o": "1715",
"cl": "1585.58",
"h": "1910",
"l": "1245.83",
"v": "7147731",
"ts": 1704038400,
"kt": 2001
}
]
},
{
"c": "US:TSLA",
"k": [
{
"c": "US:TSLA",
"o": "330.32",
"cl": "330.19",
"h": "330.79",
"l": "329.957",
"v": "578346",
"ts": 1731531540,
"kt": 1
},
{
"c": "US:TSLA",
"o": "330.27",
"cl": "330.24",
"h": "330.29",
"l": "330.24",
"v": "2404646",
"ts": 1731531600,
"kt": 1
}
]
},
{
"c": "US:AAPL",
"k": [
{
"c": "US:AAPL",
"o": "225.11",
"cl": "225.07",
"h": "225.32",
"l": "225",
"v": "813271",
"ts": 1731531540,
"kt": 1
},
{
"c": "US:AAPL",
"o": "225.12",
"cl": "225.12",
"h": "225.12",
"l": "225.12",
"v": "8870001",
"ts": 1731531600,
"kt": 1
}
]
},
{
"c": "HK:700",
"k": [
{
"c": "HK:700",
"o": "411.4",
"cl": "411.6",
"h": "411.6",
"l": "411.2",
"v": "51115",
"ts": 1731553860,
"kt": 1
},
{
"c": "HK:700",
"o": "411.6",
"cl": "411.4",
"h": "411.8",
"l": "411.4",
"v": "84400",
"ts": 1731553920,
"kt": 1
}
]
}
]
}
获取交易品种的K线-历史
- 接口地址：
/history
- 请求方式：
POST
- 接口描述：获取交易品种的历史K线，从传入的结束时间向前推多少根的K线。
请求参数
| 参数名 |
类型 |
必填 |
描述 |
| c |
string |
股票代码，多个股票代码用逗号分隔 |
|
| e |
integer |
请求K线的结束时间戳，单位秒 |
|
| co |
integer |
Count 请求多少根 |
|
| a |
integer |
复权类型 0:不复权 1:前复权 |
|
| kt |
integer |
K线类型，取值参看5.1章节K线类型定义 |
|
请求示例
{
"kline_reqs": [
{
"c": "US:AAPL,TSLA",
"e": 1722441600,
"co": 1,
"a": 0,
"kt": 1001
},
{
"c": "HK:700",
"e": 1722441600,
"co": 1,
"a": 0,
"kt": 2001
}
]
}
响应结果
| 字段名称 |
类型 |
描述 |
| c |
string |
股票代码 |
| k |
array |
K线数据数组 |
| > o |
string |
开盘价 |
| > cl |
string |
收盘价 |
| > h |
string |
最高价 |
| > l |
string |
最低价 |
| > v |
string |
成交量 |
| > ts |
integer |
时间戳 |
| > kt |
integer |
K线类型，取值参看5.1章节K线类型定义 |
# 响应示例
{
"msg": "OK",
"data": [
{
"c": "US:AAPL",
"k": [
{
"c": "US:AAPL",
"o": "224.01",
"cl": "225.12",
"h": "226.65",
"l": "222.76",
"v": "48566217",
"ts": 1731474000,
"kt": 1001
}
]
},
{
"c": "US:TSLA",
"k": [
{
"c": "US:TSLA",
"o": "335.85",
"cl": "330.24",
"h": "344.6",
"l": "322.5",
"v": "125405599",
"ts": 1731474000,
"kt": 1001
}
]
},
{
"c": "HK:700",
"k": [
{
"c": "HK:700",
"o": "300",
"cl": "410.8",
"h": "482.4",
"l": "260.2",
"v": "4682849510",
"ts": 1704038400,
"kt": 2001
}
]
}
]
}
更多详情请查看：https://github.com/qos-max/quote-ocean-system