T4.dll下單元件更新說明（1.0.131）

函式名稱

函式用途簡述

i.

init_t4

初始化 (建立 DLL 環境、連接主機、登入永豐金證券/期貨)

add_acc_ca

帳戶加入憑證清單 (下單之前必須加入)

verify_ca_pass

憑證驗證測試 (必須為已加入憑證清單之帳戶)

ii.

stock_order

國內證券下單 (證券帳戶必須加入驗證清單)

stock_cancel

國內證券刪單 (證券帳戶必須加入驗證清單)

future_order

國內期貨下單 (期貨帳戶必須加入驗證清單)

future_cancel

國內期貨刪單 (期貨帳戶必須加入驗證清單)

future_change

國內期貨改價 (期貨帳戶必須加入憑證清單)

option_order

國內選擇權下單 (期貨帳戶必須加入驗證清單)

option_cancel

國內選擇權刪單 (期貨帳戶必須加入驗證清單)

ffuture_order

國外期貨下單 (期貨帳戶必須加入驗證清單)

ffuture_cancel

國外期貨刪單 (期貨帳戶必須加入驗證清單)

iii.

get_response

國內下(刪)單回報查詢 (e-Leader 8891)

ff_get_response

國外下(刪)單回報查詢 (e-Leader 8002)

fo_unsettled_qry

國內期權未平倉查詢 (e-Leader 7201)

fo_order_qry

期權委託查詢 (e-Leader 6207)早期版本

fo_order_qry2

期權委託查詢 (e-Leader 6207) 新版

ff_get_info

國外期貨權益數查詢 (e-Leader 8003)

stock_balance_qry

國內證券庫存查詢 (e-Leader 3202)

stock_balance_sum

國內證券未實現損益匯總。 (e-Leader 3324)

stock_balance_detail

國內證券未實現個股明細。 (e-Leader 3151)

ff_get_positions

國外期貨部位查詢 (e-Leader 8001)

ff_order_qry

國外期貨委託查詢 (e-Leader 8002)

fo_get_day_info

國內期權當日權益數查詢 (e-Leader 7102)

fo_get_hist_info

國內期權歷史權益數查詢 (e-Leader 7103)

iv.

get_response_log

交易回報紀錄

check_response_buffer

主動(即時)交易回報-檢查是否已收到回報

timer_response_log

主動(即時)交易回報-讀取回報內容

get_response_evt

取得回報 Event Handle

fifo_response_log

先進先出式交易回報

v.

change_echo

切換下單回覆模式 (下單後是否等待委託回報，預設為「on」)

log_out

登出 init_t4，並清除所有已列之憑證

show_version

回傳目前 API 版本

show_list

回傳目前使用者下所有帳戶 (包含證券帳戶、期貨帳戶)

show_list2

回傳目前使用者下所有帳戶(包含證券、期貨及帳戶別)

show_ip

顯示連線主機 Domain Name

函式名稱：

init_t4

函式功能：

初始化(建立DLL 環境、連接主機、登入永豐金證券/期貨)

VC 宣告：

BSTR init_t4( char* login_id

, char* login_pass

, char* dll_path );

VBA 宣告：

Private Declare Function init_t4 Lib "C:vba dllt4.dll" _

(ByVal login_id As String _

, ByVal login_pass As String _

, ByVal dll_path As String) As String

傳入參數：

login_id : 使用者ID (通常為身份證號，非帳戶)

login_pass : 登入密碼(連線登入密碼，非憑證密碼)

dll_path : DLL 放置路徑(空白或不指定則自動偵測)

使用範例：

ret = init_t4( "A123456789", "12345678", "" );

回傳值：

正常：初始化成功(或：已初始化)

異常：會以"Error:" 開頭，接著錯誤訊息。

函式名稱：

add_acc_ca

函式功能：

將證券、憑證帳戶加入憑證清單(下單之前必須加入)

VC 宣告：

BSTR add_acc_ca( char* branch

, char* account

, char* acc_id

, char* ca_path

, ca_password );

VBA 宣告：

Private Declare Function init_t4 Lib "C:vba dllt4.dll" _

(ByVal branch As String _

, ByVal account As String _

, ByVal acc_id As String _

, ByVal acc_ca_path As String _

, ByVal acc_ca_pass As String) As String

傳入參數：

branch: 分行(期貨以F開頭, 證券僅代分公司代碼)ps.分公司與帳戶可由show_list取得

account: 帳戶

acc_id: 憑證ID (身份證號)

ca_path: 憑證檔案所在路徑

ca_password: 憑證密碼

使用範例：

期貨：ret = add_acc_ca( "F002000", "9999999", "A123456789", "C:eKey551A123456789S", "12345678" );

證券：ret = add_acc_ca( "9A95", "9999999", "A123456789", "C:ekey551A123456789S", "12345678" );

回傳值：

正常：CA憑證資料登錄成功

異常："Error:" 開頭，接著錯誤訊息。

函式名稱：

verify_ca_pass

函式功能：

憑證驗章測試

VC 宣告：

BSTR verify_ca_pass( char*branch, char*account );

VBA 宣告：

Private Declare Function init_t4 Lib "C:vba dllt4.dll" _

(ByVal branch As String, ByVal account As String) As String

傳入參數：

branch: 分行(期貨以F開頭, 證券以S開頭)

account: 帳戶

使用範例：

ret = verify_ca_pass( "F002000", "9999999" );

回傳值：

正常：""

異常：Error: CA驗證錯誤

函式名稱：

stock_order

函式功能：

國內證券下單

VC 宣告：

BSTR stock_order( char*buy_or_sell

, char*branch

, char*account

, char*stock_id

, char*ord_type

, char*price

, char*amount

, char*string

, char*price_type );

VBA 宣告：

Private Declare Function stock_order Lib "C:vba dllt4.dll"

(ByVal buy_or_sell As String _

, ByVal branch As String _

, ByVal account As String _

, ByVal code As String _

, ByVal ord_type As String _

, ByVal price As String _

, ByVal amount As String _

, ByVal price_type As String) _

As String

傳入參數：

buy_or_sell: "B"=買, "S"=賣

branch: 證券分公司代號

account: 證券帳戶

stock_id: 股票代碼

ord_type: 交易類別

"P0"=定盤現股, "P3"=定盤融資, "P4"=定盤融券

"00"=整股現股, "03"=整股融資, "04"=整股融券

"20"=零股

price: 價格6 位數(定盤、漲跌停時，此參數忽略不作用，會帶0.0)

amount: 張數3 位數(零股則為股數)

price_type: " "=限價, "2"=漲停價, "3"=跌停價

使用範例：

stock_order( "B", "5510", "9876543", "2890", "00", "13.00", "1", " " );

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(九)

函式名稱：

stock_cancel

函式功能：

國內證券刪單

VC 宣告：

BSTR stock_cancel( char*buy_or_sell

, char*branch

, char*account

, char*stock_id

, char*price_type

, char*ord_seq

, char*ord_no

, char*pre_order );

VBA 宣告：

Private Declare Function stock_cancel Lib "C:vba dllt4.dll" _

(ByVal buy_or_sell As String _

, ByVal branch As String _

, ByVal account As String _

, ByVal stock_id As String _

, ByVal ord_type As String _

, ByVal ord_seq As String _

, ByVal ord_no As String _

, ByVal pre_order As String) As String

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 證券分公司代號

account : 證券帳戶

stock_id: 股票代號

ord_type :

"P0" 定盤現股, "P3" 定盤融資, "P4" 定盤融卷

"00" 整股現股, "03" 整股融資, "04" 整股融卷

"20" 零股

ord_seq : 網路單號

ord_no: 委託單號

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

stock_cancel( "B", "5510", "9876543", "2890", "00", "123456", "12345", " " );

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(九)

函式名稱：

future_order

函式功能：

國內期貨下單

VC 宣告：

BSTR future_order( char*buy_or_sell

, char*branch

, char*account

, char*future_id

, char*price

, char*amount

, char*price_type

, char*ordtype

, char*octtype );

VBA 宣告：

Private Declare Function future_order Lib "C:vba dllt4.dll" _

(ByVal buy_or_sell As String _

, ByVal branch As String _

, ByVal account As String _

, ByVal future_id As String _

, ByVal price As String _

, ByVal amount As String _

, ByVal price_type As String _

, ByVal ordtype As String _

, ByVal octtype As String) As String

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 期貨分公司代號

account : 期貨帳戶

future_id : 商品代號

price : 價格6位數

amount : 口數3位數

price type : "MKT"市價, "LMT" 限價

ordtype: ROD / FOK / IOC

octtype: 倉別"0" = 新倉 "1" = 平倉" "= 自動 "6"= 當沖

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

future_cancel

函式功能：

國內期貨刪單

VC 宣告：

BSTR future_cancel( char*branch

, char*account

, char*future_id

, char*ord_seq

, char*ord_no

, char*octtype

, char*pre_order );

VBA 宣告：

Private Declare Function future_cancel Lib "C:vba dllt4.dll" _

( ByVal account As String _

, ByVal future_id As String _

, ByVal ord_seq As String _

, ByVal ord_num As String _

, ByVal octtype As String _

, ByVal pre_order As String) As String

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

future_id : 商品代號

ord_seq : 網路單號

ord_no : 委託單號

octtype : "0" 新倉, "1" 平倉, " " 自動"6"= 當沖

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

future_chance

函式功能：

國內期貨改價

VC 宣告：

BSTR future_change ( char*org_seqno

, char*org_ordno

, char*branch

, char*account

, char*commodity

, char*new_price

, char*pre_order );

VBA 宣告：

Private Declare Function future_change Lib "C:vba dllt4.dll" _

(ByVal org_seqno As String _

, ByVal org_ordno As String _

, ByVal branch As String _

, ByVal account As String _

, ByVal commodity As String _

, ByVal new_price As String _

, ByVal pre_order As String) As String

傳入參數：

org_seqno : 原流水書號

org_ordno : 原委託單號

branch : 期貨分公司代號

account : 期貨帳戶

commodity : 期貨商品代號

new_price : 新價格

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

option_order

函式功能：

國內選擇權下單

VC 宣告：

BSTR option_order( char*buy_or_sell

, char*branch

, char*account

, char*option_id

, char*price

, char*amount

, char*price_type

, char*ordtype

, char*octtype

, char*isComp

, char*bs3

, char*commodity2 );

VBA 宣告：

Private Declare Function option_order Lib "C:vba dllt4.dll" _

(ByVal buy_or_sell As String _

, ByVal branch As String _

, ByVal account As String _

, ByVal option_id As String _

, ByVal price As String _

, ByVal amount As String _

, ByVal price_type As String _

, ByVal ordtype As String _

, ByVal octtype As String _

, ByVal IsComp As String _

, ByVal bs2 As String _

, ByVal commodity2 As String) As String

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 期貨分公司代號

account : 期貨帳戶

option_id : 選擇權商品代號

price : 價格6位數

amount : 口數3位數

price type : "MKT"市價, "LMT" 限價

ordtype: ROD / FOK / IOC

octtype: 倉別"0" = 新倉 "1" = 平倉" "= 自動 "6"= 當沖

IsComp : "S" 單式, "C" 複式

bs2 : 第二商品買/ 賣(如單式則填”“)

commodity2 : 第二商品代號(如單式則填”“)

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

option_cancel

函式功能：

國內選擇權刪單

VC 宣告：

BSTR option_cancel( char*branch

, char*account

, char*option_id

, char*ord_seq

, char*ord_no

, char*octtype

, char*pre_order );

VBA 宣告：

Private Declare Function option_cancel Lib “C:vba dllt4.dll" _

(ByVal branch As String _

, ByVal account As String _

, ByVal code As String _

, ByVal ord_seq As String _

, ByVal ord_num As String _

, ByVal octtype As String _

, ByVal pre_order As String) As String

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

code : 商品代號

ord_seq : 網路單號

ord_num : 委託單號

octtype : "0" 新倉, "1" 平倉, " " 自動

pre_order : "N" - 非預約單, " " - 預約單

使用範例：

回傳值：

異常：TR Error[錯誤編號] = 伺服器錯誤訊息

正常：參考附件(十)

函式名稱：

ffuture_order

函式功能：

國外期貨下單

VBA宣告：

Private Declare Function ffuture_order Lib "C:vba dllt4.dll"

(ByVal buy_or_sell As String _

, ByVal branch As String _

, ByVal account As String _

, ByVal code As String _

, ByVal price1 As String _

, ByVal price2 As String _

, ByVal price3 As String _

, ByVal amount As String _

, ByVal price_type As String _

, ByVal pre_order As String _

, ByVal trade_place As String _

, ByVal dtrade As String _

, ByVal source As String) As String

傳入參數：

buy_or_sell : "B" = 買, "S" = 賣

branch : 期貨分公司代號

account : 期貨帳戶

code : 商品代號

price : 價格8位數

price2: 價格(分子)

price3: 價格(分母)

amount : 口數3位數

price type : "MKT"市價, "LMT"限價

ordtype: ROD / FOK / IOC

octtype: 倉別"0" = 新倉"1" = 平倉" "= 自動

pre_order : "N" - 非預約單, " " - 預約單

trade_place : 交易所, length(8)

dtrade : 當沖碼, length(1), "Y/N"

source : 來源別, length(1), "E"

註: 以分子分母標示價格的商品(e.g. US公債) 才需使用price2 & price3. 其餘商品代入”0”即可

使用範例：

回傳值：

附件(十四)

函式名稱：

ffuture_cancel

函式功能：

國外期貨刪單

VC 宣告：

BSTR ffuture_cancel( char*buy_or_sell

, char*branch

, char*account

, char*code

, char*ord_seq

, char*ord_num

, char*type_1

, char*pre_order

, char*trade_place

, char*dtrade

, char*source );

VBA 宣告：

Private Declare Function ffuture_cancel Lib "C:vba dllt4.dll"

(ByVal buy_or_sell As String _

, ByVal branch As String _

, ByVal account As String _

, ByVal code As String _

, ByVal ord_seq As String _

, ByVal ord_num As String _

, ByVal type_1 As String _

, ByVal pre_order As String _

, ByVal trade_place As String _

, ByVal dtrade As String _

, ByVal source As String) As String

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

code : 商品代號

ord_seq : 網路單號

ord_num : 委託單號

type_1 : "0" 新倉, "1" 平倉, " " 自動

pre_order : "N" - 非預約單, " " - 預約單

trade_place : 交易所, length(3) e.g "SMX"

dtrade : 當沖碼, length(1), "Y/N"

source : 來源別, length(1), e.g."E"

使用範例：

回傳值：

附件(十四)

函式名稱：

get_response

函式功能：

國內商品回報查詢

可查詢國內證券、國內期權回報資料(同e-leader 畫面8891)

VC 宣告：

BSTR get_response_log();

VBA 宣告：

Private Declare Function get_response_log Lib "C:vba dllt4.dll" ( ) As String

傳入參數：

無

使用範例：

回傳值：

附件(一)

函式名稱：

fo_unsettled_qry

函式功能：

國內期權未平倉查詢(同e-Leader 畫面7201)

VC 宣告：

BSTR fo_unsettled_qry( char*flag

, char*leng

, char*next

, char*prev

, char*gubn

, char*group_name

, char*branch

, char*account

, char*type_1

, char*type_2

, char*time_out );

VBA 宣告：

Private Declare Function fo_unsettled_qry Lib "C:vba dllt4.dll"

(ByVal flag As String _

, ByVal leng As String _

, ByVal next As String _

, ByVal prev As String _

, ByVal gubn As String _

, ByVal group_name As String _

, ByVal branch As String _

, ByVal acct As String _

, ByVal type_1 As String _

, ByVal type_2 As String _

, ByVal time_out As String) As String

傳入參數：

flag = "0000"

leng = "0004"

next = "0000"

prev = "0000"

gubn : 0:單一帳戶1:群組

group name : 群組名稱(單一帳號則填"")

branch : 期貨分公司代號

account : 期貨帳戶

type_1 : 0:所有, 1:期貨, 2:選擇權

type_2 : 0:明細, 1:彙整

time_out = "1"

使用範例：

回傳值：

附件(一)

函式名稱：

fo_order_qry

函式功能：

期權委託查詢(同e-Leader 畫面6207)

同fo_order_qry2, 僅預設參數source 為不分類，全部查詢

VC 宣告：

BSTR fo_order_qry( char*branch

, char*account

, char*code

, char*ord_match_flag

, char*ord_type

, char*oct_type

, char*daily

, char*start_date

, char*end_date

, char*preorder );

VBA 宣告：

Private Declare Function fo_order_qry Lib "C:vba dllt4.dll"

(ByVal branch As String _

, ByVal acct As String _

, ByVal code As String _

, ByVal ord_match_flag As String _

, ByVal ord_type As String _

, ByVal oct_type As String _

, ByVal daily As String _

, ByVal start_date As String _

, ByVal end_date As String _

, ByVal preorder As String) As String

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

code: 商品代號(欲查詢所有商品則填““)

ord_match_flag : 成交類別0:全部明細1:未成交3:委託失敗5:委託彙總

ord_type : 商品類別0:全部商品1:期貨2:選擇權3:美元計價

oct_type: 倉別.定為"0"

daily: 0:當日1:歷史

start_date: 歷史查詢起始日

end_date: 歷史查詢終止日

preorder : ' ' = 僅查預約單, 'N' = 所有

使用範例：

回傳值：

函式名稱：

fo_order_qry2

函式功能：

期權委託查詢(同e-Leader 畫面6207)

VC 宣告：

BSTR fo_order_qry2( char*branch

, char*account

, char*code

, char*ord_match_flag

, char*ord_type

, char*oct_type

, char*daily

, char*start_date

, char*end_date

, char*preorder

, char*source );

VBA 宣告：

Private Declare Function fo_order_qry2 Lib "C:vba dllt4.dll"

(ByVal branch As String _

, ByVal acct As String _

, ByVal code As String _

, ByVal ord_match_flag As String _

, ByVal ord_type As String _

, ByVal oct_type As String _

, ByVal daily As String _

, ByVal start_date As String _

, ByVal end_date As String _

, ByVal preorder As String _

, ByVal source As String) As String

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

code: 商品代號(欲查詢所有商品則填““)

ord_match_flag : 成交類別0:全部明細1:未成交3:委託失敗5:委託彙總

ord_type : 商品類別0:全部商品1:期貨2:選擇權3:美元計價

oct_type: 倉別.定為"0"

daily: 0:當日1:歷史

start_date: 歷史查詢起始日

end_date: 歷史查詢終止日

preorder : ' ' = 含預約單, 'N' = 不含預約單

source : 來源, 1=e-Leader, 2=API, 3=e-Leader + API, 其他數值則傳回全部

使用範例：

回傳值：

函式名稱：

stock_balance_qry

函式功能：

國內證券庫存查詢

VC 宣告：

BSTR stock_balance_qry( char*flag

, char*leng

, char*next

, char*prev

, char*gubn

, char*group_name

, char*branch

, char*account

, char*time_out );

VBA 宣告：

Private Declare Function stock_balance_qry Lib "C:vba dllt4.dll"

(ByVal flag As String _

, ByVal leng As String _

, ByVal next As String _

, ByVal prev As String _

, ByVal gubn As String _

, ByVal group_name As String _

, ByVal branch As String _

, ByVal acct As String _

, ByVal time_out As String) As String

傳入參數：

flag = "0000"

leng = "0004"

next = "0000"

prev = "0000"

gubn : 0:單一帳戶1:群組

group name : 群組名稱(單一帳戶則填"")

branch : 證券分公司代號

account : 證券帳戶

time_out = "1"

使用範例：

回傳值：

函式名稱：

stock_balance_sum

函式功能：

國內證券未實現損益匯總查詢

VC 宣告：

BSTR stock_balance_qry( char*branch

, char*account

, char*type

, char*action );

VBA 宣告：

Private Declare Function stock_balance_sum Lib "C:vba dllt4.dll"

(ByVal branch As String _

, ByVal acct As String _

, ByVal ttype As String _

, ByVal action As String ) As String

傳入參數：

branch : 證券分公司代號

account : 證券帳戶

ttype : 庫存類別"A" 全部, "0" 現貨, "1" 資, "2" 券

action : 過濾別" " 不濾, "1" 濾下市商品, "2" 不含稅費, "3" 濾下市+不含稅費

使用範例：

stock_balance_sum( "9A95", "9809975", "A", " " )

回傳值：

異常一，API錯誤：API 錯誤訊息

異常二，損益中心錯誤訊息：錯誤代碼,錯誤訊息

正常狀況：附件(十五)

函式名稱：

stock_balance_detail

函式功能：

國內證券未實現損益個股明細

VC 宣告：

BSTR stock_balance_detail ( char*branch

, char*account

, char*stock

, char*ttype );

VBA 宣告：

Private Declare Function stock_balance_detail Lib "C:vba dllt4.dll"

( ByVal branch As String _

, ByVal acct As String _

, ByVal stock As String _

, ByVal ttype As String ) As String

傳入參數：

branch : 證券分公司代號

account : 證券帳戶

stock : 股票代碼(例如："2890", 不可帶空白)

ttype : 庫存類別"A" 全部, "0" 現貨, "1" 資, "2" 券

使用範例：

stock_balance_detail( "9A95", "9809975", "2890", "A" );

回傳值：

異常一，API錯誤：API 錯誤訊息

異常二，損益中心錯誤訊息：錯誤代碼,錯誤訊息

正常狀況：附件(十六)

函式名稱：

ff_get_response

函式功能：

國外商品回報查詢(同e-Leader 畫面8002)

VC 宣告：

BSTR ff_get_response();

VBA 宣告：

Private Declare Function ff_get_response Lib "C:vba dllt4.dll" () As String

傳入參數：

使用範例：

回傳值：

參考附件(二)

函式名稱：

ff_get_info

函式功能：

國外期貨權益數查詢(同e-Leader 畫面8003)

VC 宣告：

BSTR ff_get_info( char*branch, char*account );

VBA 宣告：

Private Declare Function ff_get_info Lib "C:vba dllt4.dll"

(ByVal branch As String, ByVal account As String) As String

傳入參數：

branch : 期貨分公司代號

account : 期貨帳戶

使用範例：

回傳值：

參考附件(十三)

函式名稱：

ff_get_positions