事前準備

caution

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

1. 準備好您的富邦證券帳戶 (若您還未擁有富邦證券帳戶，請點連結【線上開戶】)
2. 申請憑證
3. API風險使用聲明書簽署【線上簽署SOP】+ API連線測試【連線測試小幫手】 (Windows)

準備好富邦證券帳戶

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

申請憑證

至憑證申請、展期點選立即執行下載富邦證券憑證e總管(TCEM.exe)申請憑證

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

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

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

線上簽署

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

連線測試

下載使用連線測試程式 (for Windows), 或直接使用新一代API進行連線登入 連線測試小幫手

安裝套件

至新一代API SDK下載頁面下載相關套件

Python

依以下指令安裝（請注意修改為實際下載之檔案名稱）

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

目前支援 3.7 (~v1.3.2)、3.8、3.9、3.10、3.11 與 3.12 (v2.0.1~)。

Node.js

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

npm init

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

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

"dependencies": {
  ...
  "fubon-neo": "file://<path-to-js-binary>/fubon-neo-<version>.tgz",
  ...
}

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

npm install

目前支援 Node.js 16 以上版本。

C#

官網下載回來的檔案會像是 FubonNeo.<version>.nupkg

• 使用方法一 : Visual Studio Nuget 套件管理員安裝( 以.NET 7為例 ) :

  將套件放置在新增的專案下方後，點擊 工具 -> Nuget套件管理員 -> 套件管理員設定

  

  跳出視窗後，

  1. 點擊右上角的 +
  2. 點擊下方的 ... 選取套件存放位置
  3. 將名稱更名
  4. 點擊 更新
  5. 按下確定

  點擊工具 -> Nuget套件管理員 -> 管理方案的Nuget套件

  

  接者選取

  1. 套件來源，選取前一個步驟命名的套件名稱
  2. 點選瀏覽
  3. 點擊套件
  4. 選取專案
  5. 安裝版本

  

  安裝完成! 即可使用新一代SDK。

---

• 使用方法二 : Visual Studio Nuget 套件管理員安裝( 以.NETFramework 4.7.2為例) :
  將套件放置在新增的專案下方後，點擊 工具 -> Nuget套件管理員 -> 套件管理員設定

  

  跳出視窗後，

  1. 點擊右上角的 +
  2. 點擊下方的 ... 選取套件存放位置
  3. 將名稱更名
  4. 點擊 更新
  5. 按下確定

  點擊右方方案總管中在解決方案與可用檢視之間切換 (若找不到方案總管，可至上方檢視中開啟) ， 開啟資料夾後，找到.csproj檔案

  

  csproj 檔案裡面增加 sdk 的 reference (Version 內容再依版號填入)

  
  <ItemGroup>
    ...
    <PackageReference Include="FubonNeo" Version="1.0.0" />  
    ...
  </ItemGroup>
  ...

  點擊檔案總管中的 .sln， 於專案名稱中點選右鍵，重新載入專案

  

  caution

  目前套件僅支援 64 Bit，若您的開發環境預設為32 Bit，可照下方步驟調整

  1. 點擊上方專案
  2. 選取專案屬性
  3. 點選左方建置，將平台目標改為x64

  

---

• 若不使用 Visual Studio Nuget套件管理員，可使用 Command Line如下

  在 project 資料夾下面新增 nuget.config 檔案：

  cd /您的資料夾路徑/
  cd .>nuget.config   #新增nuget.config

  並將下列內容貼至nuget.config

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
      <packageSources>
          <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
          <add key="local" value="./" />
      </packageSources>
      <config>
          <add key="repositoryPath" value="./" />
      </config>
      <packageSourceMapping>
          <!-- key value for <packageSource> should match key values from <packageSources> element -->
          <packageSource key="nuget.org">
              <package pattern="*" />
          </packageSource>
          <packageSource key="local">
              <package pattern="FubonNeo*" />
          </packageSource>
      </packageSourceMapping>
  </configuration>

  接著在 project 的 csproj 檔案裡面增加 sdk 的 reference (Version 內容再依版號填入)

    ...
    <ItemGroup>
      <PackageReference Include="FubonNeo" Version="1.0.0" />   
    </ItemGroup>
    ...

  接著

  dotnet restore

C# 使用.NET Standard 2.0開發，建議您使用 .netcoreapp 3.1 以上；如使用.NETFramework 建議您使用.NETFramework 4.7.2以上版本。

開始拓展程式交易之旅

Python

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 = "From_Py" # 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: "From_Py", last_time: "16:48:09.247", error_message: None} }

Node.js

const { FubonSDK, BSAction, TimeInForce, OrderType, PriceType, MarketType } = require('fubon-neo');

// 載入設定檔與登入
const sdk = new FubonSDK();

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

const acc = accounts.data[0];

// 建立委託物件
const order = {
buySell: BSAction.Buy,
symbol: 2881,
price: "66",
quantity: 2000,
marketType: MarketType.Common,
priceType: PriceType.Limit,
timeInForce: TimeInForce.ROD,
orderType: OrderType.Stock,
userDef: "from Js"
};

// 下單
sdk.stock.placeOrder(acc,order);

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

{ isSuccess: true,  data:{ date : '2023/10/13', seqNo : '00000000016', branchNo : '6460', account : '26', orderNo : 'bA627', assetType : 0, market : 'TAIEX', marketType : 'Common', stockNo : '2881', buySell : 'Buy', priceType : 'Limit', price : 66, quantity : 2000, timeInForce : 'ROD', orderType : 'Stock', isPreOrder : false, status : 10, afterPriceType : 'Limit', afterPrice : 66, unit : 1000, afterQty : 2000, filledQty : 0, filledMoney : 0, beforeQty : 0, beforePrice : 66, userDef : 'From JS', lastTime : '17:19:06.048' } }

C#

using FubonNeo.Sdk;

//載入設定檔與登入
var sdk = new FubonSDK();

var acc_obj = sdk.Login("您的身分證號", "您的登入密碼", "您的憑證路徑" ,"您的憑證密碼");
/*
// 若憑證選用＂預設密碼＂, SDK v1.3.2　與較新版本適用
var acc_obj = sdk.Login("您的身分證號", "您的登入密碼", "您的憑證路徑");
*/

var acc = acc_obj.data[0];

//建立委託物件
var order = new Order(
  BsAction.Buy,
  "2881",
  "66",
   2000,
  MarketType.Common,
  PriceType.Limit,
  TimeInForce.ROD,
  OrderType.DayTrade,
  "From C#"
);

// 下單
var order_res = sdk.Stock.PlaceOrder(acc, order);
Console.WriteLine(order_res);

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

{ isSuccess = True, message = , data = { date = 2023/10/13, seqNo = 00000000016, branchNo = 6460, account = 26, orderNo = bA627, assetType = 0, market = TAIEX, marketType = Common, stockNo = 2881, buySell = Buy, priceType = Limit , price = 66, quantity = 2000, timeInForce = ROD, orderType = DayTrade, isPreOrder = False, status = 10, afterPriceType = Limit, afterPrice = 66, unit = 1000, afterQty = 2000, filledQty = 0, filledMoney = 0, beforeQty = 0, beforePrice = 66, userDef = From C#, lastTime = 17:19:06.048, errorMessage =  } }