---
# System prepended metadata

title: 八、C / C++ / C# 共用資料結構
tags: [行情API技術文件]

---

# 八、C / C++ / C# 共用資料結構

## 8.1 TradeSession_List 交易時段列表

交易時段列表資料結構

C / C++
```
typedef struct _Mdcm_TradeSession_List {
Mdct_OffsetMinute          OffMinute; /* 時間偏移(分鐘) T 日:0~1439 , T-1 日:-1439~0 , T+1 日:1440~2879 */
Mdct_OffsetDay             OffDay;    /* 日期偏移(日) */
Mdct_TradeSession_Kind     Kind;      /* 交易時段-盤別種類 */
Mdcs_TradeSession_State    State;     /* 交易時段-盤別狀態 */
Mdcs_TradeSession_Action   Action;    /* 交易時段-State 動作旗號 */
} Mdcm_TradeSession_List, *LPMdcm_TradeSession_List;
```

C#
class MdcCSApi::TradeSessionList

說明:
時間偏移為負值，表示為前一天。
Ex: OffMinute=-180，即前一日 21:00 為開盤

日期偏移為負值，表示為 “前一個交易日” (非單純的前一日)
Ex: OffDay=-1, 若今天是星期一, 所表示的日期為上星期五

---

## 8.2 PriceScale_SubItem 價格間距子項

價格間距子項資料結構

C / C++
```
typedef struct _Mdcm_PriceScale_SubItem {
Mdct_Price ScopeMin;       /* 價格範圍最小值(下限) */
Mdct_Price ScopeMax;       /* 價格範圍是大值(上限) */
Mdct_ScopeMode ScopeMode;  /* 價格範圍比較模式 */
Mdct_Float Numerator;      /* 價格基準分子 */
Mdct_Float Denominator;    /* 價格基準分母 */
Mdct_Int MinMovement;      /* 最小跳動點數 */
*LPMdcm_PriceScale_SubItem;
```
C#
class MdcCSApi::CommodityRoot::PriceScaleSubItem

---

## 8.3 PriceScale_Item 價格間距

價格間距資料結構

C / C++

```
typedef struct _Mdcm_PriceScale_Item {
Mdct_PriceScaleKind      Kind;                          /* 價格檔位種類 */
Mdct_Int                 Count;                         /* 價格間距筆數 */
Mdcm_PriceScale_SubItem  Item[Mdcm_PriceScale_Sub_MAX]; /* 價格間距資訊 */
} Mdcm_PriceScale_Item, *LPMdcm_PriceScale_Item;
```

C#
class MdcCSApi::CommodityRoot::PriceScaleItem

---

## 8.4 Exchange 交易所資訊

交易所資料結構

C / C++

```
typedef struct _Mdcs_Exchange {
Mdct_SExchangeAbbr    Abbr;      /* 交易所傳輸代碼 */
Mdct_SExchangeName    Name;      /* 交易所名稱 */
Mdcs_ExchOrderType    OrderType; /* 下單類別旗號 */
} Mdcs_Exchange, *LPMdcs_Exchange;
#define MDCS_EXCHANGE_LENGTH sizeof(Mdcs_Exchange)
```

C#
class MdcCSApi::Exchange

---

## 8.5 CommodityRoot 商品根(品種)資訊

商品根(品種)資料結構

C / C++
```
typedef struct _Mdcs_CommodityRoot {
Mdct_SExchangeAbbr           ExchangeAbbr;                                /* 交易所傳輸代碼 */
Mdct_SCommodityRootAbbr      Abbr;                                        /* 品種傳輸代碼 */
Mdct_SCommodityRootName      Name;                                        /* 品種名稱 */
Mdct_Int                     TradeSessionCount;                           /* 交易時段資訊筆數 */
Mdct_Int                     PriceScaleCount;                             /* 價格間距資訊筆數 */
Mdcm_TradeSession_List       TradeSessions[Mdcm_TradeSession_List_MAX];   /* 交易時段資訊 */
Mdcm_PriceScale_Item         PriceScales[Mdcm_PriceScale_MAX];            /* 價格間距資訊 */
Mdct_SExchangeAbbr           TargetExchCode;                              /* 衍生性商品的交易所 */
Mdct_SCommodityCode          TargetCommCode;                              /* 衍生性商品的標地物 */
Mdct_Double                  ContractMultiplier;                          /* 契約乘數 */
Mdct_SCurrency               Currency;                                    /* 貨幣代碼 */
Mdct_Double                  Fee;                                         /* 手續費 */
Mdct_Double                  TransactionTax;                              /* 交易稅 */
Mdct_Int                     BoardLot;                                    /* 最小單位股數 */
Mdct_CommodityCategory       Category;                                    /* 根商品類別 */
Mdct_Utc                     Utc;                                         /* 時區 (分鐘單位) */
Mdct_CommodityRootCondition  Condition;                                   /* 根商品延伸資訊 */
} Mdcs_CommodityRoot, *LPMdcs_CommodityRoot;
```
C#
class MdcCSApi::CommodityRoot

---

## 8.6 Commodity 商品資料

商品資料結構

C / C++

```
typedef struct _Mdcs_Commodity {
Mdct_SExchangeAbbr                ExchangeAbbr;                         /* 交易所傳輸代碼 */
Mdct_SCommodityCode               Code;                                 /* 商品代碼 */
Mdct_SCommodityName               Name;                                 /* 商品名稱 */
Mdct_SCommodityRootAbbr           CommRootAbbr;                         /* 品種傳輸代碼 */
Mdct_Date                         DeliveryYM;                           /* 契約月份 */
Mdct_Date                         OrgContractDate;                      /* 交易所原生契約月份 */
Mdct_Date                         CreateDate;                           /* 上市日期 */
Mdct_Date                         SettlementDate;                       /* 結算日期 */
Mdct_Date                         NoticeDate1;                          /* 第一通知日 */
Mdct_Date                         NoticeDate2;                          /* 第二通知日 */
Mdct_Date                         ExpireDate;                           /* 市場最後交易日 */
Mdct_Date                         LastTradingday;                       /* 最後可交易日期 */
Mdct_CommodityCategory            Category;                             /* 商品類別 */
Mdct_BoardLot                     BoardLot;                             /* 最小單位股數 */
Mdct_Price                        StrikePrice;                          /* 選擇權履約價 */
Mdcm_CommodityCategoryCondition   CategoryCondition;                    /* 商品類別附加資訊 */
Mdct_Int                          PriceScaleCount;                      /* 價格間距筆數 */
Mdcm_PriceScale_SubItem           PriceScales[Mdcm_PriceScale_Sub_MAX]; /* 價格間距資訊 */
} Mdcs_Commodity, *LPMdcs_Commodity;
```
C#
class MdcCSApi::Commodity

---

## 8.7 CommodityResponse 商品資訊查詢回應資料

商品資訊查詢回應資料結構

C / C++

```
typedef struct _Mdcs_CommodityResponse {
Mdct_Int              ErrorCode;           /* 錯誤代碼 */
Mdct_CPChar           ErrorMessage;        /* 錯誤訊息 */
Mdct_Int              ExchangeCount;       /* 交易所數量 */
LPMdcs_Exchange       Exchange;            /* 交易所資訊 */
Mdct_Int              CommodityRootCount;  /* 商品品種數量 */
LPMdcs_CommodityRoot  CommodityRoot;       /* 商品品種資訊 */
Mdct_Int              CommodityCount;      /* 商品數量 */
LPMdcs_Commodity      Commodity;           /* 商品資訊 */
} Mdcs_CommodityResponse, *LPMdcs_CommodityResponse;
```

C#
class MdcCSApi::CommodityResponse

說明
ErrorCode 為0 時，表示查詢成功，ErrorMessage 也為 NULL (無說明)，Count 為
數量，資料在指標陣列中取出。

---

## 8.8 QuotationFlagBase 行情資料結構旗號基礎

行情資料結構

C / C++

```
typedef struct _Mdcs_Quot_FlagBase {
	struct {
		Mdcs_Quot_Column_Flag   Exist;  /* 存在旗號 */
		Mdcs_Quot_Column_Flag   Update; /* 更新旗號 */
	} _flag;
} Mdcs_Quot_FlagBase;
```

C#
struct MdcCSApi::Mdcs_Quot_FlagBase< T>

---

## 8.9 QuotationBasic 行情靜態資料結構

C / C++
```
typedef struct _Mdcs_Quot_Basic : public Mdcs_Quot_FlagBase {
Mdcs_QCT_Basic_TsState              TsState;             /* 交易時段狀態 */
Mdcs_QCT_Basic_TradingDay           TradingDay;          /* 交易日期 */
Mdcs_QCT_Basic_UpperLimitPrice      UpperLimitPrice;     /* 漲停價 */
Mdcs_QCT_Basic_LowerLimitPrice      LowerLimitPrice;     /* 跌停價 */
Mdcs_QCT_Basic_SettlementPrice      SettlementPrice;     /* 結算價 */
Mdcs_QCT_Basic_PreSettlementPrice   PreSettlementPrice;  /* 昨日結算價 */
Mdcs_QCT_Basic_PreClosePrice        PreClosePrice;       /* 昨日收盤價 */
Mdcs_QCT_Basic_PreOpenInterest      PreOpenInterest;     /* 昨日未平倉 */
Mdcs_QCT_Basic_TsKind               TsKind;              /*交易時段種類 */
Mdcs_QCT_Basic_ClosePrice           ClosePrice;          /* 收盤價 */
Mdcs_QCT_Basic_ReferencePrice       ReferencePrice;      /* 參考價 */
Mdcs_QCT_Basic_Utc                  Utc;                 /* UTC 分鐘時間 */
} Mdcs_Quot_Basic, *LPMdcs_Quot_Basic;
```
C#
struct MdcCSApi::Mdcs_Quot_Basic

---

## 8.10 QuotationDeal 行情成交資料結構

C / C++

```
typedef struct _Mdcs_Quot_Deal : public Mdcs_Quot_FlagBase {
Mdcs_QCT_Deal_Date                   Date;              /* 日期 */
Mdcs_QCT_Deal_Time                   Time;              /* 時間 */
Mdcs_QCT_Deal_LastPrice              LastPrice;         /* 最新價 */
Mdcs_QCT_Deal_OpenPrice              OpenPrice;         /* 今日開盤價 */
Mdcs_QCT_Deal_Amount                 Amount;            /* 成交金額 */
Mdcs_QCT_Deal_TotalAmount            TotalAmount;       /* 總成交金額 */
Mdcs_QCT_Deal_HighestPrice           HighestPrice;      /* 最高價 */
Mdcs_QCT_Deal_LowestPrice            LowestPrice;       /* 最低價 */
Mdcs_QCT_Deal_Volume                 Volume;            /* 現量 */
Mdcs_QCT_Deal_TotalVolume            TotalVolume;       /* 總量 */
Mdcs_QCT_Deal_OpenInterest           OpenInterest;      /* 合約持倉量 */
Mdcs_QCT_Deal_OutStandingVolume      OutStandingVolume; /* 當前未平倉量 */
Mdcs_QCT_Deal_PriceInDepth           PriceInDepth;      /* 價位於委託簿位置 */
Mdcs_QCT_Deal_BidPrice               BidPrice;          /* 買價 */
Mdcs_QCT_Deal_AskPrice               AskPrice;          /* 賣價 */
Mdcs_QCT_Deal_BidVolume              BidVolume;         /* 買量 */
Mdcs_QCT_Deal_AskVolume              AskVolume;         /* 賣量 */
Mdcs_QCT_Deal_TradeCondition         TradeCondition;    /* 交易狀態 */
Mdcs_QCT_Deal_OTCVolume              OTCVolume;         /* 場外交易量(Over The Counter) */
} Mdcs_Quot_Deal, *LPMdcs_Quot_Deal;
```
C#
struct MdcCSApi::Mdcs_Quot_Deal

---

## 8.11 QuotationDepth 行情委託簿資料結構

C / C++
```
typedef struct _Mdcs_Quot_Depth : public Mdcs_Quot_FlagBase {
Mdcs_QCT_Depth_Date             Date;         /* 日期 */
Mdcs_QCT_Depth_Time             Time;         /* 時間 */
Mdcs_QCT_Depth_BidPrice1        BidPrice1;    /* 買價1 */
Mdcs_QCT_Depth_AskPrice1        AskPrice1;    /* 賣價1 */
Mdcs_QCT_Depth_BidVolume1       BidVolume1;   /* 買量1 */
Mdcs_QCT_Depth_AskVolume1       AskVolume1;   /* 賣量1 */
Mdcs_QCT_Depth_BidPrice2        BidPrice2;    /* 買價2 */
Mdcs_QCT_Depth_AskPrice2        AskPrice2;    /* 賣價2 */
Mdcs_QCT_Depth_BidVolume2       BidVolume2;   /* 買量2 */
Mdcs_QCT_Depth_AskVolume2       AskVolume2;   /* 賣量2 */
Mdcs_QCT_Depth_BidPrice3        BidPrice3;    /* 買價3 */
Mdcs_QCT_Depth_AskPrice3        AskPrice3;    /* 賣價3 */
Mdcs_QCT_Depth_BidVolume3       BidVolume3;   /* 買量3 */
Mdcs_QCT_Depth_AskVolume3       AskVolume3;   /* 賣量3 */
Mdcs_QCT_Depth_BidPrice4        BidPrice4;    /* 買價4 */
Mdcs_QCT_Depth_AskPrice4        AskPrice4;    /* 賣價4 */
Mdcs_QCT_Depth_BidVolume4       BidVolume4;   /* 買量4 */
Mdcs_QCT_Depth_AskVolume4       AskVolume4;   /* 賣量4 */
Mdcs_QCT_Depth_BidPrice5        BidPrice5;    /* 買價5 */
Mdcs_QCT_Depth_AskPrice5        AskPrice5;    /* 賣價5 */
Mdcs_QCT_Depth_BidVolume5       BidVolume5;   /* 買量5 */
Mdcs_QCT_Depth_AskVolume5       AskVolume5;   /* 賣量5 */
Mdcs_QCT_Depth_BidPrice6        BidPrice6;    /* 買價6 */
Mdcs_QCT_Depth_AskPrice6        AskPrice6;    /* 賣價6 */
Mdcs_QCT_Depth_BidVolume6       BidVolume6;   /* 買量6 */
Mdcs_QCT_Depth_AskVolume6       AskVolume6;   /* 賣量6 */
Mdcs_QCT_Depth_BidPrice7        BidPrice7;    /* 買價7 */
Mdcs_QCT_Depth_AskPrice7        AskPrice7;    /* 賣價7 */
Mdcs_QCT_Depth_BidVolume7       BidVolume7;   /* 買量7 */
Mdcs_QCT_Depth_AskVolume7       AskVolume7;   /* 賣量7 */
Mdcs_QCT_Depth_BidPrice8        BidPrice8;    /* 買價8 */
Mdcs_QCT_Depth_AskPrice8        AskPrice8;    /* 賣價8 */
Mdcs_QCT_Depth_BidVolume8       BidVolume8;   /* 買量8 */
Mdcs_QCT_Depth_AskVolume8       AskVolume8;   /* 賣量8 */
Mdcs_QCT_Depth_BidPrice9        BidPrice9;    /* 買價9 */
Mdcs_QCT_Depth_AskPrice9        AskPrice9;    /* 賣價9 */
Mdcs_QCT_Depth_BidVolume9       BidVolume9;   /* 買量9 */
Mdcs_QCT_Depth_AskVolume9       AskVolume9;   /* 賣量9 */
Mdcs_QCT_Depth_BidPrice10       BidPrice10;   /* 買價10 */
Mdcs_QCT_Depth_AskPrice10       AskPrice10;   /* 賣價10 */
Mdcs_QCT_Depth_BidVolume10      BidVolume10;  /* 買量10 */
Mdcs_QCT_Depth_AskVolume10      AskVolume10;  /* 賣量10 */
Mdcs_QCT_Depth_BidPrice11       BidPrice11;   /* 買價11 */
Mdcs_QCT_Depth_AskPrice11       AskPrice11;   /* 賣價11 */
Mdcs_QCT_Depth_BidVolume11      BidVolume11;  /* 買量11 */
Mdcs_QCT_Depth_AskVolume11      AskVolume11;  /* 賣量11 */
Mdcs_QCT_Depth_BidPrice12       BidPrice12;   /* 買價12 */
Mdcs_QCT_Depth_AskPrice12       AskPrice12;   /* 賣價12 */
Mdcs_QCT_Depth_BidVolume12      BidVolume12;  /* 買量12 */
Mdcs_QCT_Depth_AskVolume12      AskVolume12;  /* 賣量12 */
Mdcs_QCT_Depth_BidPrice13       BidPrice13;   /* 買價13 */
Mdcs_QCT_Depth_AskPrice13       AskPrice13;   /* 賣價13 */
Mdcs_QCT_Depth_BidVolume13      BidVolume13;  /* 買量13 */
Mdcs_QCT_Depth_AskVolume13      AskVolume13;  /* 賣量13 */
Mdcs_QCT_Depth_BidPrice14       BidPrice14;   /* 買價14 */
Mdcs_QCT_Depth_AskPrice14       AskPrice14;   /* 賣價14 */
Mdcs_QCT_Depth_BidVolume14      BidVolume14;  /* 買量14 */
Mdcs_QCT_Depth_AskVolume14      AskVolume14;  /* 賣量14 */
Mdcs_QCT_Depth_BidPrice15       BidPrice15;   /* 買價15 */
Mdcs_QCT_Depth_AskPrice15       AskPrice15;   /* 賣價15 */
Mdcs_QCT_Depth_BidVolume15      BidVolume15;  /* 買量15 */
Mdcs_QCT_Depth_AskVolume15      AskVolume15;  /* 賣量15 */
Mdcs_QCT_Depth_BidPrice16       BidPrice16;   /* 買價16 */
Mdcs_QCT_Depth_AskPrice16       AskPrice16;   /* 賣價16 */
Mdcs_QCT_Depth_BidVolume16      BidVolume16;  /* 買量16 */
Mdcs_QCT_Depth_AskVolume16      AskVolume16;  /* 賣量16 */
Mdcs_QCT_Depth_BidPrice17       BidPrice17;   /* 買價17 */
Mdcs_QCT_Depth_AskPrice17       AskPrice17;   /* 賣價17 */
Mdcs_QCT_Depth_BidVolume17      BidVolume17;  /* 買量17 */
Mdcs_QCT_Depth_AskVolume17      AskVolume17;  /* 賣量17 */
Mdcs_QCT_Depth_BidPrice18       BidPrice18;   /* 買價18 */
Mdcs_QCT_Depth_AskPrice18       AskPrice18;   /* 賣價18 */
Mdcs_QCT_Depth_BidVolume18      BidVolume18;  /* 買量18 */
Mdcs_QCT_Depth_AskVolume18      AskVolume18;  /* 賣量18 */
Mdcs_QCT_Depth_BidPrice19       BidPrice19;   /* 買價19 */
Mdcs_QCT_Depth_AskPrice19       AskPrice19;   /* 賣價19 */
Mdcs_QCT_Depth_BidVolume19      BidVolume19;  /* 買量19 */
Mdcs_QCT_Depth_AskVolume19      AskVolume19;  /* 賣量19 */
Mdcs_QCT_Depth_BidPrice20       BidPrice20;   /* 買價20 */
Mdcs_QCT_Depth_AskPrice20       AskPrice20;   /* 賣價20 */
Mdcs_QCT_Depth_BidVolume20      BidVolume20;  /* 買量20 */
Mdcs_QCT_Depth_AskVolume20      AskVolume20;  /* 賣量20 */
} Mdcs_Quot_Depth, *LPMdcs_Quot_Depth;
```

C#
struct MdcCSApi::Mdcs_Quot_Depth

---

## 8.12 QuotationPtr 事件使用行情結構指位器

C / C++
```
typedef struct _Mdcs_QuotationPtr {
Mdct_PChar          Exchange;   /* 交易所 */
Mdct_PChar          Commodity;  /* 商品代碼 */
Mdct_UniqueID       UniqueID;   /* 唯一識別ID */
LPMdcs_Quot_Basic   Basic;      /* 基本資料 */
LPMdcs_Quot_Deal    Deal;       /* 成交資料 */
LPMdcs_Quot_Depth   Depth;      /* 委託簿資料 */
} Mdcs_QuotationPtr, *LPMdcs_QuotationPtr;
```

C#
[struct MdcCSApi::Mdcs_Quotation](/t--ZA6_RRXS99V04pAiJ7Q#114-MdcCommon-%E9%80%9A%E7%94%A8%E8%B3%87%E8%A8%8A%E7%89%A9%E4%BB%B6)

※ UniqueID 特性請參 [附錄二、QuotationPtr.UniqueID 應用邏輯與特性](/lSqguQgsQ_W9FmmSMztgBQ#132-%E9%99%84%E9%8C%84%E4%BA%8C%E3%80%81QuotationPtrUniqueID-%E6%87%89%E7%94%A8%E9%82%8F%E8%BC%AF%E8%88%87%E7%89%B9%E6%80%A7)

---

## 8.13 QuotationResponse 行情快照回應

行情快照查詢回應資料結構

C / C++

```
typedef struct _Mdcs_QuotationResponse {
Mdct_Int             ErrorCode;       /* 錯誤代碼 */
Mdct_CPChar          ErrorMessage;    /* 錯誤訊息 */
Mdct_Int             QuotationCount;  /* 回傳陣列筆數 */
LPMdcs_QuotationPtr  Quotation;       /* 回傳查詢陣列 */
} Mdcs_QuotationResponse, *LPMdcs_QuotationResponse;
```

C#
class MdcCSApi::QuotationResponse

說明
ErrorCode 為0 時，表示查詢成功，ErrorMessage 也為 NULL (無說明)，
QuotationCount 為查詢回應的數量，資料在指標陣列中取出。

---

## 8.14 RequestArgument 查詢參數

歷史及即時資料查詢參數
C / C++

```
typedef struct _Mdcs_RequestArgument {
Mdct_RequestId          RequestId;      /* 查詢唯一識別碼 */
Mdct_SExchangeAbbr      ExchangeAbbr;   /* 交易所代碼 */
Mdct_SCommodityCode     CommodityCode;  /* 商品代碼 */
Mdcm_DataType           DataType;       /* 資料類型(Mdcm_DT_xxxx)*/
Mdcs_DockMode           DockMode;       /* 指定資料歸線模式 */
Mdct_Bool               Realtime;       /* 指明需要即時行情加入 */
Mdct_Int                DockValue;      /* 指定歸線參數(N 分線) */
Mdcs_Condition          Condition;      /* 附加條件(Mdcs_CND_xxxx) */
Mdct_Date               StartDate;      /* 查詢的起始日期 */
Mdct_TimeEx             StartTime;      /* 查詢的起始時間 */
Mdct_Date               EndDate;        /* 查詢的起始日期 */
Mdct_TimeEx             EndTime;        /* 查詢的起始時間 */
Mdcs_TimeZone           TimeZone;       /* 查詢的日期時間所屬時區*/
} Mdcs_RequestArgument, *LPMdcs_RequestArgument;
```

C#
class MdcCSApi::RequestArgument

---

## 8.15 Tick 逐筆成交

逐筆成交的歷史及即時資料結構

C / C++
```
typedef struct _Mdcs_Tick {
Mdcs_HCT_Date           Date;         /* 日期 YYYYMMDD */
Mdcs_HCT_Time           Time;         /* 時間 HHMMSSfff */
Mdcs_HCT_Price          Price;        /* 成交價 */
Mdcs_HCT_Volume         Volume;       /* 成交單量 */
Mdcs_HCT_Amount         Amount;       /* 成交金額 */
Mdcs_HCT_PriceInDepth   PriceInDepth; /* 價位於委託簿位置 */
Mdcs_RespDataStatus     Status;       /* 狀態旗號 */
} Mdcs_Tick, *LPMdcs_Tick;
```

C#
Struct MdcCSApi::Mdcs_Tick

---

## 8.16 Depth 買賣20檔

買賣檔位 (委託簿) 歷史及即時資料結構

C / C++

```
typedef struct _Mdcs_Depth {
Mdcs_HCT_Date          Date;         /* 日期 YYYYMMDD */
Mdcs_HCT_Time          Time;         /* 時間 HHMMSSfff */
Mdcs_HCT_BidPrice1     BidPrice1;    /* 買價1 */
Mdcs_HCT_AskPrice1     AskPrice1;    /* 賣價1 */
Mdcs_HCT_BidVolume1    BidVolume1;   /* 買量1 */
Mdcs_HCT_AskVolume1    AskVolume1;   /* 賣量1 */
Mdcs_HCT_BidPrice2     BidPrice2;    /* 買價2 */
Mdcs_HCT_AskPrice2     AskPrice2;    /* 賣價2 */
Mdcs_HCT_BidVolume2    BidVolume2;   /* 買量2 */
Mdcs_HCT_AskVolume2    AskVolume2;   /* 賣量2 */
Mdcs_HCT_BidPrice3     BidPrice3;    /* 買價3 */
Mdcs_HCT_AskPrice3     AskPrice3;    /* 賣價3 */
Mdcs_HCT_BidVolume3    BidVolume3;   /* 買量3 */
Mdcs_HCT_AskVolume3    AskVolume3;   /* 賣量3 */
Mdcs_HCT_BidPrice4     BidPrice4;    /* 買價4 */
Mdcs_HCT_AskPrice4     AskPrice4;    /* 賣價4 */
Mdcs_HCT_BidVolume4    BidVolume4;   /* 買量4 */
Mdcs_HCT_AskVolume4    AskVolume4;   /* 賣量4 */
Mdcs_HCT_BidPrice5     BidPrice5;    /* 買價5 */
Mdcs_HCT_AskPrice5     AskPrice5;    /* 賣價5 */
Mdcs_HCT_BidVolume5    BidVolume5;   /* 買量5 */
Mdcs_HCT_AskVolume5    AskVolume5;   /* 賣量5 */
Mdcs_HCT_BidPrice6     BidPrice6;    /* 買價6 */
Mdcs_HCT_AskPrice6     AskPrice6;    /* 賣價6 */
Mdcs_HCT_BidVolume6    BidVolume6;   /* 買量6 */
Mdcs_HCT_AskVolume6    AskVolume6;   /* 賣量6 */
Mdcs_HCT_BidPrice7     BidPrice7;    /* 買價7 */
Mdcs_HCT_AskPrice7     AskPrice7;    /* 賣價7 */
Mdcs_HCT_BidVolume7    BidVolume7;   /* 買量7 */
Mdcs_HCT_AskVolume7    AskVolume7;   /* 賣量7 */
Mdcs_HCT_BidPrice8     BidPrice8;    /* 買價8 */
Mdcs_HCT_AskPrice8     AskPrice8;    /* 賣價8 */
Mdcs_HCT_BidVolume8    BidVolume8;   /* 買量8 */
Mdcs_HCT_AskVolume8    AskVolume8;   /* 賣量8 */
Mdcs_HCT_BidPrice9     BidPrice9;    /* 買價9 */
Mdcs_HCT_AskPrice9     AskPrice9;    /* 賣價9 */
Mdcs_HCT_BidVolume9    BidVolume9;   /* 買量9 */
Mdcs_HCT_AskVolume9    AskVolume9;   /* 賣量9 */
Mdcs_HCT_BidPrice10    BidPrice10;   /* 買價10 */
Mdcs_HCT_AskPrice10    AskPrice10;   /* 賣價10 */
Mdcs_HCT_BidVolume10   BidVolume10;  /* 買量10 */
Mdcs_HCT_AskVolume10   AskVolume10;  /* 賣量10 */
Mdcs_HCT_BidPrice11    BidPrice11;   /* 買價11 */
Mdcs_HCT_AskPrice11    AskPrice11;   /* 賣價11 */
Mdcs_HCT_BidVolume11   BidVolume11;  /* 買量11 */
Mdcs_HCT_AskVolume11   AskVolume11;  /* 賣量11 */
Mdcs_HCT_BidPrice12    BidPrice12;   /* 買價12 */
Mdcs_HCT_AskPrice12    AskPrice12;   /* 賣價12 */
Mdcs_HCT_BidVolume12   BidVolume12;  /* 買量12 */
Mdcs_HCT_AskVolume12   AskVolume12;  /* 賣量12 */
Mdcs_HCT_BidPrice13    BidPrice13;   /* 買價13 */
Mdcs_HCT_AskPrice13    AskPrice13;   /* 賣價13 */
Mdcs_HCT_BidVolume13   BidVolume13;  /* 買量13 */
Mdcs_HCT_AskVolume13   AskVolume13;  /* 賣量13 */
Mdcs_HCT_BidPrice14    BidPrice14;   /* 買價14 */
Mdcs_HCT_AskPrice14    AskPrice14;   /* 賣價14 */
Mdcs_HCT_BidVolume14   BidVolume14;  /* 買量14 */
Mdcs_HCT_AskVolume14   AskVolume14;  /* 賣量14 */
Mdcs_HCT_BidPrice15    BidPrice15;   /* 買價15 */
Mdcs_HCT_AskPrice15    AskPrice15;   /* 賣價15 */
Mdcs_HCT_BidVolume15   BidVolume15;  /* 買量15 */
Mdcs_HCT_AskVolume15   AskVolume15;  /* 賣量15 */
Mdcs_HCT_BidPrice16    BidPrice16;   /* 買價16 */
Mdcs_HCT_AskPrice16    AskPrice16;   /* 賣價16 */
Mdcs_HCT_BidVolume16   BidVolume16;  /* 買量16 */
Mdcs_HCT_AskVolume16   AskVolume16;  /* 賣量16 */
Mdcs_HCT_BidPrice17    BidPrice17;   /* 買價17 */
Mdcs_HCT_AskPrice17    AskPrice17;   /* 賣價17 */
Mdcs_HCT_BidVolume17   BidVolume17;  /* 買量17 */
Mdcs_HCT_AskVolume17   AskVolume17;  /* 賣量17 */
Mdcs_HCT_BidPrice18    BidPrice18;   /* 買價18 */
Mdcs_HCT_AskPrice18    AskPrice18;   /* 賣價18 */
Mdcs_HCT_BidVolume18   BidVolume18;  /* 買量18 */
Mdcs_HCT_AskVolume18   AskVolume18;  /* 賣量18 */
Mdcs_HCT_BidPrice19    BidPrice19;   /* 買價19 */
Mdcs_HCT_AskPrice19    AskPrice19;   /* 賣價19 */
Mdcs_HCT_BidVolume19   BidVolume19;  /* 買量19 */
Mdcs_HCT_AskVolume19   AskVolume19;  /* 賣量19 */
Mdcs_HCT_BidPrice20    BidPrice20;   /* 買價20 */
Mdcs_HCT_AskPrice20    AskPrice20;   /* 賣價20 */
Mdcs_HCT_BidVolume20   BidVolume20;  /* 買量20 */
Mdcs_HCT_AskVolume20   AskVolume20;  /* 賣量20 */
Mdcs_RespDataStatus Status; /* 狀態旗號 */
} Mdcs_Depth, *LPMdcs_Depth;
```

C#
Struct MdcCSApi::Mdcs_Depth

---

## 8.17 Candlestick 燭K線

燭K 線 (分線、日線) 的歷史與即時資料結構
C / C++

```
typedef struct _Mdcs_Candlestick {
Mdcs_HCT_Date                Date;              /* 日期 YYYYMMDD */
Mdcs_HCT_Time                Time;              /* 時間 HHMMSSfff */
Mdcs_HCT_OpenPrice           OpenPrice;         /* 開價 */
Mdcs_HCT_HighestPrice        HighestPrice;      /* 高價 */
Mdcs_HCT_LowestPrice         LowestPrice;       /* 低價 */
Mdcs_HCT_ClosePrice          ClosePrice;        /* 收價 */
Mdcs_HCT_TotalVolume         TotalVolume;       /* 總成交量 */
Mdcs_HCT_TotalAmount         TotalAmount;       /* 總成交金額 */
Mdcs_HCT_OpenInterest        OpenInterest;      /* 未平倉量 */
Mdcs_HCT_UpTicks             UpTicks;           /* 上漲筆數 */
Mdcs_HCT_UpVolume            UpVolume;          /* 上漲量 */
Mdcs_HCT_UnchangedTicks      UnchangedTicks;    /* 平盤筆數 */
Mdcs_HCT_UnchangedVolume     UnchangedVolume;   /* 平盤量 */
Mdcs_HCT_DownTicks           DownTicks;         /* 下跌筆數 */
Mdcs_HCT_DownVolume          DownVolume;        /* 下跌量 */
Mdcs_RespDataStatus          Status;            /* 狀態旗號 */
} Mdcs_Candlestick, *LPMdcs_Candlestick;
```

C#
Struct MdcCSApi::Mdcs_Candlestick

---

## 8.18 HistoryResponse 歷史查詢回應資料

歷史查詢回應資料結構
C / C++
```
typedef struct _Mdcs_HistoryResponse {
Mdct_Int               ErrorCode;    /* 錯誤代碼 */
Mdct_CPChar            ErrorMessage; /* 錯誤訊息 */
Mdcs_ResponseDataType  RespDataType; /* 資料結構類別 */
Mdct_PVoid             pData;        /* 指向不同的資料結構 */
Mdct_Size              Count;        /* 資料結構筆數 */
} Mdcs_HistoryResponse, *LPMdcs_HistoryResponse;
```

C#
Struct MdcCSApi::HistoryResponse

說明
ErrorCode 為0 時，表示查詢成功，ErrorMessage 也為 NULL (無說明)。
resp_data_type: 資料結構類別 ([Mdcs_RDT_XXXX](/dU9xSl1YTW2oYjzsjHtSZQ#719-ResponseDataType-%E6%AD%B7%E5%8F%B2%E8%B3%87%E6%96%99%E9%A1%9E%E5%9E%8B))
pdata: 依 resp_data_type 指向不同的資料結構
count: 資料結構筆數

特別說明 resp_data_type / pdata

|Resp_data_type|Pdata|
|---|---|
|Mdcs_RDT_Tick |[LPMdcs_Tick](/v-KO6tAmRqmK8ykncHtxSQ#815-Tick-%E9%80%90%E7%AD%86%E6%88%90%E4%BA%A4)|
|Mdcs_RDT_Depth |[LPMdcs_Depth](/v-KO6tAmRqmK8ykncHtxSQ#816-Depth-%E8%B2%B7%E8%B3%A320-%E6%AA%94)|
|Mdcs_RDT_Candlestick |[LPMdcs_Candlestick](/v-KO6tAmRqmK8ykncHtxSQ#817-Candlestick-%E7%87%ADK-%E7%B7%9A)|

---

## 8.19 ContinuousCode 連續月商品資訊

連續月商品資料結構

C / C++

```
typedef struct _Mdcs_ContinuousCode {
Mdct_SExchangeAbbr   ExchangeAbbr;  /* 交易所代碼 */
Mdct_SCommodityCode  CommodityCode; /* 連續月商品代碼 */
Mdct_SCommodityName  CommodityName; /* 連續月商品名稱 */
Mdct_SCommodityCode  NowRefCode;    /* 當下參考商品代碼 */
Mdct_SCommodityCode  NextRefCode;   /* 切換商品代碼 */
Mdct_Date            NextUtcDate;   /* 切換UTC 日期(YYYYMMDD) */
Mdct_Time            NextUtcTime;   /* 切換UTC 時間(HHMMSSfff) */
} Mdcs_ContinuousCode, *LPMdcs_ContinuousCode;
```

C#
Struct MdcCSApi::ContinuousCode







---
###### tags: `行情API技術文件`