Skip to main content

事前準備

本頁重點
項目說明
產品富邦新一代 API（Fubon Neo API）
必要條件富邦證券帳戶、數位憑證、API 使用聲明 + 連線測試
支援平台Windows / macOS / Linux
登入方式憑證登入
下一步安裝與版本相容性 / 快速開始
caution

在開始富邦新一代 API 前，您必須完成以下步驟

  1. 準備好您的富邦證券帳戶 (若您還未擁有富邦證券帳戶，請點連結【線上開戶】)
  2. 申請憑證
  3. API 風險使用聲明書簽署【線上簽署SOP】+ API 連線測試（以 SDK 登入即可完成，Windows／macOS／Linux 皆可）

準備好富邦證券帳戶​

若您已有您的富邦證券帳戶請跳過此步驟，未擁有富邦證券帳戶請 立即開戶

富邦證券帳號

申請憑證​

憑證可用以下任一方式申請：

  • 網頁申請並匯出（Windows／macOS／Linux 皆可）：至 金鑰管理與憑證匯出 登入後申請網頁憑證並匯出（SDK v2.2.8 起支援）。macOS、Linux 使用者請使用此方式。
  • 憑證 e 總管（Windows）：至 憑證申請、展期 點選立即執行，下載富邦證券憑證 e 總管（TCEM.exe）申請憑證（步驟請展開下方說明）。
憑證 e 總管申請步驟（Windows）

Certificate apply

登入完成並且認證後，輸入手機或電子信箱收取 OTP 驗證

OTP

完成申請，憑證將存放於 C:\CAFubon\(您的身分證字號)，並以您的身份證字號為檔名

CertLocation

API 使用風險暨聲明書簽署及測試​

線上簽署​

依照下方說明連結分別進行 API 聲明書簽署、API 連線測試 線上簽署SOP說明書

線上簽署

連線測試​

直接使用新一代 API 完成一次登入即可（Windows／macOS／Linux 皆可）；Windows 使用者也可下載連線測試小幫手。 連線測試小幫手

連線測試小幫手

安裝與版本相容性​

請先閱讀 安裝與版本相容性 以確認各語言最低版本與安裝方式，並至 SDK 下載 取得安裝檔。

開始拓展程式交易之旅​

from fubon_neo.sdk import FubonSDK, Order
from fubon_neo.constant import TimeInForce, OrderType, PriceType, MarketType, BSAction

# 載入設定檔與登入
sdk = FubonSDK()

accounts = sdk.login("您的身分證號", "您的登入密碼", "您的憑證路徑位置", "您的憑證密碼")
## accounts = sdk.login("您的身分證號", "您的登入密碼", "您的憑證路徑位置")  # 若憑證選用＂預設密碼＂, SDK v1.3.2 與較新版本適用

acc  = accounts.data[0]

# 建立委託物件
order = Order(
  buy_sell = BSAction.Buy,
  symbol = "2881",
  quantity   = 2000,
  price = "66",
  market_type = MarketType.Common,
  price_type  = PriceType.Limit,
  time_in_force = TimeInForce.ROD,
  order_type = OrderType.Stock,
  user_def = "FromPy" # optional field
)

# 下單
order_res = sdk.stock.place_order(acc, order)
print(order_res)

恭喜您🎊，完成下單，即可看到系統回覆的結果

Result {  is_success: True,   message: None,  data : OrderResult{ date: "2023/10/13", seq_no: "00000000015", branch_no: "6460", account: "26", order_no: "bA626", asset_type: 0, market: "TAIEX", market_type: Common, stock_no: "2881", buy_sell: Buy, price_type: Limit, price: 66.0, quantity: 2000, time_in_force: ROD, order_type: Stock, is_pre_order: false, status: 10, after_price_type: Limit, after_price: 66.0, unit: 1000, after_qty: 2000, filled_qty: 0, filled_money: 0, before_qty: 0, before_price: 66.0, user_def: "FromPy", last_time: "16:48:09.247", error_message: None} }