> For the complete documentation index, see [llms.txt](https://algomaster.gitbook.io/tcore-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://algomaster.gitbook.io/tcore-api/com-api/tctradewrapperapi-methods.md).

# 交易 COM API Methods

## Connect

Connect TCore。若TCore未启动，则会先启动TCore，再进行Connect 。

{% tabs %}
{% tab title="Request" %}

```csharp
Connect([in] BSTR HostAddress, [in] BSTR SystemName, [in] BSTR AppID, [out,retval] LONG* plRet);
```

| **Parameters** |        |            |
| -------------- | ------ | ---------- |
| HostAddress    | string | TCore位址    |
| SystemName     | string | TCore系统名称  |
| AppID          | string | 连线TCore ID |
| {% endtab %}   |        |            |

{% tab title="Return" %}

* 0 : CONNECT\_RETURN\_FAIL
* 1 : CONNECT\_RETURN\_CONNECTING
* 2 : CONNECT\_RETURN\_CONNECTED
  {% endtab %}

{% tab title="Description" %}
叫Connect后，由event OnCommandMsg推送连线状态。
{% endtab %}
{% endtabs %}

## **Disconnect**

Disconnect TCore。

{% tabs %}
{% tab title="Request" %}

```cpp
Disconnect();
```

{% endtab %}
{% endtabs %}

## **GetAccountData**

取得帐户相关资料。

{% tabs %}
{% tab title="Request" %}

```csharp
GetAccountData([in] LONG Type, [in] LONG Index, [in] BSTR AcctMask, [in] IDispatch* AccountDataItem, [out,retval] LONG* lpRet);
```

| **Parameters**  | 类型     | 说明                                                                                                                                    |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| Type            | long   | <p>1 : 帐号</p><p>5 : 查询 证券/期货/期权权益数</p><p>6 : 查询 证券/期货/期权部位</p><p>7 : 主推 即时 证券/期货/期权部位</p><p>9 : 主推 即时 证券/期货/期权权益数</p><p>31 : 群组帐号</p> |
| Index           | long   | 欲取得第几笔资料。                                                                                                                             |
| AcctMask        | string | <p>欲取得哪个帐号资料，格式为\[BrokerID-Account] ，<br>ex.000-1234567。</p>                                                                          |
| AccountDataItem | object | [资料回传物件](/tcore-api/com-api/trade-object-parameter.md#adiaccount)。                                                                    |
| {% endtab %}    |        |                                                                                                                                       |

{% tab title="Return" %}
回传值 1:成功
{% endtab %}

{% tab title="Description" %}
AccountDataItem资料回传物件，依据Type，需使用对应的物件接收。

* Type=1\
  使用[ADIAccount](/tcore-api/com-api/trade-object-parameter.md#adiaccount)物件
* Type=5\
  使用[ADIMargin](/tcore-api/com-api/trade-object-parameter.md#adimargin)物件
* Type=6\
  使用[ADIPosition](/tcore-api/com-api/trade-object-parameter.md#adiposition)物件
* Type=7\
  使用[ADIPosition](/tcore-api/com-api/trade-object-parameter.md#adiposition)物件
* Type=9\
  使用[ADIMargin](/tcore-api/com-api/trade-object-parameter.md#adimargin)物件
* Type=31\
  使用[ADIAccount](/tcore-api/com-api/trade-object-parameter.md#adiaccount)物件
  {% endtab %}
  {% endtabs %}

## **NewOrder2**

**下一笔新单。**

{% tabs %}
{% tab title="Request" %}

```csharp
NewOrder2([in] LONG SecurityType, [in] IDispatch*NewOrderParameters, [out,retval] LONG* RetVal);
```

| **Parameters**     | 类型     | 说明                                                                    |
| ------------------ | ------ | --------------------------------------------------------------------- |
| SecurityType       | LONG   | <p>8 : TYPE\_STOCK</p><p>9 : TYPE\_FUTURE</p><p>10 : TYPE\_OPTION</p> |
| NewOrderParameters | object | [下单资料物件。](/tcore-api/com-api/trade-object-parameter.md#nopfutopt)     |
| {% endtab %}       |        |                                                                       |

{% tab title="Return" %}
回传值 1:成功

ErrorCode :\
-10 Unknow Error \
-11 买卖别不对 \
-12 复式单商品代码解析错误\
-13 下单帐号, 不可下此交易所商品 \
-14 下单错误, 不支援的价格 或 OrderType 或 TimeInForce \
-15 不支援证券下单 \
-20 连线未建立 \
-22 价格的TickSize错误 \
-23 下单数量超过该商品的上下限 \
-24 下单数量错误 \
-25 价格不能小于和等于0 (市价类型不会去检查)
{% endtab %}

{% tab title="Description" %}
NewOrderParameters下单资料物件，使用说明。

* SecurityType = TYPE\_STOCK\
  使用[NOPStock](/tcore-api/com-api/trade-object-parameter.md#nopstock)物件
* SecurityType = TYPE\_FUTURE or TYPE\_OPTION\
  使用[NOPFutOpt](/tcore-api/com-api/trade-object-parameter.md#nopfutopt)物件
  {% endtab %}
  {% endtabs %}

## **ReplaceOrder**

改单。

{% tabs %}
{% tab title="Request" %}

```csharp
ReplaceOrder([in] IDispatch* ReplaceOrderParameters, [out,retval] LONG* RetVal);
```

| **Parameters**             | 类型     | 说明                                                                                      |
| -------------------------- | ------ | --------------------------------------------------------------------------------------- |
| **ReplaceOrderParameters** | object | 欲改单资料物件 [NOPReplaceOrder](/tcore-api/com-api/trade-object-parameter.md#nopreplaceorder) |
| {% endtab %}               |        |                                                                                         |

{% tab title="Respone" %}
回传值 1:成功

ErrorCode :\
-17 改单错误, 追价单 不可改量改价 \
-18 改单错误, Trailing 不可改量改价 \
-21 改单错误, 不支援spread改价改量 \
-22 价格的TickSize错误 \
-23 下单数量超过该商品的上下限 \
-24 下单数量错误 \
-25 价格栏位无值(市价类型不会去检查)
{% endtab %}
{% endtabs %}

## **CancelOrder**

删单。

{% tabs %}
{% tab title="Request" %}

```csharp
CancelOrder([in] BSTR ReportID, [in] BSTR Key, [out,retval] LONG* RetVal);
```

| **Parameters** | 类型     | 说明                  |
| -------------- | ------ | ------------------- |
| ReportID       | string | 欲删单的ReportID。       |
| Key            | string | 删单的Key，由Apps自行指定使用。 |
| {% endtab %}   |        |                     |

{% tab title="Return" %}
回传值 1:成功

ErrorCode :\
-17 改单错误, 追价单 不可改量改价 \
-18 改单错误, Trailing 不可改量改价
{% endtab %}
{% endtabs %}

## **GetReportData**

取得回报资料。

{% tabs %}
{% tab title="Request" %}

```
GetReportData([in] LONG ReportType, BSTR ReportID, [in] IDispatch* ReportItems, [out,retval] LONG* RetVal);
```

| **Parameters** | 类型     | 说明                                                                                                   |
| -------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| ReportType     | long   | <p>0 : By Report ID</p><p>1 : All Active Orders</p><p>2 : All Filled Orders</p><p>3 : All Orders</p> |
| ReportID       | string | 欲取得该笔回报的ReportID。                                                                                    |
| ReportItems    | object | [回报物件](/tcore-api/com-api/trade-object-parameter.md#rptexecutionreport)。                             |
| {% endtab %}   |        |                                                                                                      |

{% tab title="Return" %}
回传值 1:成功
{% endtab %}

{% tab title="Description" %}
ReportItems回报物件，使用说明。

* ReportID = 0\
  取委回请使用[RPTExecutionReport](/tcore-api/com-api/trade-object-parameter.md#rptexecutionreport)物件，取成回请使用[RPTFilledOrder](/tcore-api/com-api/trade-object-parameter.md#rptfilledorder)物件
* ReportID = 1\
  使用[RPTReports](/tcore-api/com-api/trade-object-parameter.md#rptreports)物件
* ReportID = 2\
  使用[RPTReports](/tcore-api/com-api/trade-object-parameter.md#rptreports)物件
* ReportID = 3\
  使用[RPTReports](/tcore-api/com-api/trade-object-parameter.md#rptreports)物件
  {% endtab %}
  {% endtabs %}

## **GetOrderTypeMatrix**

可取得该帐号对此商品可下单的单&#x522B;**。**

{% tabs %}
{% tab title="Request" %}

```csharp
GetOrderTypeMatrix ([in] BSTR BrokerID, [in] BSTR Account, [in] BSTR SymbolID, [in] LONG Synthetic, [out,retval] BSTR* RetVal);
```

| **Parameters** | 类型     | 说明                                                          |
| -------------- | ------ | ----------------------------------------------------------- |
| BrokerID       | string | <p>BrokerID，若带空白，TCore会<br>依Account找出对应的BrokerID。</p>       |
| Account        | string | 帐号。                                                         |
| SymbolID       | string | 商品代码。                                                       |
| Synthetic      | long   | <p>0 : 上手支援的下单别 <br>1 : TCore支援的本地下单别 <br>6 : 查询是否支援市价单</p> |
| {% endtab %}   |        |                                                             |

{% tab title="Return" %}
回传格式为： \
MARKET:ROD,IOC,FOK；LIMIT:ROD,IOC,FOK；STOP:ROD,IOC,FOK；\
Synthetic = 6时，支援返回TRUE，否则FALSE<br>
{% endtab %}
{% endtabs %}

## **QueryAccountData**

帐务资料查询，触发 OnAccountUpdate 事件

{% tabs %}
{% tab title="Request" %}

```csharp
QueryAccountData([in] LONG lType, [in] BSTR BrokerID, [in] BSTR Account);
```

| **Parameters** | 类型     | 说明                                                |
| -------------- | ------ | ------------------------------------------------- |
| Type           | long   | <p>5 : 查询 证券/期货/期权权益数</p><p>6 : 查询 证券/期货/期权部位</p> |
| BrokerID       | string | 交易商代码                                             |
| Account        | string | 帐号。                                               |
| {% endtab %}   |        |                                                   |
| {% endtabs %}  |        |                                                   |

## **GetInstrumentInfo**

取得商品资讯

{% tabs %}
{% tab title="Request" %}

```csharp
GetInstrumentInfo([in] BSTR Type, [in] BSTR SymbolID, [out,retval] BSTR* bstrRetVal);
```

| **Parameters** | 类型     | 说明                                                                                                                                                                                                                                               |
| -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Type           | string | <p>1 : 上手分母值 </p><p>2 : 跳动档位 </p><p>3 : 交易时间 </p><p>4 : 显示乘数 </p><p>5 : 显示分母 </p><p>6 : 点值 </p><p>7 : 可下价格旗标 Market,Limit,Stop,StopLimit </p><p>8 : 可下单ROD,IOC,FOK,GTC,GTD </p><p>HotMonth : 热门月 </p><p>HotMonth2 : 热门月2 Instrument : 期权交易代码</p> |
| SymbolID       | string | 商品ID                                                                                                                                                                                                                                             |
| {% endtab %}   |        |                                                                                                                                                                                                                                                  |

{% tab title="Return" %}
回传商品资讯。
{% endtab %}
{% endtabs %}

## **GetExpirationDate**

取得合约到期&#x65E5;**。**

{% tabs %}
{% tab title="Request" %}

```csharp
GetExpirationDate([in] BSTR SymbolID, [out,retval] BSTR* pstrDate);
```

| **Parameters** | 类型     | 说明   |
| -------------- | ------ | ---- |
| SymbolID       | string | 商品ID |
| {% endtab %}   |        |      |
| {% endtabs %}  |        |      |