服務條款

因應台灣金融法規的要求,新用戶在首次使用服務時,必須先簽署相關文件,方可進入正式環境使用:

API登入申請

API風險預告書簽署

申請API程式驗證

若有功能測試需求,可以與相關單位申請測試帳號,於模擬環境進行測試,並遵循以下注意事項:

測試環境注意事項
  • 服務時間
    • 為回應凱基證券資訊安全規定,測試服務時間為營業日08:30~隔日05:00
    • 只允許台灣IP
  • 版本限制
    • 版本:限制為3.09~3.13
      安裝指令:python -m pip install kgisuperpy
  • 電腦設備需求

    Python API Python 執行環境安裝 64位元版本之 Python

    【Windows環境】
    64位元Windows 10或以上版本

    【Linux環境】
    Red Hat 7與 Ubuntu 20以上作業系統

  • 作業系統 Red Hat 7 Ubuntu 20
    GNU C gcc 4.8.x gcc 9.x
    GNU libc ldd 2.17 ldd 2.3x
  • 其他
    • 測試前請先簽署API相關文件。
    • 股票、期貨帳戶應分開測試。
    • 股票、期貨下單測試的時間間隔應大於1秒。

版本檢查

請注意python版本限制為3.09~3.13

使用方法

import kgisuperpy as kgi
import pandas as pd
import numpy as np

申請並啟用CA憑證

下單前,您必須申請並啟用CA憑證且憑證有效

登入環境

設定simulation = False連線至正式環境

使用方法

person_id = '用戶身分證字號'
person_pwd = '用戶帳號密碼'
simulation = False #連線至正式環境

api = kgi.login(person_id ,person_pwd,simulation)

設定證券交易帳戶

設定完證券交易帳戶啟用Order及Account功能

使用方法

api.set_Account('account')

證券下單測試

使用方法

api.Order.create_order(action =kgi.Action.Buy,
symbol= '2883',
qty= 1,
price= kgi.PriceType.MKT,
time_in_force= kgi.TimeInForce.ROD,
order_cond= kgi.OrderCond.CASH,
odd_lot = kgi.OddLot.Common
)