> 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/c++-regular-dll/rtctradeapi-functions.md).

# 交易 DLL functions

RTCTradeAPI介面

## **CreateRTCTradeAPI**

创建出的RTCTradeAPI

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

```csharp
static RTCTradeAPI *CreateRTCTradeAPI(char *strLogPath)
```

| **Parameters** | 类型     | 说明                                                                                          |
| -------------- | ------ | ------------------------------------------------------------------------------------------- |
| **s**trLogPath | char\* | <p>存放LOG档案路径，API会自动在档案结尾加上<br>日期，未设定预设不产生<br>EX:CreateRTCTradeAPI(“C:\RTCTradeAPI.txt”)</p> |
| {% endtab %}   |        |                                                                                             |

{% tab title="Return" %}
返回一个RTCTradeAPI实例指标
{% endtab %}
{% endtabs %}

## **Release**

不再使用本介面对象时，调用该函数删除对象

```
void Release()
```

## **Join**

等待介面执行绪结束运行

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

```csharp
int Join()
```

{% endtab %}

{% tab title="Return" %}
成功为0，否则失败
{% endtab %}
{% endtabs %}

## **RegisterSpi**

继承自callback介面类的实例

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

```csharp
void RegisterSpi(RTCTradeAPISpi *pSpi)
```

| **Parameters** | 类型      | 说明           |
| -------------- | ------- | ------------ |
| pSpi           | pointer | 指向callback指标 |
| {% endtab %}   |         |              |
| {% endtabs %}  |         |              |

## **RegisterFront**

连接TCore

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

```csharp
LONG RegisterFront(char *strHostAddress, char *strSystemName, char *strServiceKey, int iConnectType)
```

| **Parameters** | 类型     | 说明         |
| -------------- | ------ | ---------- |
| strHostAddress | char\* | TCore位址    |
| strSystemName  | char\* | TCore系统名称  |
| strServiceKey  | char\* | 连线TCore ID |
| iConnectType   | int    | 固定带1       |
| {% endtab %}   |        |            |

{% tab title="Return" %}
返回值：\
CONNECT\_RETURN\_FAIL 0 \
CONNECT\_RETURN\_CONNECTING 1 \
CONNECT\_RETURN\_CONNECTED 2
{% endtab %}
{% endtabs %}

## **ReqOrderInsert**

报单录入请求

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

```csharp
int ReqOrderInsert(ICEInputOrderField *pInputOrder, int nRequestID)
```

| **Parameters** | 类型      | 说明                                                                                                     |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------ |
| pInputOrder    | pointer | [ICEInputOrderField ](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceinputorderfield)data struct |
| nRequestID     | int     |                                                                                                        |
| {% endtab %}   |         |                                                                                                        |

{% tab title="Return" %}
成功为0，否则失败

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

## **ReqOrderAction**

报单操作请求

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

```csharp
int ReqOrderAction(ICEInputOrderActionField *pInputOrderAction, int nRequestID)
```

删单的话只需要带入ReportID

| **Parameters**    | 类型      | 说明                                                                                                                 |
| ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------ |
| pInputOrderAction | pointer | [ICEInputOrderActionField](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceinputorderactionfield) data struct |
| nRequestID        | int     |                                                                                                                    |
| {% endtab %}      |         |                                                                                                                    |

{% tab title="Return" %}
成功为0，否则失败
{% endtab %}
{% endtabs %}

## **ReqQryOrder**

请求查询报单

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

```csharp
int ReqQryOrder(ICEQryOrderField *pQryOrder, int nRequestID)
```

| **Parameters** | 类型      | 说明                                                                                                 |
| -------------- | ------- | -------------------------------------------------------------------------------------------------- |
| pQryOrder      | pointer | [ICEQryOrderField ](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceqryorderfield)data struct |
| nRequestID     | int     |                                                                                                    |
| {% endtab %}   |         |                                                                                                    |

{% tab title="Return" %}
成功为0，否则失败

报单资料由callback OnRspQryOrder返回
{% endtab %}
{% endtabs %}

## **ReqQryTrade**

请求查询成交

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

```csharp
int ReqQryTrade(ICEQryTradeField *pQryTrade, int nRequestID)
```

| **Parameters** | 类型      | 说明                             |
| -------------- | ------- | ------------------------------ |
| pQryTrade      | pointer | ICEQryTradeField data structer |
| nRequestID     | int     |                                |
| {% endtab %}   |         |                                |

{% tab title="Return" %}
成功为0，否则失败

成交资料由callback OnRspQryTrade返回
{% endtab %}
{% endtabs %}

## **ReqQryInvestorPosition**

请求查询投资者持仓

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

```csharp
int ReqQryInvestorPosition(ICEQryInvestorPositionField *pQryInvestorPosition, int nRequestID)
```

| **Parameters**       | 类型      | 说明                                                                                                                       |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| pQryInvestorPosition | pointer | [ICEQryInvestorPositionField ](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceqryinvestorpositionfield)data struct |
| nRequestID           | int     |                                                                                                                          |
| {% endtab %}         |         |                                                                                                                          |

{% tab title="Return" %}
成功为0，否则失败

持仓资料由callback OnRspQryInvestorPosition返回
{% endtab %}
{% endtabs %}

## **ReqQryTradingAccount**

请求查询资金账户

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

```csharp
int ReqQryTradingAccount(ICEQryTradingAccountField *pQryTradingAccount, int nRequestID)
```

| **Parameters**     | 类型      | 说明                                                                                                                   |
| ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------- |
| pQryTradingAccount | pointer | [ICEQryTradingAccountField ](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceqrytradingaccountfield)data struct |
| nRequestID         | int     |                                                                                                                      |
| {% endtab %}       |         |                                                                                                                      |

{% tab title="Return" %}
成功为0，否则失败

资金资料由callback OnRspQryTradingAccount返回
{% endtab %}
{% endtabs %}

## **ReqQryInstrument**

请求查询合约

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

```csharp
int ReqQryInstrument(ICEQryInstrumentField *pQryInstrument, int nRequestID)
```

| **Parameters** | 类型      | 说明                                                                                                           |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| pQryInstrument | pointer | [ICEQryInstrumentField ](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceqryinstrumentfield)data struct |
| nRequestID     | int     |                                                                                                              |
| {% endtab %}   |         |                                                                                                              |
| {% endtabs %}  |         |                                                                                                              |

## **ReqQryInvestorPositionDetail**

请求查询投资者持仓明细

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

```csharp
int ReqQryInvestorPositionDetail(ICEQryInvestorPositionDetailField *pQryInvestorPositionDetail, int nRequestID)
```

| **Parameters**             | 类型      | 说明                                                                                                                                   |
| -------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| pQryInvestorPositionDetail | pointer | [ICEQryInvestorPositionDetailField](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceqryinvestorpositiondetailfield) data struct |
| nRequestID                 | int     |                                                                                                                                      |
| {% endtab %}               |         |                                                                                                                                      |

{% tab title="Return" %}
成功为0，否则失败\
持仓明细由callback OnRspQryInvestorPositionDetail返回
{% endtab %}
{% endtabs %}

## **ReqCombActionInsert**

申请组合录入请求

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

```cpp
int ReqCombActionInsert(ICEInputCombActionField *pInputCombAction, int iRequestID)
```

{% endtab %}

{% tab title="Return" %}
成功为0，否则失败
{% endtab %}

{% tab title="Remark" %}
组合合约:中间加入&

EX:TC.O.SSE.510050A.202103.C.3.746\&TC.O.SSE.510050A.202103.C.3.844
{% endtab %}
{% endtabs %}

| **Parameters**   | 类型      | 说明                                                                                                                     |
| ---------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- |
| pInputCombAction | pointer | [**ICEInputCombActionField**](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceinputcombactionfield-1) data struct |
| nRequestID       | int     |                                                                                                                        |

## **ReqQryCombAction**

请求查询申请组合

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

```cpp
int ReqQryCombAction(ICEQryCombActionField *pQryCombAction, int nRequestID)
```

{% endtab %}

{% tab title="Return" %}
成功为0，否则失败
{% endtab %}
{% endtabs %}

| **Parameters** | 类型      | 说明                                                                                                                 |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------ |
| pQryCombAction | pointer | [**ICEQryCombActionField**](/tcore-api/c++-regular-dll/jiao-yi-data-struct.md#iceqrycombactionfield-1) data struct |
| nRequestID     | int     |                                                                                                                    |