Preparation

caution

Before starting with the Fubon Neo API, you must complete the following steps:"

1. Have your Fubon Future account ready. (If you don't already have a Fubon Future account, please click the link.Open Account
2. Sign API agreements
3. Apply digital certification

Prepare

Use your Fubon Future account

Sign API agreements

Using Cell Phone 富邦e點通 APP or using desktop E+

Signing Process Completed

Congratulations 🎉 you have successfully signed the agreements.

Apply the Digital Certificate

Go to the apply certificate page and download the CATool.

After logging in and completing the authentication, enter your mobile number or email to receive OTP code and complete the OTP verification.

After completing the application, the certificate by default will be stored in the folder C:\CAFubon\(Your ID Number). The certificate filename is (Your ID Number).pfx.

Install SDK package

Python

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

Support Python version 3.7 (~v1.3.2)、3.8、3.9、3.10、3.11 and 3.12 (v2.0.1~)

Node.js

First, create a folder named 'project' and initialize it using the following command:

npm init

The file downloaded from the official website will be named fubon-neo-<version>.tgz, and place it in the folder you just created

Add a line to the package.json file inside the Node.js project.

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

Then enter the following command in the command line

npm install

Node.js version 16 and above are supported

C#

the downloaded file name should look like this FubonNeo.<version>.nupkg

for Visual Studio user, please refer to below tutorial.

• Method 1 : Visual Studio Nuget Package Manager( Using .NET 7 as an example ) :

  After placing the package under the newly added project, click Tools -> Nuget Package Manager -> Nuget Package Settings

  

  After popup window，

  1. Click on the upper-right corner +
  2. Click on the bottom ... select the location to store the package
  3. Rename package
  4. Click Update
  5. Click OK

  Click Tools -> Nuget Package Manager -> Manage Nuget Packages for Solution

  

  Next, select

  1. Package source, select the package name you named in the previous step
  2. Click Browse
  3. Click Package
  4. Select Project
  5. Install Package

  

  Finish ! You can using Fubon Neo SDK。

---

• Method 2 : Visual Studio Nuget Package Manager( Using .NETFrame 4.7.2 as an example ) : After placing the package under the newly added project, click Tools -> Nuget Package Manager -> Nuget Package Settings

  

  After popup window，

  1. Click on the upper-right corner +
  2. Click on the bottom ... select the location to store the package
  3. Rename package
  4. Click Update
  5. Click OK

  Click On the right-hand side in Solution ExplorerSwitch between solutions and available views ( Or you can open it by going to the 'View' menu at the top) ， After opening the folder, locate the .csproj file

  

  Inside the .csproj file, add an SDK reference (fill in the version according to the version number).

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

  Click on the .sln file in File Explorer, right-click on the project name, and select Reload Project

  

  caution

  The current package only supports 64-bit. If your development environment is set to 32-bit by default, you can adjust it following the steps below:

  1. Click on the top menu Project
  2. Select Project Properties
  3. Click on 'Build' on the left side, and change the platform target to x64

  

---

• If you're not using Visual Studio NuGet Package Manager, you can use the Command Line as follows:

  You can add a new nuget.config file under the project folder:

  cd /Your Project path/
  cd .>nuget.config   #Create nuget.config

  And copy and paste below content in the 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>

  and then add sdk reference in the .csproj file (Vsesion base on downloaded package)

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

  and then restore the project in the command line

  dotnet restore

C# develop .NET Standard 2.0 for the base ， Suggest using .netcoreapp 3.1 and above； If using .NETFramework，suggest using .NETFramework 4.7.2 and above.

Start Your Program Trading Journey

Python

from fubon_neo.sdk import FubonSDK, Order
from fubon_neo.constant import TimeInForce, FutOptOrderType, FutOptPriceType, FutOptMarketType, CallPut, BSAction

# Connect and login
sdk = FubonSDK()

accounts = sdk.login("Your ID", "Your Password", "Your cert path" , "Your cert password")
## accounts = sdk.login("Your ID", "Your Password", "Your cert path")  # If you use the ＂default＂ password for your certificate, for SDK v1.3.2 and newer versions

acc  = accounts.data[0]

# Create order object
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
)

# Place an order
order_res = sdk.futopt.place_order(acc, order)
print(order_res)

Congratulations 🎊 after placing your order, you will be able to see the system's response.

Result {  is_success: True, message: None, data : { 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');

// Connect and login
const sdk = new FubonSDK();

const accounts = sdk.login("Your ID", "Your Password", "Your cert path" , "Your cert password");
// const accounts = sdk.login("Your ID", "Your Password", "Your cert path");  // If you use the ＂default＂ password for your certificate, for SDK v1.3.2 and newer versions

const acc = accounts.data[0];

// Create order object
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"
};

// Place an order
sdk.futopt.placeOrder(acc,order);

Congratulations 🎊 after placing your order, you will be able to see the system's response.

{ 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;

// Connect and login
var sdk = new FubonSDK();

var acc_obj = sdk.Login("Your ID", "Your Password", "Your cert path" , "Your cert password");
/*
// If you use the ＂default＂ password for your certificate, for SDK v1.3.2 and newer versions
var acc_obj = sdk.Login("Your ID", "Your Password", "Your cert path");
*/

var acc = acc_obj.data[0];

// Create order object
var order = new FutOptOrder(
  BsAction.Buy,
  "TXFD4",
  "20800",
  3,
  FutOptMarketType.Future,
  FutOptPriceType.Limit,
  TimeInForce.Rod,
  FutOptOrderType.Auto,
  "From C#"
);

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

Congratulations 🎊 after placing your order, you will be able to see the system's response.

{   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 =  } }