使用手册 · JQ 7.0

从配置到实盘，一步一步完成

Token、聚宽、客户端、跟单参数、分享页和常见问题都在这里。

聚宽配置 客户端下载 常见问题
目录
CHAPTER 02

聚宽端配置

2 聚宽端配置

聚宽端只负责一件事：你的策略调用 order、order_value 等下单函数时，系统同步把这笔买卖信号发送到服务器。新手按下面步骤做，不需要改原来的买卖逻辑。

1

上传发送模块

在下载包里找到 jq_sender_stock.py，上传到聚宽的研究环境。

2

策略开头粘贴代码

把下面这段接入代码粘贴到聚宽策略文件最顶部，放在你的策略代码前面。

3

填写 Token 后运行

把 填写你的Token 改成后台复制的 API Token，保存后实盘运行。

2.1 第一步：上传 jq_sender_stock.py

先在客户端或网站下载包中找到股票发送文件：

文件名一般是 jq_sender_stock.py。它是聚宽和服务器之间的“信号发送器”。
  1. 打开聚宽网站，进入你的账号。
  2. 进入“研究环境”。
  3. 把 jq_sender_stock.py 上传到研究环境文件列表里。
  4. 确认文件名没有改错，必须叫 jq_sender_stock.py。
如果文件名改成了 jq_sender_stock(1).py、jq_sender_stock.txt，策略里就会导入失败。

2.2 第二步：在策略开头粘贴接入代码

打开你的聚宽策略，把下面代码粘贴到策略文件最上面。它会把聚宽原来的下单函数包装一层：策略照常下单，同时把信号发送到服务器。

from jq_sender_stock import wrap_stock
order, order_target, order_value, order_target_value = wrap_stock(
    clients=[
        {'token': '填写你的Token', 'name': '填写策略名'},
        #{'token': '填写你的Token', 'name': '填写策略名'},  # 发送给多个Token的实例，每行一个Token
    ],
    _order=order, _order_target=order_target,
    _order_value=order_value, _order_target_value=order_target_value)
这段代码粘贴后，你原策略里的 order()、order_value() 等函数不用改，继续按原来的方式写。

2.3 第三步：修改 Token 和策略名

要改的位置填写什么示例
填写你的Token后台右上角或“我的 Token”里复制的 API Tokenabc123xxxxxxxx
填写策略名方便你自己识别的名称，可以随便写双均线策略
Token 是服务器识别账户的关键。填错 Token，信号会发不到你的账户；多个账户就填写多行 {'token': '...', 'name': '...'}。

2.4 多 Token 怎么写

如果一个聚宽策略要同时发给多个 QMT 客户端，就在 clients 里增加多行。每个 Token 对应后台里一个独立账户配置。

from jq_sender_stock import wrap_stock
order, order_target, order_value, order_target_value = wrap_stock(
    clients=[
        {'token': '第一个Token', 'name': '账户A'},
        {'token': '第二个Token', 'name': '账户B'},
        {'token': '第三个Token', 'name': '账户C'},
    ],
    _order=order, _order_target=order_target,
    _order_value=order_value, _order_target_value=order_target_value)
每个 Token 的资金账号、跟单比例、固定金额、黑名单、买卖价格方式都是独立配置，互不影响。

2.5 支持哪些聚宽下单函数

函数名说明例子
order(security, amount)按数量下单，正数买入，负数卖出order('000001.XSHE', 1000)
order_target(security, amount)调整持仓到目标数量order_target('000001.XSHE', 5000)
order_value(security, value)按金额买入或卖出order_value('000001.XSHE', 50000)
order_target_value(security, value)调整持仓到目标金额order_target_value('000001.XSHE', 100000)

2.6 实盘和回测要分清

聚宽实盘运行

信号会作为实盘信号发送，QMT / miniQMT / PTrade 收到后会按你的后台配置真实下单。

聚宽回测运行

建议不要连接真实 Token 做测试。如果只是想看代码能不能跑，请确认客户端处于测试模式或后台是回测模式。

新手第一次接入时，建议先用小金额、小股数测试一笔，确认后台能看到信号、客户端能收到、成交能回传，再正式放大资金。

2.7 常见问题

提示找不到 jq_sender_stock？

说明 jq_sender_stock.py 没有上传到聚宽研究环境，或者文件名写错了。

后台没有信号？

先检查 Token 是否填写正确，再看聚宽日志里是否打印“交易信号发送 - 成功”。

后台有信号但客户端没下单？

检查 QMT / miniQMT / PTrade 是否在线，后台资金账号是否和本地客户端账号一致，客户端是否处于测试模式或回测模式。