事前準備

caution

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

1. 準備好您的富邦期貨帳戶 (若您還未擁有富邦期貨帳戶，請點連結線上開戶)
2. 簽署API風險使用聲明書
3. 申請憑證

準備好富邦期貨帳戶

使用您的富邦期貨帳戶

簽署API使用風險暨聲明書

請使用手機富邦e點通 或 使用電腦版 E+進行API線上簽署

完成簽署

恭喜您，已簽署完成使用風險暨聲明書

申請憑證

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

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

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

安裝套件

至官網下載相關套件

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, FutOptOrder
from fubon_neo.constant import TimeInForce, FutOptOrderType, FutOptPriceType, FutOptMarketType, CallPut, BSAction

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

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

acc  = accounts.data[0]

#建立委託物件
order = FutOptOrder(
  buy_sell = BSAction.Sell,
  symbol = "TXFD4",
  price = "20800",
  lot = 3,
  market_type = FutOptMarketType.Future,
  price_type = FutOptPriceType.Limit,
  time_in_force = TimeInForce.ROD,
  order_type = FutOptOrderType.Auto,
  user_def = "Python" # optional field
)

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

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

Result {  is_success: True,   message: None,  data : FutOptOrderResult{ function_type: 0, date :  "2023/10/13", seq_no :  "00000000016", branch_no :  "6460", account :  "26", order_no : "bA627", asset_type : 1, market : "TAIMEX", market_type : Future, symbol : "FITX", unit : 1 , currency : "TWD", expiry_date : "202404",  strike_price : , call_put : , buy_sell : Buy , price_type : Limit, price : 20800, lot : 3, time_in_force : ROD, order_type : Auto, is_pre_order : False, status : 10, after_price_type : Limit, afterPrice : 20800,  after_lot : 2000, filled_lot : 0, filled_money : 0, ... , user_def : "From Pyhton", last_time : "12:19:06.048", error_message :  } }

Node.js

const { FubonSDK, TimeInForce, FutOptOrderType, FutOptPriceType, FutOptMarketType, CallPut, BSAction } = 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: TXFD4,
price: "20800",
lot: 3,
marketType: FutOptMarketType.Future,
priceType: FutOptPriceType.Limit,
timeInForce: TimeInForce.ROD,
orderType: FutOptOrderType.Auto,
userDef: "from Js"
};

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

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

{ isSuccess: true,  data:{ functionType :  0, date :  '2023/10/13', seqNo :  '00000000016', branchNo :  '6460', account :  '26', orderNo :  'bA627', assetType :  1, market :  'TAIMEX', marketType :  Future, symbol :  'FITX', unit :  1 , currency :  'TWD', expiryDate :  '202404'  , buySell :  Buy , priceType :  Limit, price :  20800, lot :  3, timeInForce :  ROD, orderType :  Auto, isPreOrder :  False, status :  10, afterPriceType :  Limit, afterPrice :  20800,  afterLot :  3, filledLot :  0, filledMoney :  0, ... , userDef :  'From JS', lastTime :  '12:19:06.048', errorMessage :   } }

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 FutOptOrder(
  BsAction.Buy,
  "TXFD4",
  "20800",
  3,
  FutOptMarketType.Future,
  FutOptPriceType.Limit,
  TimeInForce.Rod,
  FutOptOrderType.Auto,
  "From C#"
);

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

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

{  isSuccess = True,  message = , data = FutOptOrderResult{functionType: 0, date = 2023/10/13, seqNo = 00000000016, branchNo = 6460, account = 26, orderNo = bA627, assetType = 1, market = TAIMEX, marketType = Future, symbol = FITX, unit = 1 , currency = TWD, expiryDate = 202404,  strikePrice = , callPut = , buySell = Buy , priceType = Limit, price = 20800, lot = 3, timeInForce = ROD, orderType = Auto, isPreOrder = False, status = 10, afterPriceType = Limit, afterPrice = 66,  afterLot = 2000, filledLot = 0, filledMoney = 0, ... , userDef = From C#, lastTime = 12:19:06.048, errorMessage =  } }