# CTP交易连接

VeighNa Fusion 仅提供单一 `CTP` 交易接口，因此完成登录后，最重要的基础操作就是连接 CTP 并确认行情与交易功能工作正常。

## 连接前准备

在执行连接前，建议先确认以下事项：

- 已成功登录 VeighNa Fusion；
- 已从所属期货公司获取 CTP 账户所需信息；
- 当前网络环境能够访问交易和行情服务；
- 交易时段、仿真环境或生产环境与账号用途一致。

如果你不确定所需填写的字段含义，应先向所属期货公司确认，不建议自行猜测或混用不同环境的配置。

## 连接CTP

在主界面中点击 `【系统】->【连接CTP】`，即可打开 CTP 连接窗口。按照窗口中的字段要求填写相关信息后，点击确认发起连接。

![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/fusion/1.png)

连接发起后，可观察 `日志` 组件输出的状态信息。若连接成功，系统通常会继续推送账户、持仓、合约或行情相关信息。

![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/fusion/2.png)

## 查询合约

连接成功后，建议先通过 `【帮助】->【查询合约】` 

请注意，等待`日志` 组件输出“合约查询成功”日志之后进行合约查询，查到的才是接口本次连接收到的所有合约。

查询合约时，常见用途包括：

- 确认某个期货合约所属交易所；
- 确认下单时应填写的合约代码；
- 检查当前环境下该合约是否已可正常查询。

![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/fusion/3.png)

## 订阅行情

在交易组件中输入正确的**交易所**和合约**代码**后，通常即可订阅该合约的行情。订阅成功后，界面会逐步显示：

- 合约名称；
- 最新价；
- 买卖盘报价；
- 其他实时行情字段。

若订阅后界面长期没有行情更新，应先回到【合约查询】页面**确认代码是否填写正确**，再检查当前时间段是否有有效行情推送。

请注意，名称不用填写，订阅成功之后会自动显示。

![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/fusion/4.png)

## 委托下单与撤单

在完成行情订阅后，可在交易组件中填写下单信息，常见字段包括：

- 交易所；
- 代码；
- 方向；
- 开平；
- 委托类型；
- 价格；
- 数量。

填写完成后即可发出委托。委托发出后，建议同时观察：

- `委托` 组件中的状态变化；
- `活动委托` 或相关监控区域中的实时反馈；
- `成交` 组件中是否出现成交记录；
- `日志` 组件中是否出现异常提示。

需要撤销尚未完成的委托时，可在相应委托区域执行撤单操作。

![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/fusion/5.png)

## 查看委托成交持仓

完成一次完整交易后，建议重点关注以下几个区域：

- `委托`：确认委托是否已经发出、成交或撤销；
- `成交`：确认是否已有实际成交记录；
- `持仓`：确认成交后持仓是否变化；
- `资金`：观察账户权益和可用资金的变化；
- `日志`：核对是否存在风控提示、接口异常或其他重要信息。

对于入门用户来说，养成“下单后先看委托，再看成交和持仓”的习惯，往往比一味关注价格变动更重要。

![](https://vnpy-doc.oss-cn-shanghai.aliyuncs.com/fusion/6.png)

## 常见连接问题

### 无法建立连接

现象：点击连接后，日志中长时间没有正常登录反馈，或直接提示连接失败。  
处理建议：如果长时间没有日志输出反馈，可以通过telnet检查对应服务器端口是否开启。如果有日志反馈输出，可以结合日志输出信息先检查网络状态，再确认填写的信息是否来自正确环境，并联系所属期货公司确认当前服务状态。

### 能登录但无法查询合约

现象：账户连接成功，但查询不到目标合约。  
处理建议：先确认交易所和合约代码写法，再确认当前环境是否支持该合约或该交易时段是否有效。

### 能连接但没有行情

现象：连接成功后无法看到实时行情更新。  
处理建议：先确认是否已经正确订阅目标合约（如果输入的合约代码是接口连接后已经查到的，订阅成功之后交易组件的“名称”字段会自动显示），再检查当前时间是否处于对应市场的有效行情时段。

### 委托发出后没有成交

现象：委托状态停留在未成交或部分成交。  
处理建议：这是交易过程中的正常情况之一，应结合价格、盘口和委托状态综合判断，不要将“未成交”等同于系统异常。

完成 CTP 连接后，你可以继续阅读 [CTA策略](../strategy/fusion_cta.md) 和 [回测与优化](../strategy/fusion_backtester.md)，开始进入量化交易主线。
