vn.py怎么连接富途交易接口做美股实盘？

摘要： vn.py连接富途OpenAPI需申请权限，配置网关加载FutuGateway，实现下单、撤单及行情订阅。注意交易时段、风控和网络延迟。关键词：vn.py

准备工作

要连接富途交易接口，先得在富途开放平台注册开发者账号，创建应用获取AppID、SecretKey和Uid。这些凭证用于身份验证，确保交易安全。确保你的富途账号已开通美股交易权限，并完成相应的资金和风控设置。

安装必要库

vn.py通过FutuGateway模块支持富途接口，需要安装vnpy和vnpy_futu。使用pip命令：


pip install vnpy

pip install vnpy_futu

安装完成后，检查版本兼容性，确保vn.py版本在2.0以上，因为FutuGateway基于新版API开发。

配置连接参数

在vn.py中，连接富途需要配置GatewaySettings，包括AppID、SecretKey、Uid以及服务器地址。富途OpenAPI提供了仿真和实盘两种环境，实盘地址为wss://openapi.futunn.com，仿真为wss://openapi-sim.futunn.com。将配置写入JSON文件或直接在代码中设置。

vn.py怎么连接富途交易接口做美股实盘？

初始化vn.py引擎

使用vnpy的EventEngine和MainEngine，加载FutuGateway。示例代码：


from vnpy.event import EventEngine

from vnpy.trader.engine import MainEngine

from vnpy.trader.setting import SETTING_FILENAME

from vnpy_futu import FutuGateway

SETTING_FILENAME = 'connect_futu.json'

event_engine = EventEngine()

main_engine = MainEngine(event_engine)

main_engine.add_gateway(FutuGateway)

然后调用connect方法传入设置字典。

连接与认证

启动引擎后，调用main_engine.connect(settings, gateway_name='FUTU')，引擎会发送认证请求。认证成功后，会收到on_login回调，此时可以开始交易。注意，认证过程中需保持网络通畅，避免超时。

订阅行情

通过main_engine.subscribe(req, gateway_name)订阅股票行情。请求中需设置symbol（如US.AAPL）和exchange（如NASDAQ）。订阅后，实时行情会通过on_tick回调推送。

下单交易

使用main_engine.send_order发送订单，需要构造OrderRequest，包含symbol、exchange、direction、offset、price和volume。富途支持美股市价单和限价单。示例：


from vnpy.trader.object import OrderRequest, Direction, Offset

req = OrderRequest(

    symbol='US.AAPL',

    exchange='NASDAQ',

    direction=Direction.LONG,

    offset=Offset.OPEN,

    price=150.0,

    volume=100,

    type=OrderType.LIMIT

)

orderid = main_engine.send_order(req, gateway_name='FUTU')

发送后，可以通过on_order和on_trade回调跟踪状态。