<Day18>什麽是K棒?如何用API取得历史K棒资料?

● 这章会示范如何取得历史K棒资料

什麽是K棒?

在了解什麽是"K棒"之前，我们得先了解什麽是"K线"?
相信大部分人，不管有没有接触过股市，多少一定都会在某个地方看过以下这种图

这种图我们称它为"线形图"
从这张图当中我们可以大致看出一张股票在各个时段的价位及走势
而上面这张是"永丰金"在10/1当日的线形图，参考资料

为了让我们更加方便地分析整个股市的走向及脉络，所以又有额外衍伸出了另一种图
我们称它为"K线图"，如以下这张图就是"永丰金"的"日K线图"，参考资料

"K线图"在股市里是作技术分析用的，用来记录股市某段期间的股价，主要分为日K线、周K线、月K线，分别记录每日、每周、每月的股价变动。而它是根据股价一天(或一个周期)的走势形成的四个价位所绘制而成的，这四个价位分别为开盘价、最高价、最低价、收盘价。而K线图相较於线型图来说，可以看出更多股票的资讯，所以也更有其参考的价值。

接下来就是要来谈论什麽是"K棒"了，"K线"其实就是由一支一支的"K棒"所组成，那因为K棒长得很像一根根的蜡烛，所以有时候K线图又被人称为蜡烛图(Candlestick Charts)，这根蜡烛本身就代表了开盘价和收盘价，而蜡烛的两端烛芯则代表最高价和最低价。

● 收盘价>开盘价：代表股价上涨，会以红色来表示，称为红K线、阳线。
● 收盘价<开盘价：代表股价下跌，会以绿色来表示，称为黑K线、阴线。
● 收盘价=开盘价相同：称为十字线。
● 最高价、最低价，分别是细细的上影线及下影线。
想看更多有关於K棒的详细资讯请参考市场先生

如何用Shioaji API取得历史K棒资料?

这里我们一样以"永丰金"为例，代码为「2890」
我们来试着取得它在 9/27 ~ 10/1 一个礼拜的K棒资料
以下为其程序码

kbars = api.kbars(
    api.Contracts.Stocks["2890"],  #先用Contract传入要抓取的股票资料
    start="2021-09-27", #起始日期
    end="2021-10-01"  #结束日期
)

记得一样要先将它转为DataFrame形式，比较方便我们浏览，请参考Day13
转换为DataFrame後的显示画面如下

由左到右行英文名词解释如下

• ts: 交易时间
• Volume: 成交量
• Amount: 成交总金额
• Close: 收盘价
• Low: 最低价
• High: 最高价
• Open: 开盘价

左下角的「1306 rows」代表有着1306笔的Kbars资料