Pre-release
This release is a pre-release and may not be stable for production use.
QmtLink
QmtLink 是一个非官方的 miniQMT/xtquant 跨平台中转项目,提供:
- Windows Bridge 一键启动命令
- 面向 AI 和自动化脚本的 JSON CLI
- 面向 Python 量化项目的 SDK
- HTTP API(实时 WebSocket 将在后续版本加入)
当前版本是开发预览版。Mock Bridge、HTTP API、CLI 和 SDK 可用;真实 miniQMT 交易尚未实现,请勿用于实盘。
安装
客户端和 CLI:
uv add qmtlink
Windows Bridge:
uv add "qmtlink[server]"
快速体验
启动 Mock Bridge:
qmt bridge run --mock
另一个终端执行:
qmt health
qmt capabilities
qmt market quote --symbol 000001.SZ --symbol 600519.SH
qmt order preview --symbol 000001.SZ --side buy --quantity 100 --price 10.50
所有 CLI 命令默认输出 JSON。qmtlink 是 qmt 的等价备用命令。
Python SDK
from qmtlink import QMTClient
with QMTClient("http://127.0.0.1:8000") as client:
print(client.health())
print(client.get_quotes(["000001.SZ"]))
Bridge 诊断
qmt bridge doctor
真实模式会延迟导入 xtquant,基础客户端包在 Linux/macOS 上不会导入它:
qmt bridge run
安全原则
- 真实交易默认关闭。
- 交易请求必须携带唯一
client_order_id。 - 下单请求不得在网络超时后盲目重试。
- API Key 通过
QMTLINK_API_KEY提供,不建议放入命令参数。
环境变量
| 变量 | 默认值 | 用途 |
|---|---|---|
QMTLINK_URL |
http://127.0.0.1:8000 |
CLI/SDK 服务地址 |
QMTLINK_API_KEY |
空 | API Key |
QMTLINK_HOST |
127.0.0.1 |
Bridge 监听地址 |
QMTLINK_PORT |
8000 |
Bridge 监听端口 |
QMTLINK_MODE |
real |
real 或 mock |
QMTLINK_ALLOW_LIVE_ORDERS |
false |
允许提交订单 |
开发
uv sync --extra server
uv run pytest
uv run ruff check .
uv build --no-sources
开发路线见 ROADMAP.md。
License
MIT。QmtLink 与 miniQMT、QMT、xtquant 及其权利方不存在官方隶属或背书关系。
Metadata
Release files for qmtlink 0.1.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| qmtlink-0.1.0a1.tar.gz | 9.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| qmtlink-0.1.0a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 26.5 kB
Release files / qmtlink-0.1.0a1.tar.gz
| Download URL | qmtlink-0.1.0a1.tar.gz |
|---|---|
| Size | 9.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f7d080e48d5d7165cb04c6df52a099aacb6a7c16a6bac62152c7efb7057c08a9
|
|
BLAKE2b-256 checksum How to use checksums |
1b67b1d3abba580565bcef3ed2748539d0875e0f6c1401850e60c87dcf26c30b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / qmtlink-0.1.0a1-py3-none-any.whl
| Download URL | qmtlink-0.1.0a1-py3-none-any.whl |
|---|---|
| Size | 16.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1dc90c00bc4ebd7015f4eaa17d728a8a9b84bfab27219877f48c9e9717727cd
|
|
BLAKE2b-256 checksum How to use checksums |
262fa090d93b5cab378b380af40e88156607147e4ba9f847dba3aa4f335cbade
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|