市面上稳定可用的港股行情API产品比较少，而且大部分都仅提供延时数据，这些产品难以满足港股量化投资者的需求。AllTick提供的港股行情接口专门为量化投资而设计，包含逐笔成交的实时数据和历史数据。我们现在来看看如何使用AllTick的港股行情接口。

第一步：注册账户

点击图片可以跳转至注册界面

第二步：在后台获取免费token

在每次请求的时候都要带上这个专用token

第三步：发送请求

我们提供了完整的文档帮你快速接入：

API文档

Github地址

如果在对接过程中，有任何问题都可以联系我们的客服：

TG：https://t.me/alltick001

Skype：https://join.skype.com/invite/xokTc695huNu

常见问题

AllTick能查询哪些香港股票的行情？

香港主板上市的个股都能通过我们的API查询，总计达到2600个不同公司的股票，详细的股票列表可以查看我们的产品目录。

可以查询历史行情数据吗？

可以，实时和历史数据都能查。

除了港股，还能查哪些金融产品？

AllTick API还能查询A股、美股、外汇、期货和加密货币。

可以免费试用吗？

可以。所有注册用户都将自动获得免费试用的API key。马上注册

请求示例

下面我们通过HTTP接口查询腾讯控股（700.HK）的股价：

import time
import requests
import json

# Extra headers
test_headers = {
    'Content-Type': 'application/json'
}

'''
# Replace "testtoken" in the URL below with your own token
'''
# K-line data request for Tencent Holdings (700.HK)
test_url1 = 'https://quote.tradeswitcher.com/quote-stock-b-api/kline?token=testtoken&query=%7B%22trace%22%20%3A%20%22python_http_test1%22%2C%22data%22%20%3A%20%7B%22code%22%20%3A%20%22700.HK%22%2C%22kline_type%22%20%3A%201%2C%22kline_timestamp_end%22%20%3A%200%2C%22query_kline_num%22%20%3A%202%2C%22adjust_type%22%3A%200%7D%7D'

# Depth tick data request for Tencent Holdings (700.HK)
test_url2 = 'https://quote.tradeswitcher.com/quote-stock-b-api/depth-tick?token=testtoken&query=%7B%22trace%22%20%3A%20%22python_http_test2%22%2C%22data%22%20%3A%20%7B%22symbol_list%22%3A%20%5B%7B%22code%22%3A%20%22700.HK%22%7D%5D%7D%7D'

# Trade tick data request for Tencent Holdings (700.HK)
test_url3 = 'https://quote.tradeswitcher.com/quote-stock-b-api/trade-tick?token=testtoken&query=%7B%22trace%22%20%3A%20%22python_http_test3%22%2C%22data%22%20%3A%20%7B%22symbol_list%22%3A%20%5B%7B%22code%22%3A%20%22700.HK%22%7D%5D%7D%7D'

# Send requests and print responses
resp1 = requests.get(url=test_url1, headers=test_headers)
time.sleep(1)
resp2 = requests.get(url=test_url2, headers=test_headers)
time.sleep(1)
resp3 = requests.get(url=test_url3, headers=test_headers)

# Decoded text returned by the request
text1 = resp1.text
print(text1)

text2 = resp2.text
print(text2)

text3 = resp3.text
print(text3)

我们也可以使用Websocket订阅：

import json
import websocket    # pip install websocket-client

'''
# Replace "testtoken" in the URL below with your own token
'''

class Feed(object):

    def __init__(self):
        self.url = 'wss://quote.tradeswitcher.com/quote-stock-b-ws-api?token=testtoken'  # Enter your websocket URL here
        self.ws = None

    def on_open(self, ws):
        """
        Callback object which is called at opening websocket.
        1 argument:
        @ ws: the WebSocketApp object
        """
        print('A new WebSocketApp is opened!')

        # Start subscribing (modified for 700.HK)
        sub_param = {
            "cmd_id": 22002,
            "seq_id": 123,
            "trace": "3baaa938-f92c-4a74-a228-fd49d5e2f8bc-1678419657806",
            "data": {
                "symbol_list": [
                    {
                        "code": "700.HK",
                        "depth_level": 5,
                    }
                ]
            }
        }

        # If you want to run for a long time, you need to modify the code to send heartbeats periodically to avoid disconnection, please refer to the API documentation for details
        sub_str = json.dumps(sub_param)
        ws.send(sub_str)
        print("Depth quote for 700.HK is subscribed!")

    def on_data(self, ws, string, type, continue_flag):
        """
        4 arguments.
        The 1st argument is this class object.
        The 2nd argument is utf-8 string which we get from the server.
        The 3rd argument is data type. ABNF.OPCODE_TEXT or ABNF.OPCODE_BINARY will be came.
        The 4th argument is continue flag. If 0, the data continue
        """

    def on_message(self, ws, message):
        """
        Callback object which is called when received data.
        2 arguments:
        @ ws: the WebSocketApp object
        @ message: utf-8 data received from the server
        """
        # Parse the received message
        result = eval(message)
        print(result)

    def on_error(self, ws, error):
        """
        Callback object which is called when got an error.
        2 arguments:
        @ ws: the WebSocketApp object
        @ error: exception object
        """
        print(error)

    def on_close(self, ws, close_status_code, close_msg):
        """
        Callback object which is called when the connection is closed.
        2 arguments:
        @ ws: the WebSocketApp object
        @ close_status_code
        @ close_msg
        """
        print('The connection is closed!')

    def start(self):
        self.ws = websocket.WebSocketApp(
            self.url,
            on_open=self.on_open,
            on_message=self.on_message,
            on_data=self.on_data,
            on_error=self.on_error,
            on_close=self.on_close,
        )
        self.ws.run_forever()


if __name__ == "__main__":
    feed = Feed()
    feed.start()