Quick Start

Key points

• This page provides Fubon Neo API login and order examples.
• Complete Preparation first (account opening, certificate, agreement, and connection test).
• See Installation and Version Compatibility for installation instructions and version compatibility.

Item	Details
Prerequisites	Preparation completed
Languages	Python / C# / JavaScript (Node.js) / C++ and Go (C++ and Go support securities trading, account information, and conditional orders only)
Download source	SDK Download page
Installation	See Installation and Version Compatibility
Next step	Complete the login and order example for your language

Complete the risk disclosure and certificate download in Preparation before you begin.

Installation and Version Compatibility

For installation steps and minimum version requirements, see Installation and Version Compatibility. Download SDKs from the SDK Download page.

Install Package

Python

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

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

And you should place the certificate in your folder structure like this:

.
└── XXXXXXXXXX.pfx

Python

f you have never used the SDK for logging in or if you have changed your SDK execution environment, please create an index.py file in your folder and paste the following content into it, then execute it:：

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

sdk = FubonSDK()
   
accounts = sdk.login("Your ID", "Your Password", "Your cert path" , "Your cert password") #If there are account groupings, multiple account information will be returned
## 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]

Node.js

If you have never used the SDK for logging in or if you have changed your SDK execution environment, please create an index.js file in your folder and paste the following content into it, then execute it:：

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

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

C#

If you have never used the SDK for logging in or if you have changed your SDK execution environment, please create an index.cs file in your folder and paste the following content into it, then execute it:：

using FubonNeo.Sdk;

var sdk = new FubonSDK();

var accounts = sdk.Login("Your ID", "Your Password", "Your cert path" , "Your cert password"); // If there are account groupings, multiple account information will be returned
/*
// 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 = accounts.data[0];

Send Order

Next, add the following example code to demonstrate how to use the Fubon API to place a limit order to buy 1 board lot of Fubon Financial Holding Co., Ltd. (2881) at the fall stop price.

Python

order = Order(
    buy_sell = BSAction.Buy,
    symbol = "2881",
    price = None,
    quamtity =  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: 2881,
  price: "66",
  quantity: 2000,
  marketType: MarketType.Common,
  priceType: PriceType.LimitDown,
  timeInForce: TimeInForce.ROD,
  orderType: OrderType.Stock,
  userDef: "from Js"
};
//
sdk.stock.placeOrder(acc, order);

C#

var order = new Order(
    BsAction.Buy,
    "2881",
    "66",
    2000,
    MarketType.Common,
    PriceType.LimitDown,
    TimeInForce.Rod,
    OrderType.Stock,
    null
);

sdk.Stock.PlaceOrder(acc ,order);