Historical Candles

取得 1 年內的上市櫃歷史股價（依代碼查詢），個股資料區間最遠可回溯至 2010 年，指數部分最遠可回溯至 2015 年！

historical/candles/{symbol}

Parameters

Name	Type	Description
symbol*	string	股票代碼
from	string	開始日期（格式：yyyy-MM-dd）
to	string	結束日期（格式：yyyy-MM-dd）
timeframe	string	Ｋ線週期，可選 1 1 分Ｋ；5 5 分Ｋ；10 10 分Ｋ；15 15 分Ｋ；30 30 分Ｋ；60 60 分Ｋ；D 日Ｋ；W 週Ｋ；M 月Ｋ
fields	string	欄位，可選：open,high,low,close,volume,turnover,change

caution

目前分Ｋ無法指定開始日期（from） 與 結束日期（to），一律回傳近五日資料，並且無法選擇 turnover 與 change 的欄位。

Response

Name	Type	Description
date*	string	日期
type*	string	證券類型
exchange*	string	交易所
market*	string	市場別
symbol*	string	股票代號
timeframe*	string	Ｋ線週期
data*	object[]	Ｋ線資料
data[i].date*	string	日期（分 K 含時間）
data[i].open	number	Ｋ線開盤價
data[i].high	number	Ｋ線最高價
data[i].low	number	Ｋ線最低價
data[i].close	number	Ｋ線收盤價
data[i].volume	number	Ｋ線成交量（股）
data[i].turnover	number	Ｋ線成交金額（元）
data[i].change	number	Ｋ線漲跌

Example

Python

from configparser import ConfigParser
from esun_marketdata import EsunMarketdata

config = ConfigParser()
config.read('/path/to/config.ini')
sdk = EsunMarketdata(config)

sdk.login()

rest_stock = sdk.rest_client.stock
print(rest_stock.historical.candles(**{"symbol": "0050", "from": "2023-02-06", "to": "2023-02-08"}))

Node.js

const { EsunMarketdata } = require("@esun/marketdata");

(async () => {
  const sdk = new EsunMarketdata({
    configPath: "/path/to/config.ini",
  });
  await sdk.login();

  const stock = sdk.restClient.stock;

  const data = await stock.historical.candles({
    symbol: "0050",
    from: "2023-02-06",
    to: "2023-02-08",
    fields: "open,high,low,close,volume,change",
  });

  console.log(data);
})();

Response Body：

{
  "symbol": "0050",
  "type": "EQUITY",
  "exchange": "TWSE",
  "market": "TSE",
  "data": [
    {
      "date": "2023-02-08",
      "open": 120.1,
      "high": 120.95,
      "low": 120,
      "close": 120.85,
      "volume": 9239321,
      "change": 1.85
    },
    {
      "date": "2023-02-07",
      "open": 119.1,
      "high": 119.25,
      "low": 118.55,
      "close": 119,
      "volume": 8787291,
      "change": -0.25
    },
    {
      "date": "2023-02-06",
      "open": 120.1,
      "high": 120.1,
      "low": 119.25,
      "close": 119.25,
      "volume": 14297030,
      "change": -1.75
    }
  ]
}