# Zinvest-trade-api-python **Repository Path**: yohaa0/zinvest-trade-api-python ## Basic Information - **Project Name**: Zinvest-trade-api-python - **Description**: zinvest-trade-api-python 尊嘉证券行情API,用户可以订阅港股、美股实时行情,包含买卖10档盘口与最新价。说明文档:(https://www.zvsts.com/api). 同时尊嘉证券提供免费实时的RESTful交易API。编程语言不限于Python/JS/JAVA/C++/Go等。说明文档:(https://www.zvsts.com/api). - **Primary Language**: Python - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 2 - **Created**: 2022-07-31 - **Last Updated**: 2025-06-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Zinvest-trade-api-python `zinvest-trade-api-python` 尊嘉证券行情API,用户可以订阅港股、美股实时行情,包含买卖10档盘口与最新价。说明文档:(https://www.zvsts.com/api). 同时尊嘉证券提供免费实时的RESTful交易API。编程语言不限于Python/JS/JAVA/C++/Go等。说明文档:(https://www.zvsts.com/api). ## 安装 Python 环境:python>=3.6 and python <= 3.9 ### 从pip库一键安装: ```bash pip install zinvest-trade-api ``` ### 下载源代码安装 一键安装以下依赖包:pip install -r requirements.txt ``` python-dateutil==2.8.1 msgpack==1.0.2 websockets==8.0 ``` 下载zinvest-trade-api-python代码后,进入根目录运行steam_example.py可以查看订阅结果。 ```bash python ./stream_example.py ``` 如果自定义开发客户端订阅,把zinvest_trade_api目录引入工程里,可以自行开发。 ## API Keys 应用市场搜索下载'尊嘉金融'APP,注册登录获取实时行情订阅权限。 | Environment | default | Description | | -------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | ZVST_API_KEY_ID= | | 尊嘉金融APP用户名 | | ZVST_API_SECRET_KEY= | | 尊嘉金融APP登录密码 | # 服务 * 数据: * [实时行情订阅](https://www.zvsts.com/api) ## 怎样订阅实时港股、美股行情 ### 实时行情包含如下类型: * Quotes (https://www.zvsts.com/api) * Snapshots (https://www.zvsts.com/api) ### 实时订阅行情参考:'stream_example.py' ```py import logging from zinvest_trade_api.stream import Stream log = logging.getLogger(__name__) async def print_quote(q): print('quote', q) async def print_snapshots(s): print('snapshots', s) def main(): logging.basicConfig(level=logging.INFO) stream = Stream(key_id='test', secret_key='test') stream.subscribe_quotes(print_quote, 'HKEX_00700', 'HKEX_03690') stream.subscribe_snapshots(print_snapshots, 'HKEX_00700') stream.run() if __name__ == "__main__": main() ``` ### 更多示例可以参考example目录: * 停止和恢复websocket连接。 * 动态订阅或取消订阅某些股票。