快速開始

請先參考 事前準備 完成風險預告書申請與憑證下載。

若您還未安裝 SDK 套件，可至 SDK 下載頁面 下載後，找到存放路徑，使用以下指令安裝：

套件安裝

Python

pip install taishinsdk-<version>-cp37-abi3-win_amd64.whl

Node.js

首先先建立一個 project 資料夾，並利用下列指令初始化

npm init

官網下載回來的檔案會像是 taishinsdk-<version>.tgz，並且把它放入剛剛建立的資料夾中

把 node.js project 裡面的 package.json 增加一行

"dependencies": {
  ...
  "taishin-sdk": "file://<path-to-js-binary>/taishinsdk-<version>.tgz",
  ...
}

然後到命令行輸入以下指令

npm install

並將憑證放置您的資料夾結構應該像是：

.
└── XXXXXXXXXX.pfx

Python

from taishin_sdk import TaishinSDK, Order, TimeInForce, OrderType, PriceType, MarketType, BSAction

sdk = TaishinSDK()
   
accounts = sdk.login("您的身分證字號", "您的登入密碼", "您的憑證位置", "您的憑證密碼") #若有開多個帳號，則會回傳多筆帳號資訊

acc = accounts[0]

Node.js

若您未曾使用 SDK 進行過登入，或更換了 SDK 執行環境，請在資料夾新增一個 index.js 檔案，貼上以下內容並執行：

const { TaishinSDK, BSAction, TimeInForce, OrderType, PriceType, MarketType } = require('taishin-sdk');

const sdk = new TaishinSDK();

const accounts = sdk.login("您的身分證字號", "您的登入密碼", "您的憑證路徑" ,"您的憑證密碼");

const acc = accounts[0];

送出委託，買入股票

再將以下範例程式碼補上， 將示範如何使用 Nova API 送出一張以跌停價買入 台新金(2887) 的限價委託：

Python

order = Order(
    buy_sell = BSAction.Buy,
    symbol = "2887",
    price = None,
    quantity = 2000,
    market_type = MarketType.Common,
    price_type = PriceType.LimitDown,
    time_in_force = TimeInForce.ROD,
    order_type = OrderType.Stock
)
sdk.stock.place_order(acc, order)

Node.js

const order = {
  buySell: BSAction.Buy,
  symbol: "2887",
  quantity: 2000,
  marketType: MarketType.Common,
  priceType: PriceType.LimitDown,
  timeInForce: TimeInForce.ROD,
  orderType: OrderType.Stock
};
//
sdk.stock.placeOrder(acc, order);