> 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/tcquotewrapperapi-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](/tcore-api/com-api/tcquotewrapperapi-events.md)推送连线状态。
{% endtab %}
{% endtabs %}

## **Disconnect**

Disconnect TCore。

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

```cpp
Disconnect();
```

{% endtab %}
{% endtabs %}

## **SubQuote**

订阅行情资料。

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

```csharp
SubQuote([in] LONG DataType, [in] IDispatch* DataParameters, [out,retval] LONG* plSubCount);
```

| **Parameters** | 类型     | 说明                                                                                      |
| -------------- | ------ | --------------------------------------------------------------------------------------- |
| DataType       | long   | <p>1 : 实时行情 </p><p>2 : 当日Ticks </p><p>4 : 历史1分K </p><p>5 : 历史日K </p><p>6 : 实时GREEKS</p> |
| DataParameters | object | 订阅资料物件 [DataParameters](/tcore-api/com-api/quote-object-parameter.md#dataparameters)    |
| {% endtab %}   |        |                                                                                         |

{% tab title="Return" %}

* 0 : 订阅失败
* 1 : 订阅成功
* -1 : 订阅数超过上限
  {% endtab %}

{% tab title="Description" %}
订阅成功后，由event [OnQuoteData](/tcore-api/com-api/tcquotewrapperapi-events.md#onquotedata)主动推送行情资料。
{% endtab %}
{% endtabs %}

## **UnsubQuote**

解除订阅行情资料。

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

```csharp
UnsubQuote([in] LONG DataType, [in] IDispatch* DataParameters, [out,retval] LONG* plSubCount);
```

| **Parameters**     | 类型     | 说明                                                                                      |
| ------------------ | ------ | --------------------------------------------------------------------------------------- |
| **DataType**       | long   | <p>1 : 实时行情 </p><p>2 : 当日Ticks </p><p>4 : 历史1分K </p><p>5 : 历史日K </p><p>6 : 实时GREEKS</p> |
| **DataParameters** | object | 订阅资料物件 [DataParameters](/tcore-api/com-api/quote-object-parameter.md#dataparameters)    |
| {% endtab %}       |        |                                                                                         |

{% tab title="Respone" %}

* 0 : 解订阅失败
* 1 : 解订阅成功
  {% endtab %}
  {% endtabs %}

## **GetSymbolClassifications**

取得商品分类表。

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

```csharp
GetSymbolClassifications([in] BSTR Classify, [in] BSTR Exchange, [in] BSTR Symbol, [in] BSTR Month, [in] BSTR CallPut, [out,retval] BSTR* RetVal);
```

| **Parameters** | 类型     | 说明       |
| -------------- | ------ | -------- |
| Classify       | string | 分类表ID    |
| Exchange       | string | 交易所      |
| Symbol         | string | 商品       |
| Month          | string | 月份       |
| CallPut        | string | Call Put |
| {% endtab %}   |        |          |

{% tab title="Return" %}
使用说明

1. Classify Exchange Symbol均带空白，可取得分类表ID。
2. Classify带入分类表ID，可取得分类交易所。
3. Classify带入分类表ID，Exchange带入分类交易所，可取得分类商品。

Classify带入分类表ID，Exchange带入分类交易所，Symbol带入分类商品，可取得该商品的合约月份。
{% 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 </p><p>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 %}   |        |      |

{% tab title="Return" %}
回传合约到期日
{% endtab %}
{% endtabs %}

## **GetProductCurrency**

取得商品币别。

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

```csharp
GetProductCurrency([in] BSTR SymbolID, [out,retval] BSTR* Currency);
```

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

{% tab title="Return" %}
回传商品币别。
{% endtab %}
{% endtabs %}

## **GetCurrencyExchangeRate**

取得币别汇率。

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

```csharp
GetCurrencyExchangeRate([in] BSTR Currency, [out,retval] BSTR* ExchangeRate);
```

| **Parameters** | 类型     | 说明             |
| -------------- | ------ | -------------- |
| Currency       | string | 币别对应，ex.US/HK。 |
| {% endtab %}   |        |                |
| {% endtabs %}  |        |                |