Shioaji API 简介

Shioaji API 是由永丰金证券所开发的API，只要你有永丰金的证券户，都可以用电子交易的帐号及密码登入；若完成「API 证券下单签署」或「API 期货下单签署」後，也可透过API进行下单。
相关资源网站如下
Shioaji API官网：https://www.sinotrade.com.tw/ec/20191125/Main/index.aspx
Shioaji API GitHub：https://github.com/Sinotrade/Shioaji
Shioaji 讨论区：https://sjapi.tw/index.php
永丰金证券 交易 API - Shioaji FB社群：https://www.facebook.com/groups/2267820226830423/

Shioaji API 有 Python 及 C# 两种版本，比起C#我比较常使用Python，而且Python有很多现成的套件可以直接使用，省下许多开发上的时间；所以这此次的铁人赛会以Python版本，来说明Shioaji API有哪些功能可使用

Day 01 重点说明

• 下载及安装Python
• 下载及安装VS Code
• pipenv虚拟环境设定及相关套件安装

虽然目前Python3的最新版本是3.9版，但Shioaji API仅支援Python 3.6~3.8的版本；而在Windows环境中使用官方的安装档，只有3.6及3.7版可以正常执行Shioaji，若要使用Python 3.8，请安装Anaconda，若是在Linux环境底下则无此问题。
Anaconda：https://www.anaconda.com/products/individual-d

我个人比较偏好的开发环境为 Windows + VS Code + 官方版本Python，并手动安装套件。若你是以Anaconda，可以略过安装Python及VS Code这两个步骤。

下载及安装Python

首先下载Python。目前Python 3.7版，官网只提供3.7.9版的安装档，下载网址如下
https://www.python.org/ftp/python/3.7.9/
开启下载网址後，请下载「python-3.7.9-amd64.exe」这个安装档

下载完成後，执行安装档。执行後，请先勾选「Add Python 3.7 to PATH」这个选项，再按「Install Now」；如果你想变更所要安装的内容或路径，请点「Customize installation」。

安装完成後，按「Close」按钮关闭安装视窗。

接着按下windows的搜寻按钮，输入「cmd」後开启「命令提示字元」(console)。

在命令提示字元(console)中输入「python」，按下Enter键後，若有成功进到interactive mode(如下图)，表示Python已安装成功并有加到系统变数PATH中。

下载及安装 VS Code

VS Code 官网：https://code.visualstudio.com/
打开VS Code官网後，请点「Download for Windows」进行下载。下载完成後，请执行所下载的安装档。

如果你的使用者帐号跟我一样是系统管理员，在执行安装档时会看到这个确认视窗。这个讯息只是要确认你是否要使用User Installer的版本进行安装，你可以直接按「确定」进行安装，或是下载System Installer版本进行安装。

接着，选择「我同意」并按「下一步」。

如果你要变更安装的路径，可以按「浏览」选择你所要安装的路径，确认後按「下一步」。

预设下，安装後会在功能表资料夹中新增一个「Visual Studio Code」的资料夹，若你不想新增，可勾选「不要在「开始」功能表中建立资料夹」。确定後按「下一步」。

接着，会询问你安装完成後，是否要自动执行以下的附加工作。在这里，我是有勾选「建立桌面图示」这个选项，在安装完成後，就会自动在桌面上建立VS Code的捷径。确认後按「下一步」。

确认相关设定後，按「安装」。

安装完成後，按「完成」按钮。

预设情况下，安装完功後会自动启动VS Code，若没有请自行启动VS Code。第一次执行时，会出现这个确认视窗，请按「Yes, I trust the authors」。

接着，VS Code会提示是否要安装繁体的语件套件，请按「安装并重新启动(Install and Restart)」。

重新启动後，就可看到VS Code的介面已变成熟悉的繁体中文。接着，先按「档案>新增档案」。

在右边的编辑区中输入「print('hello world')」後，按「档案>储存」。

档案名称请自行输入，在「存档类型」中选择「Python」并确认所储存的副档名为「.py」後按「存档」。

接着，VS Code就会侦测到你是要使用Python进行开发，并在右下角会跳出是否要安装建议的延伸模组，请按「安装」。

安装完成後，一样在右下角会提示你要选择「Python Interpreter」，请按「Select Python Interpreter」。

接着VS Code会侦测到系统中目前有安装的Python Interpreter，请直接选择即可。

选择完後，VS Code会询问是否要安装Pylance，请按「OK」进行安装。

安装完後，可以按右上角的执行按钮，执行刚才所建立python程序档。

执行後，可以看到下方的终端机中，会有出现「hello world」，这样就表示VS Code设定完成了。

安装pipenv及相关套件

因为Python可用来开发各种类型的程序，在这里我选择使用pipenv来建立些拟环境并管理开发环境中的套件。首先，在终端机中输入「pip install pipenv」并按下Enter键，安装pipenv套件。若在执行pip install时出现问题，可以改为输入「pip --user install pipenv」并按下Enter键进行安装。

接着，建立一个开发环境的资料夹。我在这里是建立一个「shioaji」的资料夹，并在终端机中输入「cd shoiaji」进到资料夹中，并且输入「pipenv --three」建立虚拟环境。

出现下列讯息，就表示虚拟环境已建立完成。

接着输入「pipenv shell」来启动虚拟环境。

若终端机的最前面有出现类似下图中的文字，表示已启动虚拟环境。

接着，分别输入「pip install shioaji」及「pip install pandas」，安装shioaji及pandas这两个套件。

安装完後，在终端机中输入「Python」进到python interactive mode，接着分别输入以下程序码

import pandas as pd
import shioaji as sj
exit()

若出现下图这样，没有出现其它错误讯息，表示套件已安装成功并可使用。

以上即为开发环境的安装，下一篇将会正式说明Shioaji API。