Candles

danger

提醒您，富果行情 v0.3 版本將於 2024/01/31 終止服務，為維護您的權益，請儘速轉換至 v1.0 版本！

提供台股上市櫃的歷史股價資料，包含開高低收量 (OHLCV) 等數據。歷史資料目前設計單次呼叫的資料區間以一年為限；資料區間最遠可回溯至 2010 年！

GET /marketdata/candles

curl -X GET "https://api.fugle.tw/marketdata/v0.3/candles?symbolId=2884&apiToken=demo&from=2022-02-07&to=2022-02-11" -H "accept: */*"

Example

request url

https://api.fugle.tw/marketdata/v0.3/candles?symbolId=2884&apiToken=demo&from=2022-02-07&to=2022-02-11&fields=open,high,low,close,volume,turnover,change

Parameters

Name	Type	Required	Description
symbolId	string	yes	個股識別代碼
apiToken	string	yes	personal api token
from	string	no	開始日期
to	string	no	結束日期
fields	string	no	回傳資料欄位，以逗號 , 分隔，可選欄位：open,high,low,close,volume,turnover,change。預設值：open,high,low,close,volume

response

{
  "symbol": "2884",
  "type": "EQUITY",
  "exchange": "TWSE",
  "market": "TSE",
  "data": [
    {
      "date": "2022-02-11",
      "open": 30.15,
      "high": 30.4,
      "low": 30,
      "close": 30.4,
      "volume": 19518221,
      "turnover": 589585617,
      "change": 0.1
    },
    {
      "date": "2022-02-10",
      "open": 30.35,
      "high": 30.4,
      "low": 30.1,
      "close": 30.3,
      "volume": 20317023,
      "turnover": 613901148,
      "change": -0.05
    },
    {
      "date": "2022-02-09",
      "open": 30.1,
      "high": 30.35,
      "low": 30.05,
      "close": 30.35,
      "volume": 30832541,
      "turnover": 932679186,
      "change": 0.25
    },
    {
      "date": "2022-02-08",
      "open": 29.95,
      "high": 30.3,
      "low": 29.8,
      "close": 30.1,
      "volume": 31791868,
      "turnover": 955899049,
      "change": 0.15
    },
    {
      "date": "2022-02-07",
      "open": 29.3,
      "high": 29.95,
      "low": 29.25,
      "close": 29.95,
      "volume": 39525433,
      "turnover": 1172930799,
      "change": 0.95
    }
  ]
}

Schema

Name	Type	Description
date	string	本筆資料所屬日期
type	string	ticker 類別
exchange	string	交易所
market	string	市場別
symbolId	string	股票代號
data	data object	-

data object

Name	Type	Description
date	string	日期
open	number	開盤價
high	number	最高價
low	number	最低價
close	number	收盤價
volume	number	成交量（股）
turnover	number	成交金額（元）
change	number	漲跌